Erste Schritte
Dieser Leitfaden hilft dir, deine erste Nachricht mithilfe der Cloud API zu senden und zu empfangen. Außerdem erfährst du, wie du Webhooks konfigurieren kannst, um sie mit einer Beispiel-App zu verwenden.
Dieser Leitfaden ist für Personen gedacht, die Anwendungen für den Eigengebrauch oder ihre Organisation entwickeln. Wenn du eine Anwendung entwickelst, die von anderen Unternehmen verwendet wird, siehe Anbieter von Unternehmenslösungen.
Bevor du beginnst
Voraussetzungen:
- Ein Meta-Entwicklungskonto – weitere Informationen über die Registrierung als Meta-Entwickler*in.
- Eine Business-App – weitere Informationen über die Erstellung von Apps. Wenn du keine Option zum Erstellen einer Business-App siehst, wähle während der App-Erstellung Sonstige > Weiter > Business aus).
Schritt 1: Das WhatsApp-Produkt zu deiner App hinzufügen
Wenn du eine neue App erstellt hast, wirst du an dieser Stelle aufgefordert, Produkte zu deiner App hinzuzufügen. Scrolle nach unten und wähle unter WhatsApp die Option Einrichten aus. Wähle ansonsten auf dem Bildschirm Meine Apps deine App aus. Du kannst noch einmal die gleichen Anweisungen befolgen, um das WhatsApp-Produkt zu deiner App hinzuzufügen.
Wenn du ein Meta-Business-Konto (MBA) hast, wirst du aufgefordert, es zu verbinden, wenn du das WhatsApp-Produkt zu deiner App hinzufügst. Wenn du keinen MBA hast, werden dir nacheinander einige Aufforderungen angezeigt, die dir helfen, einen MBA zu erstellen. Sobald dein MBA mit deiner Anwendung verbunden ist, kannst du mit dem Testen beginnen.
Wenn du das WhatsApp-Produkt zu deiner App hinzufügst, passiert Folgendes:
- Du wirst aufgefordert, ein Meta-Business-Konto zu erstellen, wenn du keines hast.
- Für dich wird automatisch ein WhatsApp-Business-Testkonto erstellt. Dieses Konto weist Einschränkungen auf und dient nur zu Test- und Entwicklungszwecken, da du für Nachrichten nichts bezahlst.
- Es wird eine geschäftliche Telefonnummer zu Testzwecken erstellt, die mit deinem WhatsApp-Unternehmenskonto verknüpft wird. Mit dieser Nummer kannst du kostenlose Nachrichten an bis zu fünf Empfänger*innen-Telefonnummern senden.
- Es wird ein Satz vorab genehmigter Nachrichtenvorlagen erstellt.
Schritt 2: Eine Empfänger*innen-Nummer hinzufügen
Füge eine gültige WhatsApp-Nummer hinzu, an die du Testnachrichten senden kannst.
Navigiere im App-Dashboard im Menü auf der linken Seite zu WhatsApp > API-Setup. Wähle unter Send and receive messages (Nachrichten senden und empfangen) das Feld To (An) und anschließend Manage phone number list (Telefonnummernliste verwalten) aus.
Du kannst jede beliebige gültige WhatsApp-Nummer als Empfänger*in hinzufügen. Die Empfänger*innen-Nummer erhält einen Bestätigungscode in WhatsApp, der zur Verifizierung der Nummer verwendet werden kann.
Sobald du die Empfänger*innen-Nummer verifiziert hast, sollte sie nun im Feld To (An) ausgewählt sein. Wiederhole diesen Vorgang, wenn du eine*n weitere*n Empfänger*in hinzufügen möchtest (maximal fünf).
Schritt 3: Testnachricht senden
Sende an deine ausgewählte Empfänger*innen-Nummer eine vorab genehmigte hello_world-Vorlagennachricht.
In der Ansicht WhatsApp > API-Setup:
- Stelle sicher, dass im Feld From (Von) deine Test-Business-Telefonnummer ausgewählt ist.
- Stelle sicher, dass die Empfänger*innen-Telefonnummer, an die du eine Nachricht senden möchtest, im Feld To (An) ausgewählt ist. Wenn du mehrere Nummern hinzugefügt hast, kannst du mehrere Nachrichten gleichzeitig senden.
- Klicke in der Ansicht Send messages with the API (Nachrichten mit der API senden) auf den Button Send message (Nachricht senden).
Alternativ kannst du den cURL-Befehl kopieren, dann in ein neues Terminal-Fenster einfügen und anschließend ausführen.
Beachte, dass der Code angibt, dass du eine Vorlagennachricht sendest (”type”:”template”) und eine bestimmte Vorlage angibst, die verwendet werden soll (”name”:”hello_world”).
Schritt 4: Unsere Beispiel-App klonen und Webhooks konfigurieren
Mit Webhooks kannst du HTTP-Benachrichtigungen in Echtzeit erhalten, die dich über Änderungen an bestimmten Objekten informieren. In WhatsApp können dich Webhooks über viele Ereignisse in deiner App benachrichtigen, z. B. über die Zustellung und das Lesen von Nachrichten und sogar über Kontoänderungen.
Füge eine Rückruf-URL hinzu, um den Inhalt der Webhooks zu sehen. Befolge unseren Leitfaden zur Beispiel-Rückruf-URL für das Testen von Webhooks, um unsere Beispiel-App zu klonen, die Webhook-Benachrichtigungen akzeptiert und die entsprechenden JSON-Payloads auf dem Bildschirm anzeigt.
Sobald dein Webhook eingerichtet ist, sende die Vorlagennachricht erneut und antworte dann auf sie. Du solltest vier separate Webhook-Benachrichtigungen sehen: Die Sende-, Zustellungs- und Gelesen-Benachrichtigen und den Inhalt eingehender Nachrichten.
Schritt 5 (Optional): Eine echte geschäftliche Telefonnummer hinzufügen
Mit deiner Testgeschäftsnummer und deinem WhatsApp-Test-Unternehmenskonto kannst du mit der Entwicklung deiner Anwendung beginnen. Wenn du diese Testinhalte verwendest, musst du für das Senden von Nachrichten nichts bezahlen, da du an der Entwicklung deiner App arbeitest.
Sobald du bereit bist, Nachrichten an deine Kund*innen zu senden, kannst du in der Ansicht API-Setup echte geschäftliche Telefonnummer hinzufügen und ein echtes WhatsApp-Unternehmenskonto erstellen.