Réactions aux messages : envoyer et recevoir des emoji
Une réaction associe un seul emoji à un message existant. Pour l’envoyer, référencez l’id du message et l’emoji. Pour la supprimer, envoyez la même réaction avec une chaîne emoji vide au lieu d’appeler une suppression.
Nombre de réactions qu’un expéditeur peut avoir simultanément sur un message.
Coût d’une réaction. Elle n’ouvre pas de conversation facturable.
Erreur renvoyée si vous réagissez en dehors de la fenêtre de service.
Envoyer une réaction
Un message de type reaction, contenant l’id du message auquel vous réagissez et un seul emoji. L’envoi d’une seconde réaction sur le même message remplace la première au lieu de s’y ajouter, car un expéditeur ne peut avoir qu’une réaction par message.
L’id du message doit être visible par votre numéro : un message entrant de ce client ou un message que vous lui avez envoyé.
Supprimer une réaction
C’est la partie qui surprend. Il n’existe pas d’appel de suppression. Envoyez la même réaction avec le champ emoji défini comme une chaîne vide pour la supprimer.
Un gestionnaire qui attend un événement de suppression attendra indéfiniment. Ce qui arrive est une réaction avec un emoji vide, de même structure qu’une nouvelle réaction. Il faut l’interpréter comme une suppression en vérifiant le champ.
Recevoir des réactions
Les réactions entrantes arrivent sur le webhook messages sous forme de message de type reaction, avec l’id du message auquel elles se rattachent et l’emoji.
- Abonnez-vous au champ messages ; il n’existe pas de champ reactions distinct.
- Un emoji vide signifie que le client a supprimé sa réaction.
- L’id du message référencé est celui d’un message que vous avez envoyé ou reçu auparavant.
- Les réactions ne rouvrent pas la fenêtre de service de 24 heures.
La fenêtre s’applique toujours
Une réaction est un message : son envoi nécessite donc que la fenêtre de service client de 24 heures soit ouverte. Réagir au message d’un client reçu il y a trois jours renvoie exactement l’erreur 131047, comme le ferait un message texte.
Recevoir une réaction d’un client rouvre la fenêtre, car tout message entrant la rouvre. C’est utile pour les automatisations : un pouce levé sur votre dernier message indique que vous pouvez maintenant répondre librement.
Erreurs courantes
- Chercher un endpoint de suppression. La suppression utilise le même appel avec un emoji vide.
- Considérer un emoji vide comme malformé. C’est ainsi qu’une suppression est exprimée.
- Envoyer une réaction en dehors de la fenêtre de service. Elle échoue comme tout autre message.
EasyCoexistence transmet les événements de réaction à votre endpoint sur le même webhook que tous les autres messages. Une réaction supprimée arrive donc avec son emoji vide intact.
Questions fréquemment posées
Comment supprimer une réaction ?
Envoyez la même réaction avec une chaîne emoji vide. Il n’existe pas d’appel de suppression.
Les réactions coûtent-elles quelque chose ?
Non. Elles n’ouvrent pas de conversation facturable.
Puis-je réagir à n’importe quel message ?
Uniquement aux messages envoyés ou reçus par votre numéro, et seulement pendant la fenêtre de service de 24 heures.
La réaction d’un client rouvre-t-elle la fenêtre ?
Oui. Tout message entrant de sa part la rouvre, y compris une réaction.
Poursuivre la lecture
Prêt à commencer ?
Configurez WhatsApp Coexistence en quelques minutes, pas en quelques mois. L’application continue de fonctionner sur le téléphone.
Commencer l'essai gratuitVérifié le