WhatsApp-reacties versturen

Reageer op het bericht van een contact met een emoji, bijvoorbeeld een duim omhoog om hun antwoord te bevestigen. Je kunt je reactie later vervangen of verwijderen.

Vereisten

Je hebt een API-sleutel nodig met WhatsApp-schrijfrechten en het Bird-bericht-ID (wam_…) van een bericht dat je werkruimte heeft ontvangen. Gebruik data.whatsapp_id uit whatsapp.received, of de id van het bericht uit het WhatsApp-logboek.

Vervang het voorbeeld-bericht-ID door het ID van een bericht dat je werkruimte heeft ontvangen. Initialiseer de client voor je taal met de TypeScript-, Python-, Go- of PHP-SDK-handleiding. Gebruik voor CLI-voorbeelden installeer en authenticeer de CLI met WhatsApp-schrijftoegang. Gebruik de API-host voor je werkruimteregio in cURL-verzoeken.

1. Een reactie toevoegen

Roep Reageer op een WhatsApp-bericht aan met één 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": "👍"}'

Het API retourneert 202 met het id (war_…) en emoji van de geaccepteerde reactie. Sla het reactie-ID op om het resultaat terug te vinden in het reactielogboek. Acceptatie bevestigt niet dat WhatsApp de reactie heeft toegepast.

Je hebt één reactie per bericht. Om deze te vervangen, herhaal je het PUT-verzoek met een andere emoji. Reacties worden niet in rekening gebracht.

2. Het reactieresultaat controleren

Haal het bericht op om de huidige reactions te zien, met één vermelding per afzender. Gebruik voor het resultaat van een specifieke wijziging de reactiegebeurtenissen van het bericht en zoek het opgeslagen reactie-ID.

Het reactielogboek registreert eindstatussen: sent betekent dat WhatsApp je wijziging heeft geaccepteerd, failed betekent dat WhatsApp deze heeft geweigerd, en rejected betekent dat Bird deze vóór verzending heeft geweigerd. Controleer de error van de gebeurtenis bij een mislukte of geweigerde wijziging. Een reactie in behandeling heeft nog geen logboekvermelding. Reacties hebben geen bezorg- of leesbevestigingen en geen uitgaande reactie-webhook.

3. Je reactie verwijderen

Roep Verwijder een WhatsApp-reactie aan met hetzelfde bericht-ID:

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"

Het API retourneert 202 zonder antwoordinhoud. Verwijdering wordt asynchroon verwerkt; controleer de huidige reactions van het bericht of het reactielogboek om het resultaat te bevestigen. Een verwijderingsvermelding in het logboek heeft emoji: null. Het verwijderen van een afwezige reactie is veilig, en deze bewerking verwijdert de reactie van je werkruimte, niet die van het contact.

Probleemoplossing

404 (E15071): Controleer het doelbericht-ID en de werkruimte. Bird bewaart de berichtreferentie die nodig is om een reactie toe te voegen of te verwijderen gedurende 15 dagen.
422 (E01001): Gebruik een ontvangen bericht en één enkele emoji. Je kunt niet reageren op een bericht dat je werkruimte heeft verstuurd. Een samengevoegde emoji telt als één emoji; twee losse emoji niet.
Reactie ongewijzigd na 202: Controleer het reactielogboek op een mislukte of geweigerde wijziging. Een geslaagd HTTP-antwoord bevestigt acceptatie voor verwerking.

Vervolgstappen

Gerelateerde bronnen

Ga verder met de documentatie, gidsen en voorbeelden voor dit onderwerp. De bronnen zijn in het Engels.

Bekijk de gidsConnecting WhatsApp to Bird: from buying a number to a live channel Begrijp het conceptWhat is the 24-hour customer service window on WhatsApp?Gebruik de toolWhatsApp message builder Ontdek de mogelijkheidWhatsApp

Probeer de oefening en ontvang een implementatieoverzicht