WhatsApp-Übersicht

Bird WhatsApp nutzt dieselbe Plattform und dieselben API-Schlüssel wie Bird Email und Bird SMS. Rufen Sie den regionalen Host für den API-Schlüssel auf (https://us1.platform.bird.com oder https://eu1.platform.bird.com). WhatsApp-Endpunkte befinden sich unter /v1/whatsapp/….

Geschäftsinitiierte Sendungen verwenden eine vorab genehmigte Nachrichtenvorlage. Senden Sie eine aus dem verwalteten Katalog von Bird, wofür Sie keine eigene Nummer benötigen – der Versand erfolgt über einen von Bird verwalteten Absender – oder verbinden Sie eine eigene Nummer und senden Sie Ihre eigenen Vorlagen darüber. Kontakte können an eine eigene Nummer schreiben, und Bird speichert diese eingehenden Nachrichten zusammen mit den ausgehenden.

So funktioniert der Versand

Senden Sie eine WhatsApp-Nachricht mit POST /v1/whatsapp/messages: ein Empfänger, ein Template sowie optionale Tags und Metadaten. Wir validieren die Anfrage und geben 202 Accepted mit einer Nachrichten-ID zurück. Abrechnung und Zustellung erfolgen asynchron. Die API hat keinen Batch-Endpunkt, senden Sie also eine Anfrage pro Nachricht.

Drei Konzepte bestimmen die gesamte API:

Versand und Zustellung sind getrennte Phasen. Ein 202 bedeutet, dass Bird die Nachricht angenommen hat. Das Gerät des Empfängers erhält sie erst, nachdem die Nachricht über WhatsApp ein endgültiges Zustellergebnis erreicht hat. Eine Lesebestätigung erscheint als read_at-Zeitstempel und whatsapp.read-Event; sie ändert den Nachrichtenstatus nicht.
Jeder vom Unternehmen initiierte Versand verwendet ein Template. Geben Sie den Template-slug, eine optionale language und Werte für die Variablen an. Eine Servicenachricht, also Freitext oder Medien, erreicht einen Kontakt nur innerhalb des 24-Stunden-Fensters, das dessen eigene Nachricht öffnet, und nur von einer Nummer, die Ihrem Workspace gehört. Siehe WhatsApp-Nachrichten senden.
Kategorie und Ziel bestimmen Absender und Preis. Jedes Template hat eine authentication-, utility- oder marketing-Kategorie. Ein verwaltetes Template wird von der Bird-Nummer seiner Kategorie gesendet und hat daher kein from-Feld; jeder andere Versand benennt seinen eigenen Absender. Der Preis hängt auch vom Land des Empfängers ab, und die Nachricht wird in zwei Schritten abgerechnet: die Gebühr von Bird, während Bird den Versand verarbeitet, und Metas Anteil bei Zustellung der Nachricht. Siehe Kosten und Abrechnung.

Die WhatsApp-App im Dashboard

Im Dashboard ist WhatsApp eine der Kanal-Apps des Workspace. Ihre Seiten:

Seite	Zweck
Messages	Ein- und ausgehende Nachrichten mit Inhalt, Events und Zustelldetails pro Nachricht
Metrics	Zustellmetriken für ausgehende Nachrichten und Volumen eingehender Nachrichten
Templates	Die Templates, die Sie senden können, verwaltete und eigene: Name, Sprache, Kategorie und eine gerenderte Vorschau
Numbers	Von Bird verwaltete Absendernummern und eigene verbundene Nummern
Groups	WhatsApp-Gruppen, die Ihre Geschäftsnummern verwalten, mit Teilnehmern und Einladungslinks

Sichtbarkeit

Bird zeichnet eine Timeline für jede Nachricht auf. Ausgehende Timelines umfassen Accepted-, Sent-, Delivered-, Read- und Failure-Events. Eine eingehende Timeline zeichnet auf, wann Bird die Nachricht empfangen hat.

Zeitachse lesen: GET /v1/whatsapp/messages/{message_id}/events gibt die Ereignisse der Nachricht zurück. Die Seite Messages zeigt dieselbe Zeitachse. Siehe WhatsApp-Ereignisse.
Ausgehende Zustellevents abonnieren: Senden Sie öffentliche whatsapp.accepted-, whatsapp.sent-, whatsapp.delivered-, whatsapp.read-, whatsapp.failed- und whatsapp.rejected-Events an einen Webhook-Endpunkt.
Aggregierte Metriken ansehen: Die Metrics-Seite hat separate Tabs Outbound und Inbound.

Empfang

Bird speichert eingehende Nachrichten, die an eine Nummer Ihres Workspace gesendet wurden, mit dem Status received. Von Bird verwaltete Nummern empfangen keine Nachrichten für Ihren Workspace. Nachrichten finden Sie auf der Messages-Seite oder mit GET /v1/whatsapp/messages?direction=inbound. Die Nachrichtendetails zeigen Text, unterstützte Medien, Dokumente, Standorte und Inhaltstypen, die Bird nicht darstellen kann. Empfangene Medien sind 30 Tage lang verfügbar.

Der Tab Inbound auf der Seite Metrics zeigt eine Zeitreihe Messages received und eine Aufschlüsselung By phone number. Um auf jede eingehende Nachricht bei Eintreffen zu reagieren, abonnieren Sie stattdessen das Webhook-Ereignis whatsapp.received; siehe Webhooks für eingehende Nachrichten.

Manche Empfänger bitten Sie, keine Nachrichten mehr zu senden, und eine Antwort mit STOP ist der häufigste Weg dafür: Bird liefert die Schlüsselwortliste mit, sodass das auf Ihren Nummern ohne Einrichtung funktioniert. Sie können auch eine Unterdrückung für ein einzelnes Geschäftskonto oder ein Opt-out für den gesamten Workspace erfassen. Bird blockiert in beiden Fällen spätere Sendungen an die Adresse. Siehe Opt-outs und Schlüsselwörter.

Nächste Schritte

Seite	Inhalt
WhatsApp-Nachrichten senden	Der API-Versand: Empfänger, Template, Komponenten, Tags und das asynchrone Modell
Servicenachrichten	Die neun Inhaltsarten, das Servicefenster und Medienversand per URL
Empfang	Eingehende Nachrichten, Medienabruf und der whatsapp.received-Webhook
Templates	Der Template-Katalog, Kategorien und Variablen sowie Versand per Slug
WhatsApp-Log	Ein- und ausgehende Nachrichten, Inhalt, Status und Event-Timelines
Ereignisse	Nachrichten-Timelines und Reaktionsverlauf über die API
Webhooks	Zustellungs-, Eingangs-, Reaktions-, Unterdrückungs- und Gruppen-Webhooks
Gruppen	Gemeinsame Chats mit mehreren Kunden, Einladungslinks und Gruppenlimits
An eine Gruppe senden	Adressierung einer Gruppe, Voraussetzungen und Empfangsbestätigungen pro Teilnehmer
Gruppennachrichten empfangen	Welcher Teilnehmer eine Gruppennachricht verfasst hat und wie Sie darauf antworten
Opt-outs	Keyword-Regeln, Empfängerpräferenzen und die Unterdrückungsliste
WhatsApp-Metriken	Ausgehende Zustellungsleistung und eingehendes Nachrichtenvolumen
Begrenzung der Anfragerate	Kapazität der Organisationsrichtlinie, Antwort-Header und Umgang mit 429