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.

1
2
3
4
5
6
7
8
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ść.

Jedna wiadomość, od żądania do odpowiedziPrzykładowa ścieżka
01
Przyjęte

Bird przyjmuje żądanie i zwraca identyfikator wiadomości.

02
Przetwarzane

Wiadomość przechodzi przez przepływ wysyłki.

03
Doręczone lub odczytane

Obserwacje dostawcy aktualizują rekord wiadomości, gdy są dostępne.

Dzięki! Odbiorę to jutro.

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?
Nie. Przyjęcie przez API, akceptacja Meta, dostarczenie i odczytanie to odrębne zdarzenia. Potwierdzaj stan wiadomości i wynik biznesowy osobno.
Czy mogę wysyłać wiadomości dowolnej treści w dowolnym momencie?
Odpowiedzi w dowolnej formie zależą od okna obsługi klienta i obsługiwanego typu treści. Poza tym oknem użyj kwalifikującego się zatwierdzonego szablonu.
Czy istnieje zbiorczy endpoint WhatsApp?
Opublikowane API wiadomości wysyła pojedyncze wiadomości. Kontroluj rozsyłanie w aplikacji, korzystając z udokumentowanych limitów; nie zakładaj, że endpoint do masowej wysyłki e-maili obsługuje też WhatsApp.
Jak dopasować interaktywną odpowiedź do mojej aplikacji?
Używaj jawnych identyfikatorów odpowiedzi powiązanych ze stanem konwersacji lub zadania. Odwołanie do cytowanej wiadomości może pomóc, gdy jest dostępne, ale metadane wiadomości wychodzącej nie są automatycznie dziedziczone przez odpowiedź.

Skaluj bez
utraty kontroli.

Organizuj zespoły w obszarach roboczych, kontroluj dostęp do API i śledź zmiany w logach audytu.

BirdHarborOrganization
WorkspacesProductionSandbox

Delivery agent

API key · Customer operations team
Active
PermissionsAccess
EmailRead & write
SMSRead & write
ALAlex Lee AdminPermissions updated

Audit log

Production
Workspace
Production
Resource
Delivery agent
WhatsApp
ReadRead & write
Succeeded

Zacznij z WhatsApp.
Twórz na wielu kanałach z Bird.

Twój kolejny pomysł.
Gotowy do połączenia.