WhatsAppApi
Dodaj wiadomości WhatsApp do swojej aplikacji.
Wysyłaj przydatne aktualizacje, odbieraj odpowiedzi klientów i śledź każdą wiadomość przez cały jej cykl życia. Użyj opublikowanych API i SDK Bird, aby połączyć WhatsApp z aplikacjami i przepływami, na których polegają Twoi klienci.
const msg = await bird.whatsapp.send({
to: "+15551234567",
template: {
slug: "bird_otp",
components: [{ type: "body", parameters: [{ type: "text", text: "123456" }] }],
},
});
console.log(msg.id, msg.status);Wybierz swój SDK lub użyj HTTP bezpośrednio. Te przykłady są wygenerowane z opublikowanej operacji Bird.
Jedno jasne żądanie
Wybierz wiadomość odpowiednią do sytuacji.
Użyj zatwierdzonego szablonu dla kwalifikującej się wiadomości inicjowanej przez firmę lub obsługiwanej odpowiedzi w dowolnej formie w oknie obsługi klienta. Określ nadawcę, odbiorcę, język i treść jawnie.
Korzystaj z opublikowanych przykładów
Zacznij od wygenerowanego przykładu SDK lub HTTP powyżej. Postępuj zgodnie z rzeczywistą strukturą treści i walidacją operacji, zamiast zgadywać metodę na podstawie ilustracji marketingowej.
Kontroluj obciążenie
Korzystaj z odpowiedzi o ograniczeniu liczby żądań i ograniczonej kolejki. Gdy aplikacja rozsyła wiadomości, zachowuj trwały rekord każdego zamierzonego odbiorcy i żądania.
Cykl życia, który możesz prześledzić
Śledź od przyjęcia aż do odpowiedzi klienta.
Przyjęte żądanie API rozpoczyna przetwarzanie. Akceptacja Meta, informacje o dostarczeniu i odczytaniu opisują kolejne etapy; nie gwarantują, że klient wykonał zamierzone działanie biznesowe.
Uzgadniaj na podstawie odczytów wiadomości
Konsumuj odpowiednie webhooki i pobieraj rekordy wiadomości podczas badania luk. Oddzielaj niepewne próby od potwierdzonych niepowodzeń.
Podejmuj precyzyjne decyzje o ponowieniu żądań
Korzystaj z udokumentowanych mechanizmów ochrony żądań i klasyfikacji błędów. Nie zakładaj, że niepewną próbę wysyłki przez dostawcę można bezpiecznie ponawiać w nieskończoność.
Bird przyjmuje żądanie i zwraca identyfikator wiadomości.
Wiadomość przechodzi przez przepływ wysyłki.
Obserwacje dostawcy aktualizują rekord wiadomości, gdy są dostępne.
Obsługuj odrzucenie, niepowodzenie i brak obserwacji w ramach tej samej integracji.
Rozmowa, nie tylko endpoint
Przekaż przydatny kontekst do odpowiedzi.
Używaj jawnych identyfikatorów odpowiedzi przycisków lub list oraz stanu konwersacji w aplikacji. Odpowiedź może cytować wcześniejszą wiadomość, ale to odwołanie jest opcjonalne i może być niedostępne.
Trzymaj metadane na swoim miejscu
Metadane wychodzące należą do rekordu wychodzącego. Nie zakładaj, że są kopiowane do wiadomości przychodzącej od klienta.
Łącz narzędzia z tymi samymi uprawnieniami
CLI i MCP mogą pomóc deweloperom obsługiwać kanał. Podlegają tym samym regułom dostępu do obszaru roboczego, własności nadawcy i zasadom wysyłki.
Pytania o WhatsApp API
Czy przyjęte żądanie oznacza, że wiadomość została doręczona?
Czy mogę wysyłać wiadomości dowolnej treści w dowolnym momencie?
Czy istnieje zbiorczy endpoint WhatsApp?
Jak dopasować interaktywną odpowiedź do mojej aplikacji?
Połącz całą ścieżkę
Powiązane zasoby
Kontynuuj z dokumentacją, przewodnikami i przykładami dotyczącymi tego tematu. Zasoby są w języku angielskim.
Niech pierwsze żądanie będzie częścią działającej integracji.
Skonfiguruj obszar roboczy, użyj opublikowanego przykładu i sprawdź odpowiedź. Podłącz odpowiedzi zwrotne i zdarzenia dostarczenia, zanim zwiększysz ruch.