Envoyer des réactions WhatsApp

Réagissez au message d'un contact avec un emoji, par exemple un pouce levé pour accuser réception de sa réponse. Vous pouvez remplacer votre réaction ou la supprimer par la suite.

Prérequis

Vous avez besoin d'une clé API avec la permission d'écriture WhatsApp et de l'identifiant de message Bird (wam_…) d'un message reçu par votre espace de travail. Utilisez data.whatsapp_id depuis whatsapp.received, ou le id du message depuis le journal WhatsApp.

Remplacez l'identifiant de message d'exemple par l'identifiant d'un message reçu par votre espace de travail. Initialisez le client pour votre langage en suivant le guide SDK TypeScript, Python, Go ou PHP. Pour les exemples CLI, installez et authentifiez le CLI avec un accès en écriture WhatsApp. Utilisez l'hôte API correspondant à la région de votre espace de travail dans les requêtes cURL.

1. Ajouter une réaction

Appelez Réagir à un message WhatsApp avec un seul emoji :

const reaction = await bird.whatsapp.reaction.set("wam_01krdgeqcxet5s7t44vh8rt9mg", {
  emoji: "👍",
});
console.log(reaction.id, reaction.emoji);

reaction = client.whatsapp.reaction.set("wam_01krdgeqcxet5s7t44vh8rt9mg", emoji="\U0001f44d")
print(reaction.id, reaction.emoji)

reaction, err := client.Whatsapp.Reaction.Set(context.Background(), "wam_01krdgeqcxet5s7t44vh8rt9mg", bird.WhatsappReactionSetParams{
	Emoji: "\U0001F44D",
})
if err != nil {
	log.Fatal(err)
}
fmt.Println(reaction.Id, reaction.Emoji)

use MessageBird\Wire\Model\WhatsAppReactionUpsert;

$reaction = $bird->whatsapp->reaction->set(
    'wam_01krdgeqcxet5s7t44vh8rt9mg',
    (new WhatsAppReactionUpsert())->setEmoji("\u{1F44D}"),
);
echo $reaction->getId(), ' ', $reaction->getEmoji();

bird whatsapp reaction set wam_01krdgeqcxet5s7t44vh8rt9mg --emoji '👍'

curl -X PUT "https://us1.platform.bird.com/v1/whatsapp/messages/wam_01krdgeqcxet5s7t44vh8rt9mg/reaction" \
  -H "Authorization: Bearer $BIRD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"emoji": "👍"}'

Le API renvoie 202 avec l'identifiant id (war_…) et le emoji de la réaction acceptée. Enregistrez l'identifiant de réaction pour retrouver son résultat dans le journal des réactions. L'acceptation ne confirme pas que WhatsApp a appliqué la réaction.

Vous ne disposez que d'une réaction par message. Pour la remplacer, répétez la requête PUT avec un emoji différent. Les réactions ne sont pas facturées.

2. Vérifier le résultat de la réaction

Récupérez le message pour voir ses reactions actuelles, avec une entrée par expéditeur. Pour le résultat d'une modification particulière, listez les événements de réaction du message et recherchez l'identifiant de réaction enregistré.

Le journal des réactions enregistre les résultats terminaux : sent signifie que WhatsApp a accepté votre modification, failed signifie que WhatsApp l'a refusée, et rejected signifie que Bird l'a refusée avant la transmission. Inspectez le error de l'événement pour une modification échouée ou rejetée. Une réaction en attente n'a pas encore d'entrée dans le journal. Les réactions n'ont ni accusé de réception, ni confirmation de lecture, ni webhook de réaction sortant.

3. Supprimer votre réaction

Appelez Supprimer une réaction WhatsApp avec le même identifiant de message :

await bird.whatsapp.reaction.remove("wam_01krdgeqcxet5s7t44vh8rt9mg");

client.whatsapp.reaction.remove("wam_01krdgeqcxet5s7t44vh8rt9mg")

if err := client.Whatsapp.Reaction.Remove(context.Background(), "wam_01krdgeqcxet5s7t44vh8rt9mg"); err != nil {
	log.Fatal(err)
}

$bird->whatsapp->reaction->remove('wam_01krdgeqcxet5s7t44vh8rt9mg');

bird whatsapp reaction remove wam_01krdgeqcxet5s7t44vh8rt9mg --yes

curl -X DELETE "https://us1.platform.bird.com/v1/whatsapp/messages/wam_01krdgeqcxet5s7t44vh8rt9mg/reaction" \
  -H "Authorization: Bearer $BIRD_API_KEY"

Le API renvoie 202 sans corps de réponse. La suppression est traitée de manière asynchrone ; vérifiez les reactions actuelles du message ou son journal des réactions pour confirmer le résultat. Une entrée de suppression dans le journal a emoji: null. Supprimer une réaction absente est sans effet, et cette opération supprime la réaction de votre espace de travail, pas celle du contact.

Dépannage

404 (E15071) : Vérifiez l'identifiant du message cible et l'espace de travail. Bird conserve la référence de message nécessaire pour ajouter ou supprimer une réaction pendant 15 jours.
422 (E01001) : Utilisez un message reçu et un seul emoji. Vous ne pouvez pas réagir à un message envoyé par votre espace de travail. Un emoji combiné compte comme un seul emoji ; deux emoji séparés ne comptent pas comme un seul.
Réaction inchangée après 202 : Inspectez le journal des réactions pour une modification échouée ou rejetée. Une réponse HTTP réussie confirme l'acceptation pour traitement.

Étapes suivantes

Ressources associées

Poursuivez avec la documentation, les guides et les exemples sur ce sujet. Les ressources sont en anglais.

Regarder le guideConnecting WhatsApp to Bird: from buying a number to a live channel Comprendre le conceptWhat is the 24-hour customer service window on WhatsApp?Utiliser l'outilWhatsApp message builder Explorer la fonctionnalitéWhatsApp

Essayez la pratique et obtenez un guide d'implémentation