Messages de réponse sortants de WhatsApp

Les réponses sortantes de WhatsApp permettent aux entreprises de citer un message existant dans une conversation ou d'y répondre. Il peut s'agir du message d'un utilisateur final ou de son propre message. Cela permet à l'entreprise de fournir un contexte supplémentaire lors de l'envoi d'un message, afin d'apporter une clarté que le contenu du message seul n'est peut-être pas en mesure d'apporter.

Les entreprises peuvent citer/répondre à :

• Le message d'un utilisateur final. Il pourrait être utilisé pour indiquer clairement que le dernier message envoyé par l'entreprise concerne une spécifique message de l'utilisateur plus tôt dans la conversation, par exemple "En référence à ce que vous avez demandé ici, la réponse est..."
• Message envoyé par l'entreprise. Il peut être utilisé pour se référer à quelque chose que l'entreprise elle-même a dit plus tôt dans la conversation, par exemple : "Voici l'option à laquelle je faisais référence".

Dans l'interface utilisateur de WhatsApp, le destinataire reçoit le nouveau message accompagné d'une bulle contextuelle qui affiche le contenu du message précédent.

Charge utile de la demande d'API

Pour envoyer un message de réponse sortante, ainsi que les champs standard pour le type de message WhatsApp envoyé, la charge utile JSON de la demande API doit inclure un champ de niveau supérieur context propriété. La valeur de cette propriété est un objet avec une propriété message_uuiddont la valeur est l'UUID du message cité/répondu.

Un exemple de charge utile JSON pourrait ressembler à ceci :

{
	"to": "447700900000",
	"from": "447700900001",
	"channel": "whatsapp",
	"message_type": "text",
	"text": "This looks like your order number. Can you confirm?",
	"context": {
		"message_uuid": "a1b2c3d4a1b2c3d4"
	}
}

Limites

• Cette fonction est disponible sur API dans le nuage hébergés uniquement dans des WABA (voir Hébergement de numéros WhatsApp)
• Les réponses doivent être faites dans les 30 jours suivant la réception/l'envoi du message original cité/répondu.

Erreurs potentielles

Les tentatives de réponse à un message qui n'est pas stocké, soit parce qu'il n'existe pas, soit parce que le délai de 30 jours est dépassé, entraîneront le rejet du message avec le code d'erreur suivant :

1451 - Invalid context - the reference to the original message could not be found because it is invalid or no longer available