Wysyłanie reakcji WhatsApp

Zareaguj na wiadomość kontaktu za pomocą emoji, na przykład kciuka w górę, aby potwierdzić odbiór odpowiedzi. Możesz później zmienić swoją reakcję lub ją usunąć.

Wymagania wstępne

Potrzebujesz klucza API z uprawnieniem do zapisu WhatsApp oraz identyfikatora wiadomości Bird (wam_…) wiadomości otrzymanej przez Twój obszar roboczy. Użyj data.whatsapp_id z whatsapp.received lub id wiadomości z logu WhatsApp.

Zastąp przykładowy identyfikator wiadomości identyfikatorem wiadomości otrzymanej przez Twój obszar roboczy. Zainicjalizuj klienta dla swojego języka, korzystając z przewodnika SDK dla TypeScript, Python, Go lub PHP. W przypadku przykładów CLI zainstaluj i uwierzytelnij CLI z dostępem do zapisu WhatsApp. W żądaniach cURL używaj hosta API odpowiedniego dla regionu obszaru roboczego.

1. Dodaj reakcję

Wywołaj Zareaguj na wiadomość WhatsApp z jednym 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": "👍"}'

API zwraca 202 z id (war_…) i emoji zaakceptowanej reakcji. Zapisz identyfikator reakcji, aby znaleźć jej wynik w logu reakcji. Akceptacja nie potwierdza, że WhatsApp zastosował reakcję.

Możesz mieć tylko jedną reakcję na wiadomość. Aby ją zmienić, powtórz żądanie PUT z innym emoji. Reakcje nie są naliczane.

2. Sprawdź wynik reakcji

Pobierz wiadomość, aby zobaczyć jej bieżące reactions z jednym wpisem na nadawcę. Aby sprawdzić wynik konkretnej zmiany, wyświetl listę zdarzeń reakcji wiadomości i znajdź zapisany identyfikator reakcji.

Log reakcji rejestruje wyniki końcowe: sent oznacza, że WhatsApp zaakceptował zmianę, failed oznacza, że WhatsApp ją odrzucił, a rejected oznacza, że Bird odrzucił ją przed transmisją. Sprawdź error zdarzenia w przypadku nieudanej lub odrzuconej zmiany. Oczekująca reakcja nie ma jeszcze wpisu w logu. Reakcje nie mają potwierdzeń dostarczenia ani odczytu i nie generują wychodzącego webhooka reakcji.

3. Usuń swoją reakcję

Wywołaj Usuń reakcję WhatsApp z tym samym identyfikatorem wiadomości:

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"

API zwraca 202 bez treści odpowiedzi. Usunięcie jest przetwarzane asynchronicznie; sprawdź bieżące reactions wiadomości lub jej log reakcji, aby potwierdzić wynik. Wpis logu usunięcia ma emoji: null. Usunięcie nieistniejącej reakcji jest bezpieczne, a ta operacja usuwa reakcję Twojego obszaru roboczego, nie kontaktu.

Rozwiązywanie problemów

404 (E15071): Sprawdź identyfikator wiadomości docelowej i obszar roboczy. Bird przechowuje referencję wiadomości potrzebną do dodania lub usunięcia reakcji przez 15 dni.
422 (E01001): Użyj otrzymanej wiadomości i pojedynczego emoji. Nie możesz reagować na wiadomość wysłaną przez Twój obszar roboczy. Złożone emoji liczy się jako jedno emoji; dwa oddzielne emoji już nie.
Reakcja niezmieniona po 202: Sprawdź log reakcji w poszukiwaniu nieudanej lub odrzuconej zmiany. Pomyślna odpowiedź HTTP potwierdza przyjęcie do przetwarzania.

Następne kroki

Powiązane zasoby

Kontynuuj z dokumentacją, przewodnikami i przykładami dotyczącymi tego tematu. Zasoby są w języku angielskim.

Obejrzyj przewodnikConnecting WhatsApp to Bird: from buying a number to a live channel Zrozum koncepcjęWhat is the 24-hour customer service window on WhatsApp?Użyj narzędziaWhatsApp message builder Poznaj możliwościWhatsApp

Wypróbuj ćwiczenie i uzyskaj brief wdrożeniowy