Sie können jetzt Ihr verbundenes WhatsApp 360dialog-Konto zur respond.io WhatsApp Business API migrieren, um von höherer Zuverlässigkeit, geringeren Kosten und Zugriff auf neue Funktionen zu profitieren. Erfahren Sie hier mehr über den Migrationsprozess.
Zum Verbinden mit der WhatsApp Cloud API ist eine Facebook-App mit aktiviertem WhatsApp-Produkt erforderlich. Lesen Sie diese Anleitung zum Einrichten Ihrer Facebook-App.
Facebook hat am 20. Mai die Veröffentlichung der WhatsApp Cloud API angekündigt. Sie steht Unternehmen jeder Größe zur Verfügung, um über die offizielle WhatsApp API mit Kunden zu kommunizieren.
Aufgrund der WhatsApp-Bestimmungen verfügt dieser Kanal über ein begrenztes 24-Stunden-Nachrichtenfenster. Erfahren Sie hier mehr über die Geschäftsrichtlinien von WhatsApp.' .
WhatsApp Cloud API verbinden
Um mit Ihren Kunden über die WhatsApp Cloud API zu chatten, verbinden Sie ein WhatsApp Business-Profil und ein Meta Business-Konto.
Facebook-App und Meta-Business-Konto sind erforderlich und Sie müssen der Administrator beider sein, um eine Verbindung herzustellen.
Schritt 1:Navigieren Sie zuArbeitsbereichseinstellungen> Klicken Sie aufKanal hinzufügen
Schritt 2:Suchen Sie den WhatsApp Cloud API-Kanal. > Klicken Sie aufVerbinden.
Schritt 3: Klicken Sie auf die SchaltflächeMit Facebook verbinden.
Schritt 4: Melden Sie sich mit dem Facebook-Konto mit Administratorzugriff auf die Facebook-App und das Meta-Geschäftskonto an.
Schritt 5: Wählen Sie in der Dropdown-Liste den WABA-Namen mit der WhatsApp-Nummer aus, die Sie verbinden möchten.
Schritt 6: Fügen Sie die Rückruf-URL hinzu. Gehen Sie zurück zum AbschnittWhatsAppin der Facebook Developer App. Navigieren Sie zum UnterabschnittKonfigurationund richten Sie die Rückruf-URL ein. Fügen Sie die generierte Rückruf-URL hinzu und überprüfen Sie das Token von respond.io in den entsprechenden Feldern im Webhook-Dialog.
Schritt 7: Überprüfen und speichern Sie in der Facebook-App die Änderungen an der App.
Schritt 8: Abonnieren Sie das Webhook-Ereignis. Wählen Sie in Ihrer Facebook-App die RegisterkarteWebhooksunter dem BereichProdukteund wählen SieWhatsApp Business-Kontoin der Dropdown-Liste. Klicken Sie auf das Ereignis „Nachrichten abonnieren“.
Schritt 9: Klicken Sie auf den Schalter oben auf der Seite, um den Live-Modus zu aktivieren.
Denken Sie daran, die URL Ihrer Datenschutzrichtlinie einzugeben. Wenn dieses Feld leer ist, dürfen Sie den Live-Modus nicht aktivieren.
Schritt 10: Klicken Sie auf „Änderungen speichern“, um die Einrichtung abzuschließen.
Sobald du die Einrichtung abgeschlossen hast, werden alle Nachrichten, die an deine WhatsApp-Nummer gesendet werden, jetzt in deinem Workspace empfangen.
Kanalkonfiguration
Der WhatsApp Cloud API-Kanal kann mit einem eindeutigen Kanalnamen konfiguriert werden.
Schritt 1:Navigieren Sie zuArbeitsbereichseinstellungen> Klicken Sie aufKanäle.
Schritt 2:Suchen Sie den WhatsApp Cloud API-Kanal. > Klicken Sie aufVerwalten.
Schritt 3:Konfigurieren Sie den Kanalnamen, der intern zur Identifizierung des Kontos verwendet wird.
Schritt 4:Klicken Sie aufÄnderungen speichern , um die Kanalkonfiguration zu aktualisieren.
Vom Kanal empfangene Metadaten
Verschiedene Kanäle stellen der respond.io-Plattform unterschiedliche Sätze von Kontaktmetadaten bereit. Hier ist die Liste der Kontaktdaten, die Sie über diesen Kanal erhalten können:
Telefonnummer
Telefonnummern-ID
Profilname
WhatsApp-ID
Verwalten des WhatsApp Cloud API-Profils
Wenn eine Änderung erforderlich ist oder Sie Ihr WhatsApp Cloud API-Profil überprüfen müssen, können Sie dies auf der respond.io-Plattform tun.
Schritt 1:Navigieren Sie zuArbeitsbereichseinstellungen> Klicken Sie aufKanäle.
Schritt 2:Suchen Sie den WhatsApp Cloud API-Kanal. > Klicken Sie auf„Verwalten“ > „Profil“.
Schritt 3: Klicken Sie auf „Profil synchronisieren“, um die neuesten WhatsApp Business-Profilinformationen von WhatsApp zu erhalten.
Schritt 4: Bearbeiten Sie die folgenden Informationen nach Bedarf.
Felder | Beschreibung |
|---|---|
Profilfoto | Bild, das als Profilbild des WhatsApp-Geschäftskontos angezeigt wird. Eine Bildgröße von 640 x 640 wird empfohlen. |
Um | Der Infotext des Unternehmens. Dieser Text wird im Profil des Unternehmens'unter seinem Profilbild, seiner Telefonnummer und den Kontaktschaltflächen angezeigt. |
Adresse | Adresse des Unternehmens. Maximal 256 Zeichen. |
Beschreibung | Beschreibung des Unternehmens. Maximal 512 Zeichen. |
E-Mail-Adresse (in gültigem E-Mail-Format), um das Unternehmen zu kontaktieren. Maximal 128 Zeichen. | |
Vertikal | Branche des Unternehmens. Muss einer dieser akzeptierten Werte sein: Automobil, Schönheit, Spa und Salon, Kleidung und Bekleidung, Bildung, Unterhaltung, Veranstaltungsplanung und -service, Finanzen und Bankwesen, Lebensmittel und Lebensmittelhandel, Öffentlicher Dienst, Hotel und Unterkunft, Medizin und Gesundheit, Gemeinnützig, Professionelle Dienstleistungen, Einkaufen und Einzelhandel, Reisen und Transport, Restaurant, Sonstiges. Die Geschäftssparte kann nach ihrer Erstellung nicht wieder auf einen leeren Wert zurückgesetzt werden. |
Webseite | Mit dem Unternehmen verknüpfte URLs (einschließlich http:// oder https://) (z. B. Website, Facebook-Seite, Instagram). Maximal 2 Websites mit jeweils maximal 256 Zeichen. |
Schritt 5: Überprüfen Sie die Informationen und klicken Sie auf „Änderungen speichern“.
Verwalten von WhatsApp-Nachrichtenvorlagen
Bevor Sie eine Nachrichtenvorlage an einen Kontakt auf der respond.io-Plattform senden, stellen Sie sicher, dass Sie'Folgendes getan haben:
- Die Nachrichtenvorlage zur Genehmigung eingereicht. - Die genehmigte Nachrichtenvorlage durch Synchronisieren zum Arbeitsbereich hinzugefügt.
Senden von Nachrichtenvorlagen
Schritt 1:Navigieren Sie zuArbeitsbereichseinstellungen> Klicken Sie aufKanäle.
Schritt 2:Suchen Sie den WhatsApp Cloud API-Kanal. > Klicken Sie aufVerwalten.
Schritt 3: Klicken Sie auf Vorlagen > Vorlage senden , um eine Nachrichtenvorlage zur Genehmigung zu senden.
Schritt 4: Geben Sie die erforderlichen Informationen zum Erstellen einer Vorlage ein.
Feld | Beschreibung |
|---|---|
Vorlagenname | Der Name darf nur alphanumerische Kleinbuchstaben und Unterstriche ( _ ) enthalten. |
Kategorie | Die Kategorie, zu der die Nachrichtenvorlage gehört. |
Sprache | Die Sprache, in der die Vorlage geschrieben ist. |
Schritt 5: Erstellen Sie die Nachricht, indem Sie die erforderlichen Komponenten ausfüllen, und überprüfen Sie die Nachricht dann im Vorschaubereich. Sie können die Parameter {{1}}, {{2}} usw. als Platzhalter einfügen, die mit personalisiertem Inhalt ausgefüllt werden sollen.
Baustein | Beschreibung |
|---|---|
Körper | Der Körper enthält den wichtigsten Text Ihrer Vorlage. Es wird nur Text unterstützt. Sie können Markdown verwenden, um den Inhalt dieses Blocks zu formatieren. Erfahren Sie hier mehr. |
Kopfzeile | Die Kopfzeile ist optional und dient als Titel oder Kopfzeile Ihrer Vorlage. Folgendes wird unterstützt: |
Fußzeile | Die Fußzeile ist optional und unterstützt nur Text. Es kann verwendet werden, um zusätzliche Informationen in Ihrer Nachrichtenvorlage bereitzustellen. |
Taste | Die Schaltfläche ist optional und fügt Ihren Vorlagen Interaktivität hinzu. Es stehen zwei Typen zur Verfügung: |
Schritt 6: Beispielwert angeben
Dies ist nur anwendbar, wenn Sie Parameter in den Inhalt Ihrer Nachrichtenvorlage aufgenommen haben.
Durch die Angabe von Beispielwerten für den Parameter in der Nachrichtenvorlage kann der WhatsApp-Prüfer die Nachricht besser verstehen, die Sie an Ihre Kontakte senden möchten.
Wichtiger Link: Richtlinien für WhatsApp-Nachrichtenvorlagen
Nachrichtenvorlagen synchronisieren
Schritt 1:Navigieren Sie zuArbeitsbereichseinstellungen> Klicken Sie aufKanäle.
Schritt 2:Suchen Sie den WhatsApp Business Platform (API)-Kanal > Klicken Sie aufVerwalten.
Schritt 3: Klicken Sie auf Vorlagen > Vorlage synchronisieren , um den Synchronisierungsvorgang zu starten.
Der Synchronisierungsvorgang ist abgeschlossen. Das heisst:
- Die Nachrichtenvorlagen werden mit ihren entsprechenden Status aufgelistet. - Das Datum und die Uhrzeit der letzten Synchronisierung werden aktualisiert. - Wenn Ihre Vorlage abgelehnt wird, wird der Ablehnungsgrund unter der abgelehnten Nachrichtenvorlage angezeigt.
In der folgenden Tabelle sind die möglichen Status der Nachrichtenvorlagen aufgeführt:
Status | Beschreibung |
|---|---|
Gesendet | Die Nachrichtenvorlage wurde übermittelt und wartet auf Genehmigung. |
Genehmigt | Die Nachrichtenvorlage ist freigegeben und kann an Kontakte versendet werden. |
Abgelehnt | Die Nachrichtenvorlage wurde abgelehnt und kann nicht verwendet werden. |
Verwenden Sie die Suche und den Filter in der oberen rechten Ecke der Liste, um Ihre Vorlagen einfach zu finden!
Unterstützte Dateitypen
Der von WhatsApp unterstützte Dateityp und die maximale Dateigröße für den Typ sind wie folgt:
Audio & Video (16 MB)
Dokument (100 MB)
Bild (5 MB)
Aufkleber (100 KB)
Für nicht unterstützte Nachrichten wird eine Ersatzanzeige mit dem Text und Typ „Nicht unterstützte Nachricht“ oder „Benutzerdefinierte Nutzlast“ (sofern verfügbar) angezeigt. Bei jedem nicht unterstützten Dateityp oder jeder Datei, die die über die WhatsApp Cloud API gesendete maximale Dateigröße überschreitet, wird die Datei auf der respond.io-Plattform automatisch in einen URL-Link umgewandelt. Für benutzerdefinierte Nutzlast können Sie auf Mehr anzeigenklicken, um die JSON-Nutzlast dieser Nachricht anzuzeigen. Beispiele für nicht unterstützte Nachrichten für die WhatsApp Cloud API sind:
– Kontaktkarte
– Reaktionen
– Gelöschte Nachricht
– Umfragen
– Kurzlebige Nachricht
Ratenbegrenzungen
Eine Ratenbegrenzung ist die Anzahl der API-Aufrufe, die eine App oder ein Benutzer innerhalb eines bestimmten, vom Kanal definierten Zeitraums tätigen kann. Erfahren Sie hier mehr über die Ratenbegrenzungen für diesen Kanal.
FAQ und Fehlerbehebung
Nachrichten können nicht gesendet werden
Stelle sicher, dass die Nummer, die du mit der Plattform verbunden hast, eine WhatsApp Cloud API-Nummer ist.
Nachrichten kommen nicht an
Dies kann passieren, wenn der Nachrichten-Webhook nicht abonniert ist.
Schritt 1: Navigieren Sie zur Facebook App Webhook-Seite
Öffnen Sie die Facebook-App und navigieren Sie zur Seite Webhooks .
Schritt 2: Überprüfen des abonnierten Ereignisses
Wählen Sie WhatsApp Business-Konto und überprüfen Sie, ob das Ereignis Nachrichten abonniert ist.
Schritt 3: Senden Sie eine Testnachricht
Senden Sie eine Testnachricht an die WhatsApp-Telefonnummer und prüfen Sie, ob sie angekommen ist.
Es können keine Lesebestätigungen empfangen werden.
Wenn der mit der WhatsApp Cloud API verbundene Benutzer sein Facebook-Passwort ändert, sind die Berechtigungen veraltet und müssen aktualisiert werden.
Schritt 1:Navigieren Sie zuArbeitsbereichseinstellungen> Klicken Sie aufKanäle.
Schritt 2:Suchen Sie den WhatsApp Business Platform (API)-Kanal > Klicken Sie aufVerwalten.
Schritt 3: Klicken Sie auf „Problembehandlung“ >„Berechtigung aktualisieren“, um die WhatsApp-Berechtigungen zu aktualisieren.
Schritt 4: Senden Sie eine Testnachricht an die WhatsApp-Telefonnummer und prüfen Sie, ob sie angekommen ist.
Ausgehende Nachrichten können nicht gesendet werden: Fehler beim Validieren des Zugriffstokens
Dies kann mehrere Gründe haben:
Wenn die Sitzung zur Validierung des Zugriffstokens abgelaufen ist.
Es gab eine Änderung der Administratorrechte des Benutzers'im Meta Business Manager.
Es gab eine Passwortänderung im Meta Business Manager.
Um diesen Fehler zu beheben, müssen Sie Ihre WhatsApp Cloud API-Kanalberechtigungen aktualisieren und erneut eine Testnachricht senden.
Sie müssen der Administrator des Meta Business Managers sein, um die Berechtigung aktualisieren zu können.
Kontakt empfängt keine Nachrichten
Dies kann passieren, wenn der Kontakt den Bedingungen und Datenschutzrichtlinien von WhatsApp nicht zugestimmt hat.
Wenn Ihre Kontakte keine Nachrichten von Ihrer WhatsApp Cloud API-Nummer empfangen können, stellen Sie sicher, dass sie den neuesten WhatsApp-Bedingungen und Datenschutzrichtlinien zugestimmt haben.
Welche Anforderungen gelten für die Telefonnummer, die für die Anmeldung bei der WhatsApp Cloud API verwendet werden muss?
Die für die WhatsApp Cloud API verwendete Telefonnummer kann nicht in der WhatsApp- persönlichen oder geschäftlichen App verwendet werden. Du musst das Konto in der persönlichen oder geschäftlichen WhatsApp-App löschen, bevor du die Nummer zur Anmeldung für eine WhatsApp Cloud API verwenden kannst.
Sie können die Nummer nach der Registrierung auf der WhatsApp Business-Plattform weiterhin für andere Zwecke verwenden, beispielsweise zum Anrufen und Empfangen von SMS.
Sobald Sie ein Telefon für die WhatsApp Cloud API verwenden, können Sie diese Nummer nicht mehr in der WhatsApp Business App verwenden.
Ist eine Geschäftsüberprüfung erforderlich, um die Cloud-API zu verwenden?
Es ist nicht zwingend erforderlich, die Facebook-Unternehmensverifizierung abzuschließen, um mit dem Senden von Nachrichten über WhatsApp zu beginnen. Ohne Unternehmensüberprüfung kann Ihr Unternehmen weiterhin:
Reagieren Sie auf eine unbegrenzte Anzahl von benutzerinitiierten Unterhaltungen.
Senden Sie innerhalb eines Zeitraums von 24 Stunden vom Unternehmen initiierte Konversationen (Nachrichtenvorlagen) an 250 einzelne Kunden.
Registrieren Sie bis zu 2 Telefonnummern.
Unternehmen können die Geschäftsüberprüfung nur dann einleiten, wenn sie'bereit sind, geschäftlich initiierte Gespräche zu skalieren oder ein offizielles Geschäftskonto werden möchten.
Kann ich meine Konversationseinblicke für mein WhatsApp Business-Konto anzeigen?
Ja, Sie können Ihre Nachrichten- und Ausgabenanalysen für Ihr WhatsApp-Geschäftskonto in Echtzeit auf der Registerkarte „ Insights “ Ihres Meta WhatsApp Managers überwachen. Lesen Sie hier mehr .
Was sind die Nachrichtenlimits von WhatsApp?
Die Nachrichtenlimits bestimmen die maximale Anzahl von einzigartigen WhatsApp-Nutzern, mit denen ein Geschäftsportfolio innerhalb eines 24-Stunden-Zeitraums geschäftsinitiierte Gespräche starten kann. Dieses Limit wird über alle Telefonnummern im Portfolio geteilt.
Diese Beschränkungen gelten nicht für vom Benutzer initiierte Gespräche. Ein geschäftlich initiiertes Gespräch beginnt, wenn die erste Nachricht an einen Kunden zugestellt wird und dauert 24 Stunden.
Ein häufiges Missverständnis ist, dass jede Nachricht auf das Limit angerechnet wird – in Wirklichkeit zählen mehrere Nachrichten, die innerhalb von 24 Stunden an denselben Nutzer gesendet werden, immer noch als eine Konversation.
Lesen Sie hier mehr . .
Wie füge ich meinem WhatsApp Business-Konto eine Zahlungsmethode hinzu?
Sie können Ihrem WhatsApp Business-Konto im Business Manager eine Zahlungsmethode hinzufügen. Erfahren Sie hier, wie Sie Ihrem WhatsApp Business-Konto eine Zahlungsmethode hinzufügen.
Warum konnte meine Nachricht nicht gesendet werden und es trat der Fehler „Problem mit der Zahlungsberechtigung für Unternehmen“ auf?
Dies liegt höchstwahrscheinlich daran, dass Sie den monatlichen Grenzwert für das kostenlose Kontingent ohne eine gültige Zahlungsmethode überschritten haben. Um dieses Problem zu beheben, fügen Sie eine gültige Zahlungsmethodehinzu.
Wie hoch sind die Preise für die WhatsApp Cloud API?
Ab dem 1. Juli 2025 verwendet die WhatsApp Cloud API ein hybrides Preismodell. Servicegespräche (wenn du innerhalb von 24 Stunden auf einen Kunden antwortest) werden pro Gespräch abgerechnet. Vorlagennachrichten – Marketing-, Dienstleistungs- und Authentifizierungsnachrichten – werden pro gesendeter Nachricht abgerechnet. Dienstleistungsvorlagen sind kostenlos, wenn sie innerhalb von 24 Stunden gesendet werden, während Authentifizierungs- und Marketingvorlagen immer pro Nachricht berechnet werden. Vorlagen für hohe Volumina bei Dienstleistungen und Authentifizierung erhalten automatische gestaffelte Rabatte. Kostenlose Entry Point-Gespräche aus Anzeigen oder Page CTAs eröffnen ein 72-stündiges kostenloses Fenster, in dem alle Nachrichtentypen kostenlos sind.
Erfahre mehr über WhatsApp-Preise hier.
Wie lösche ich eine Telefonnummer aus einem Geschäftskonto?
Zum Löschen einer Telefonnummer sind einige Voraussetzungen und Schritte erforderlich. Weitere Informationen finden Sie hier.
Kann ich respond.io verwenden, um eine WhatsApp Cloud API-Übertragung mit der Meta-Testnummer zu senden?
Sie können mit der Meta-Testnummer eine Testübertragung von der Plattform aus senden. Allerdings ist eine Aussendung über die Testnummer auf fünf Empfänger begrenzt. Sie müssen diese fünf Empfänger zunächst zur Telefonnummernliste in den Meta Developer Tools hinzufügen.
Wenn Sie dieser Liste keine Empfänger hinzufügen oder versuchen, eine Rundsendung an Empfänger zu senden, die nicht auf dieser Liste stehen, erhalten Sie diese Fehlermeldung:
Kann ich die Meta-Testnummer aus meinem verbundenen Cloud-API-Konto löschen?
Nein, diese Nummer wird allen Konten automatisch zum Senden von Testnachrichten zugewiesen und kann nicht gelöscht werden. Beachten Sie jedoch, dass es sich hierbei um eine Testnummer handelt, die nicht für andere Zwecke verwendet werden darf.
Warum werden mir doppelte Kontakte aus demselben WhatsApp-Kanal angezeigt?
WhatsApp übergibt die Telefonnummer des Kontakts in einem Format, das sich vom E.164-Format unterscheidet, das von Respond.io verwendet wird. Dieser Unterschied führt dazu, dass Kontakte aus bestimmten Ländern dupliziert werden. Sollte dies passieren, kontaktieren Sie uns bitte hier .
Wie ändere ich meinen Cloud-API-Anzeigenamen?
Um Ihren Cloud-API-Anzeigenamenzu ändern, folgen Sie diesen Schritten:
Navigieren Sie zu Ihrem FBM > WhatsApp-Konto > Telefonnummer. Auf dieser Seite werden Ihr Nachrichtenlimit und die Nachrichtenqualität angezeigt.
Bewegen Sie den Mauszeiger über das Stiftsymbol neben dem Anzeigenamen, um die Bearbeitung zu aktivieren.
Klicken Sie auf Weiter , um Ihren neuen Anzeigenamen zur Genehmigung an Meta zu senden.
Warten Sie auf die Bestätigung der Genehmigung von Meta.
Welche Schritte muss ich unternehmen, nachdem mein neuer Anzeigename für meine Cloud-API genehmigt wurde?
Nachdem Sie von Meta die Genehmigung für Ihren neuen Anzeigenamen erhalten haben, führen Sie die folgenden Schritte aus:
Registrieren Sie Ihre Telefonnummer erneut mit dem neu genehmigten Anzeigenamen.
Führen Sie einen POST-API-Aufruf aus, um Ihre Telefonnummerzu bestätigen.
Führen Sie einen weiteren POST-API-Aufruf durch, um die verifizierte Telefonnummer erneut zu registrieren.
Nach erfolgreichem Abschluss ist die Aktualisierung des Anzeigenamens Ihrer Cloud API abgeschlossen.
Warum trat beim Versuch, eine Nachricht zu senden, der Fehler „Fehler beim Validieren des Zugriffstokens: Die Sitzung wurde für ungültig erklärt, da der Benutzer sein Kennwort geändert hat oder Facebook die Sitzung aus Sicherheitsgründen geändert hat“ auf?
Dieser Fehler tritt auf, wenn Sie Ihre Facebook-Anmeldeinformationen kürzlich aktualisiert haben. Dadurch kann die Kanalverbindung auf unserer Plattform unterbrochen werden, was zu Fehlern beim Senden von Nachrichten führt.
Um dieses Problem zu beheben, müssen Sie die Kanalberechtigungen auf unserer Plattform mit Ihren aktualisierten Facebook-Anmeldeinformationen aktualisieren. Für diesen Vorgang ist eine Administratorrolle erforderlich. Durch das Aktualisieren der Berechtigungen stellst du die Verbindung mit den neuen Anmeldeinformationen wieder her, um sicherzustellen, dass deine ausgehenden Nachrichten erfolgreich gesendet werden, ohne auf Fehler zu stoßen.
