Actions de l’expéditeur·ice

Ce guide explique comment afficher vos actions dans une conversation pour indiquer aux destinataires que vous avez vu leur message et que vous êtes en train de le traiter.

Affichage d’une action de l’expéditeur

Pour afficher l’action effectuée par un·e expéditeur·ice dans une conversation, envoyez une requête POST au point de terminaison /PAGE-ID/messages avec le paramètre sender_action défini sur typing_on.

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"

Limitations

  • Les requêtes visant à afficher l’action de l’expéditeur·ice doivent inclure uniquement le paramètre sender_action et l’objet recipient. Toutes les autres propriétés de l’API Send, comme le texte et les modèles, doivent être envoyées dans une requête distincte.
  • Le ou la destinataire doit être connecté·e pour que les actions de l’expéditeur·ice s’affichent.
  • Les indicateurs de saisie sont désactivés automatiquement au bout de 20 secondes ou lorsque le bot envoie un message.

Consultez la référence des messages de Page pour connaître la liste complète des actions de l’expéditeur.

Recommandations

  • Envoyez un indicateur mark_seen lorsque votre bot reçoit un message afin que l'utilisateur ou l’utilisatrice ne se sente pas ignoré·e.

  • Envoyez l'indicateur typing_on lorsque votre bot reçoit un message auquel il va répondre. Cela contribue à créer une impression de conversation.

  • Envoyez les actions typing_on et typing_off dans des requêtes par lot distinctes. Les requêtes par lot sont exécutées dans l'ordre, très rapidement. De ce fait, l'indicateur typing_on peut n’apparaître qu’une fraction de seconde si les deux actions sont envoyées dans le même lot.

  • Veillez à définir un délai naturel (ni trop long ni trop court) entre l'affichage des actions de l'expéditeur typing_on et typing_off. Idéalement, l'utilisateur·ice doit avoir l'impression qu'une véritable personne a saisi le message durant le temps écoulé.

Voir aussi

Assistance pour les équipes chargées du développement