Indicateurs de réponse

Les indicateurs de réponse sont des signaux conversationnels qui permettent à une partie de savoir que l'autre partie a vu un message et a commencé à préparer une réponse. Généralement affichés sous la forme de trois points animés, les indicateurs de réponse améliorent l'expérience de la conversation en réduisant l'incertitude et en donnant l'impression que les interactions sont plus naturelles et plus réactives.

Les indicateurs de réponse ne sont actuellement disponibles que pour Whatsapp.
Les indicateurs de réponse peuvent être présentés sous différents formats, notamment sous forme de texte ou de notes vocales. Les réponses textuelles sont appelées indicateurs de frappe.

Un indicateur de réponse est automatiquement supprimé lorsqu'un message de réponse est envoyé ou au bout de 25 secondes, selon ce qui se produit en premier. Pour éviter une mauvaise expérience utilisateur, n'envoyez un indicateur de réponse que lorsque vous vous attendez à recevoir une réponse.

Après avoir reçu un webhook de message entrant, vous pouvez utiliser la fonction message_uuid à :

marquer le message comme readet
afficher un indicateur de réponse à l'autre partie

Cette approche garantit que les indicateurs de réponse sont toujours contextuels, opportuns et liés à un message spécifique de la conversation.

Pour afficher un indicateur de réponse, vous envoyez une demande PATCH à la ressource de message identifiée par message_uuid.

La demande :

met à jour le statut du message en read
comprend un replying_indicator objet qui contrôle si l'indicateur est affiché et quel type de réponse est préparé

Structure de la demande

curl -X PATCH "${GEOSPECIFIC_MESSAGES_API_URL}/${MESSAGES_MESSAGE_ID}" \
  -H "Authorization: Bearer $JWT" \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{
    "status": "read",
    "replying_indicator": {
      "show": "true",
      "type": "text"
    }
  }'

Champ d'application	Description
`status`	Met à jour l'état du message. Doit avoir la valeur "read" pour activer les indicateurs de réponse.
`replying_indicator.show`	Active ou désactive l'indicateur de réponse.
`replying_indicator.type`	Indique le type de réponse en cours de préparation (par exemple, texte).

Points finaux d'API géospécifiques

L'API Messages est disponible via des URL de base géospécifiques. Vous devez utiliser le point de terminaison qui correspond à la région où votre application est provisionnée :

Asie-Pacifique (APAC) : https://api-ap.vonage.com/v1
Europe (UE) : https://api-eu.vonage.com/v1
États-Unis (US) : https://api-us.vonage.com/v1

Dans les exemples, ${GEOSPECIFIC_MESSAGES_API_URL} représente l'une de ces URL de base. Pour afficher un indicateur de réponse, vous envoyez une demande

PATCH

à la ressource de message identifiée par l'UUID du message du client (message_uuid). Cet UUID est fourni dans la charge utile du webhook du message entrant.

Message ID Endpoint

L'UUID du message est ajouté à l'élément /messages le chemin d'accès à la ressource. Par exemple :

https://api-us.vonage.com/v1/messages/3ca4b881-3e11-46bd-b491-76740a62639a

Cet UUID identifie de manière unique le message entrant du client que vous marquez comme lu et auquel vous répondez.

Réponse

En cas de succès :

{
  "success": true
}