WhatsAppApi
Fügen Sie WhatsApp-Messaging zu Ihrer App hinzu.
Senden Sie nützliche Updates, empfangen Sie Kundenantworten und verfolgen Sie jede Nachricht über ihren Lebenszyklus. Nutzen Sie die veröffentlichten APIs und SDKs von Bird, um WhatsApp mit den Anwendungen und Workflows zu verbinden, auf die sich Ihre Kunden bereits verlassen.
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);Wählen Sie Ihr SDK oder verwenden Sie HTTP direkt. Diese Beispiele werden aus der veröffentlichten Operation von Bird generiert.
Eine klare Anfrage
Wählen Sie die passende Nachricht für den Moment.
Verwenden Sie ein genehmigtes Template für eine zulässige geschäftsinitiierte Nachricht oder eine unterstützte Freitext-Antwort innerhalb des Kundenservice-Fensters. Halten Sie Absender, Empfänger, Sprache und Inhalt explizit.
Verwenden Sie die veröffentlichten Beispiele
Starten Sie mit dem generierten SDK- oder HTTP-Beispiel oben. Folgen Sie der tatsächlichen Inhaltsstruktur und Validierung der Operation, anstatt eine Methode aus einer Marketing-Illustration abzuleiten.
Workload steuern
Nutzen Sie die Rate-Limit-Antwort und eine begrenzte Warteschlange. Wenn eine Anwendung Nachrichten per Fanout verteilt, speichern Sie einen dauerhaften Datensatz jedes vorgesehenen Empfängers und jeder Anfrage.
Ein Lebenszyklus, den Sie nachvollziehen können
Verfolgen Sie die Annahme bis zur Antwort des Kunden.
Eine akzeptierte API-Anfrage beginnt die Verarbeitung. Meta-Akzeptanz, Zustellung und Lesebestätigungen beschreiben spätere Phasen; sie garantieren nicht, dass ein Kunde Ihre geschäftliche Aufgabe abgeschlossen hat.
Mit Lesebestätigungen abgleichen
Konsumieren Sie die relevanten Webhooks und rufen Sie Nachrichtendatensätze ab, wenn Sie eine Lücke untersuchen. Halten Sie unsichere Versuche von bestätigten Fehlern getrennt.
Wiederholungsentscheidungen präzise treffen
Verwenden Sie die dokumentierten Anfrageschutzmechanismen und die Fehlerklassifikation. Gehen Sie nicht davon aus, dass ein ungewisser Zustellversuch des Anbieters beliebig oft wiederholt werden kann.
Bird nimmt die Anfrage an und gibt die Nachrichtenidentität zurück.
Die Nachricht durchläuft den Sende-Workflow.
Beobachtungen des Providers aktualisieren den Nachrichtendatensatz, sobald sie verfügbar sind.
Behandeln Sie Ablehnung, Fehler und fehlende Beobachtungen als Teil derselben Integration.
Eine Konversation, nicht nur ein Endpunkt
Übermitteln Sie den nützlichen Kontext in der Antwort.
Verwenden Sie explizite Button- oder Listenantwort-Kennungen und den Konversationsstatus Ihrer Anwendung. Eine Antwort kann eine frühere Nachricht zitieren, aber diese Referenz ist optional und möglicherweise nicht verfügbar.
Metadaten an ihrem Platz belassen
Ausgehende Metadaten gehören zum ausgehenden Datensatz. Gehen Sie nicht davon aus, dass sie auf die eingehende Nachricht des Kunden kopiert werden.
Tools mit denselben Berechtigungen verbinden
CLI und MCP können Entwicklern beim Betrieb des Kanals helfen. Sie unterliegen denselben Workspace-Zugriffsrechten, Absender-Eigentumsregeln und Versandrichtlinien.
WhatsApp-API-Fragen
Bedeutet eine angenommene Anfrage, dass die Nachricht zugestellt wurde?
Kann ich jederzeit Freitext-Nachrichten senden?
Gibt es einen WhatsApp-Batch-Endpunkt?
Wie ordne ich eine interaktive Antwort meiner Anwendung zu?
Die gesamte Journey verbinden
Verwandte Ressourcen
Weiter mit der Dokumentation, Anleitungen und Beispielen zu diesem Thema. Die Ressourcen sind auf Englisch.
Machen Sie die erste Anfrage zum Teil einer funktionierenden Integration.
Richten Sie Ihren Workspace ein, verwenden Sie ein veröffentlichtes Beispiel und prüfen Sie die Antwort. Verbinden Sie Antworten und Zustellereignisse, bevor Sie den Traffic ausweiten.