respond-io
New
🚀 TikTok Business Messaging ist live! Verwandeln Sie Gespräche nahtlos in Konvertierungen. Mehr erfahren.arrow-icon

Startseite >

Kanäle >
WhatsApp >
WhatsApp Cloud API

WhatsApp Cloud API

Avatar
JQ Lee
· 23 Jul 2024
8 Min. Lesezeit

Sie können nun Ihr verbundenes WhatsApp 360dialog-Konto migrieren. io WhatsApp Business API bietet Ihnen eine höhere Zuverlässigkeit, niedrigere Kosten und Zugriff auf neue Funktionen. Erfahren Sie mehr über den Migrationsprozess hier.

Um WhatsApp Cloud API zu verbinden, ist eine Facebook-App mit WhatsApp Produkt aktiviert. Lesen Sie diese Anleitung zur Einrichtung Ihrer Facebook-App.

Facebook kündigte die Veröffentlichung der WhatsApp Cloud API am 20. Mai an und steht allen Unternehmen jeder Größe zur Verfügung groß und klein, um mit Kunden über die offizielle WhatsApp API zu kommunizieren.

Dieser Kanal verfügt über ein limitiertes Nachrichtenfenster rund um die Uhr aufgrund der WhatsApp-Regelungen. Erfahren Sie mehr über WhatsApp's Geschäftspolitik hier.

WhatsApp Cloud API wird verbunden

Sehen Sie sich das Video unten an, um eine Schritt-für-Schritt-Anleitung zur WhatsApp Cloud API zu antworten.

Um mit Ihren Kunden über die WhatsApp Cloud API zu chatten, verbinden Sie ein WhatsApp Business Profil und ein Meta Business Account.

Facebook-App und Meta-Business-Konto sind erforderlich und Sie müssen der Admin beider sein, um sich zu verbinden.

Schritt 1:Gehe zuArbeitsbereichseinstellungen> KlickKanal

Schritt 2:Suchen Sie den WhatsApp Cloud API Kanal > Klicken SieVerbinden.

Schritt 3: Klicken Sie auf dieVerbindung mit FacebookSchaltfläche.

Schritt 4: Melden Sie sich über das Facebook-Konto mit Administrator-Zugriff auf das Facebook- und Meta-Firmenkonto an.

Schritt 5: In der Dropdown-Liste wählen Sie den WABA-Namen mit der zu verbindenden WhatsApp-Nummer.

Schritt 6: Füge die Callback-URL hinzu. Gehe zurück zurWhatsAppSektion in der Facebook-Entwickler-App. Navigieren Sie zum UnterabschnittKonfigurationund richten Sie die Callback-URL ein. Fügen Sie die generierte Callback-URL hinzu und überprüfen Sie das Token von respond.io in die entsprechenden Felder im Webhook-Dialog.

Schritt 7: In der Facebook-App überprüfen und speichern Sie die Änderungen an der App.

Schritt 8: Abonnieren Sie das Webhook Event. Auf Ihrer Facebook-App, Wählen Sie die RegisterkarteWebhooksunter der RegisterkarteProdukteaus und wählen Sie in der Dropdown-ListeWhatsApp Business Accountaus. Klicken Sie auf Abonnieren Nachrichten Ereignis.

Schritt 9: Klicken Sie oben auf die Schaltfläche, um den Live-Modus zu aktivieren.

Vergessen Sie nicht, die URL Ihrer Datenschutzrichtlinie einzutragen. Wenn diese Option leer ist, dürfen Sie den Live-Modus nicht einschalten.

Schritt 10: Klicken Sie auf Änderungen speichern, um das Setup abzuschließen.

Sobald Sie've das Setup abgeschlossen haben, werden alle Nachrichten, die an Ihre WhatsApp-Nummer gesendet werden, jetzt in Ihrem Arbeitsbereich empfangen.

Kanalkonfiguration

WhatsApp Cloud API Channel kann mit einem eindeutigen Kanalnamen konfiguriert werden.

Schritt 1:Gehe zuArbeitsbereichseinstellungen> KlickeKanäle.

Schritt 2:Suchen Sie den WhatsApp Cloud API Kanal > Klicken Sie aufVerwaltung.

Schritt 3:Konfigurieren Sie den Kanalnamen, der intern verwendet wird, um das Konto zu identifizieren.

Schritt 4:Klicken SieÄnderungen speichern um die Kanalkonfiguration zu aktualisieren.

Metadaten empfangen vom Kanal

Verschiedene Kanäle bieten verschiedene Metadaten von Contact’s zur Respond.io-Plattform. Hier ist die Liste der Kontaktdaten, die du aus diesem Kanal beziehen kannst:

  • Telefonnummer

  • Telefonnummer ID

  • Profilname

  • WhatsApp ID

Verwaltung des WhatsApp Cloud API Profils

Wenn Sie eine Änderung vornehmen oder Ihr WhatsApp Cloud API Profil überprüfen müssen, kann dies auf der respond.io Plattform geschehen.

Schritt 1:Gehe zuArbeitsbereichseinstellungen> KlickeKanäle.

Schritt 2:Suchen Sie den WhatsApp Cloud API Kanal > Klicken Sie aufVerwalten > Profil.

Schritt 3: Klicken Sie auf Profil synchronisieren, um die aktuellsten WhatsApp Business Profile Informationen von WhatsApp zu erhalten.

Schritt 4: Bearbeite die folgenden Informationen nach Bedarf.

Felder

Beschreibung

Profilfoto

Bild als Profilbild des WhatsApp Business-Kontos angezeigt.Eine Bildgröße von 640x640 wird empfohlen.

Über

Das Geschäft's Über Text. Dieser Text erscheint im Profil's unter seinem Profilbild, Telefonnummer und Kontakt-Schaltflächen.

Adresse.

Adresse des Unternehmens. Maximal 256 Zeichen.

Beschreibung

Beschreibung des Geschäfts. Maximal 512 Zeichen.

E-Mail

E-Mail-Adresse (im gültigen E-Mail-Format) um das Unternehmen zu kontaktieren. Maximal 128 Zeichen.

Vertikal

Industrie des Unternehmens. Muss einer dieser akzeptierten Werte sein:AutomotiveBeauty, Spa and SalonClothing and ApparelEducationEntertainmentEvent Planning and ServiceFinance and BankingFood and GroceryPublic ServiceHotel and LodgingMedical and HealthNon-profitProfessional ServicesShopping und RetailTravel and TransportRestaurantOtherDas Business vertikale kann nicht auf einen leeren Wert zurückgesetzt werden, nachdem es geschaffen wurde.

Webseite

URLs (einschließlich http:// oder https://), die mit dem Unternehmen verbunden sind (z.B. Webseite, Facebook-Seite, Instagram). Maximal 2 Webseiten mit maximal 256 Zeichen pro Seite.

Schritt 5: Überprüfen Sie die Informationen und klicken Sie auf Änderungen speichern.

WhatsApp Nachrichtenvorlagen verwalten

Bevor Sie eine Nachrichtenvorlage an einen Kontakt auf der respond.io Plattform senden, stellen Sie sicher, dass Sie've Folgendes getan haben:

- Die Nachrichtenvorlage zur Freigabe übertragen- Die genehmigte Nachrichtenvorlage wurde dem Arbeitsbereich hinzugefügt, indem die Nachrichtenvorlage synchronisiert wurde

Nachrichtenvorlagen senden

Schritt 1:Gehe zuArbeitsbereichseinstellungen> KlickeKanäle.

Schritt 2:Suchen Sie den WhatsApp Cloud API Kanal > Klicken SieVerwalten.

Schritt 3: Klicken Sie auf Vorlagen > Vorlage abschicken, um eine Nachrichtenvorlage zur Genehmigung zu senden.

Schritt 4: Füllen Sie die erforderlichen Informationen aus, um eine Vorlage zu erstellen.

Feld

Beschreibung

Vorlagenname

Der Name kann 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 notwendigen Komponenten ausfüllen und dann die Nachricht im Vorschau-Bereich lesen. Sie können die Parameter 1, 2, etc. als Platzhalter angeben, die mit personalisierten Inhalten ausgefüllt werden sollen.

Baustein

Beschreibung

Körper

Der Körper enthält den wichtigsten Text Ihrer Vorlage. Nur Text wird unterstützt. Sie können Markdown verwenden, um den Inhalt dieses Blocks zu formatieren. Erfahren Sie mehr hier.

Kopfzeile

Der Header ist optional und dient als Titel oder Header Ihrer Vorlage. Es unterstützt Folgendes:
- Text
- Bild
- Video
- Dokument

* Antworten. o Plattform akzeptiert Uploads bis zu 20 MB groß.

Fußzeile

Die Fußzeile ist optional und unterstützt nur Text. Es kann verwendet werden, um zusätzliche Informationen in Ihrer Nachrichtenvorlage bereitzustellen.

Button

Der Button ist optional und fügt Interaktivität zu Ihren Vorlagen hinzu. Es stehen zwei Arten zur Verfügung:
Aktions-Button
- Wird verwendet, um Ihren Client an eine Webseite zu senden oder eine Telefonnummer zu rufen
- Maximal eine URL und Telefonnummer pro Vorlage
- URL kann einen Parameter oder eine personalisierungQuick

Antwortschaltfläche
- Benutzt, um schnelle Antworten von Ihrem Kunden zu erhalten
- Maximal 3 Schnellantwort-Tasten pro Vorlage
- Jede Schnellantwort-Schaltfläche kann nicht mehr als 20 Zeichen

* Schnellantwort-Tasten werden nur auf iOS unterstützt, Android und Web-Plattformen, aber nicht auf Windows-Plattformen. Weitere Details finden Sie hier.

Schritt 6: Geben Sie Beispielwert an

Dies ist nur anwendbar, wenn Sie Parameter in Ihre Nachrichtenvorlage aufgenommen haben.

Die Angabe von Beispielwerten für den Parameter in der Nachrichtenvorlage hilft dem WhatsApp Prüfer dabei, die Nachricht zu verstehen, die Sie an Ihre Kontakte senden möchten.

Wichtiger Link: WhatsApp Nachrichtenvorlagen-Richtlinien

Nachrichtenvorlagen synchronisieren

Schritt 1:Gehe zuArbeitsbereichseinstellungen> KlickeKanäle.

Schritt 2:Suchen Sie den WhatsApp Business Platform (API) Kanal > Klicken SieVerwalten.

Schritt 3: Klicken Sie auf Vorlagen > Sync-Vorlage um den Synchronisierungsprozess zu starten.

Der Synchronisierungsprozess wurde abgeschlossen. Das bedeutet:

- Die Nachrichtenvorlagen werden mit dem entsprechenden Status aufgelistet. - Die letzte Synchronisationszeit wird aktualisiert. Wenn Ihre Vorlage abgelehnt wird, wird der Ablehnungsgrund unterhalb der abgelehnten Nachrichtenvorlage angezeigt.

Die folgende Tabelle listet die möglichen Status für die Nachrichtenvorlagen auf:

Status

Beschreibung

Eingereicht

Die Nachrichtenvorlage wird übermittelt und zur Genehmigung ausstehend.

Genehmigt

Die Nachrichtenvorlage ist genehmigt und kann an Kontakte gesendet werden.

Abgelehnt

Die Nachrichtenvorlage wurde abgelehnt und kann nicht verwendet werden.

Verwenden Sie die Suche und den Filter oben rechts in der Listung um einfach Ihre Vorlagen zu finden!

Unterstützte Dateitypen

Der Dateityp wird von WhatsApp unterstützt und die maximale Dateigröße für den Typ lautet wie folgt:

  • Audio & Video (16MB)

  • Dokument (100 MB)

  • Bild (5 MB)

  • Aufkleber (100 KB)

Nachrichten, die nicht unterstützt werden, haben ein Fallback-Display mit Nicht unterstützter Nachricht oder benutzerdefinierter Payload-Text und Typ (falls verfügbar). Für alle nicht unterstützten Dateitypen oder Dateien, die die maximale Dateigröße überschreiten, die über WhatsApp Cloud API gesendet wird, die Datei wird automatisch in einen URL-Link auf der Antwort umgewandelt. o Plattform. Für benutzerdefiniertes Payload können Sie Mehr anzeigenklicken, um die JSON Payload dieser Nachricht anzuzeigen. Beispiele für nicht unterstützte Nachrichten für WhatsApp Cloud API sind:
- Contact Card
- Reaktionen
- Gelöschte Nachricht
- Umfragen
- Ephemerale Nachricht

Bewertungsbeschränkungen

Ein Preislimit ist die Anzahl der API-Aufrufe, die eine App oder ein Benutzer innerhalb eines vom Kanal festgelegten Zeitraums durchführen kann. Erfahren Sie mehr über die Kurslimits für diesen Kanal hier.

FAQ und Fehlerbehebung

Senden von Nachrichten nicht möglich

Stellen Sie sicher, dass die Nummer, die Sie've mit der Plattform verbunden haben, eine WhatsApp Cloud API-Nummer ist.

Nachrichten kommen nicht an

Dies kann passieren, wenn der Webhook nicht abonniert ist.

Schritt 1: Navigiere zur Facebook-App Webhook Seite

Öffnen Sie die Facebook-App und navigieren Sie zur Webhooks Seite.

Schritt 2: Überprüfen Sie das abonnierte Ereignis

Wählen Sie WhatsApp Business Account und überprüfen Sie, ob die Nachrichten Veranstaltung abonniert ist.

Schritt 3: Eine Testnachricht senden

Senden Sie eine Testnachricht an die WhatsApp Telefonnummer und überprüfen Sie, ob sie angekommen ist.

Empfangsbestätigung konnte nicht empfangen

Wenn der Benutzer mit WhatsApp Cloud API sein Facebook-Passwort ändert, sind die Berechtigungen veraltet und müssen aktualisiert werden.

Schritt 1:Gehe zuArbeitsbereichseinstellungen> KlickeKanäle.

Schritt 2:Suchen Sie den WhatsApp Business Platform (API) Kanal > Klicken SieVerwalten.

Schritt 3: Klicken Sie auf Probleme >Aktualisieren der Berechtigungum die WhatsApp Berechtigungen zu aktualisieren.

Schritt 4: Senden Sie eine Testnachricht an die WhatsApp Telefonnummer und überprüfen Sie, ob sie angekommen ist.

Unmöglich, ausgehende Nachrichten zu senden: Überprüfe Zugriffstoken Fehler

Dies kann aus einigen Gründen passieren:

  • Wenn die Sitzung zur Validierung des Zugriffstoken abgelaufen ist.

  • Es gab eine Änderung an der Admin-Berechtigung des Benutzers's 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 empfange keine Nachrichten

Dies kann passieren, wenn der Kontakt den WhatsApp Nutzungsbedingungen und Datenschutzrichtlinien nicht zugestimmt hat.

Wenn Ihre Kontakte keine Nachrichten von Ihrer WhatsApp Cloud-API-Nummer erhalten können vergewissern Sie sich, dass Sie den neuesten WhatsApp Nutzungsbedingungen und Datenschutzrichtlinien zugestimmt haben.

Was sind die Voraussetzungen für die Registrierung der Telefonnummer für die WhatsApp Cloud API?

  • Die für WhatsApp Cloud API verwendete Telefonnummer kann't in der WhatsApp persönlichen oder geschäftlichen App verwendet werden. Sie'll müssen das Konto in der WhatsApp persönlichen oder geschäftlichen App löschen, bevor Sie die Nummer verwenden können, um sich für eine WhatsApp Cloud API anzumelden.

  • Sie können die Nummer nach der Registrierung auf der WhatsApp Business Plattform weiterhin für andere Zwecke verwenden, wie zum Beispiel Anrufe und Empfang 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.

Benötigt Business-Verifizierung um mit der Cloud API zu beginnen?

Es ist nicht zwingend erforderlich, die Facebook Business-Verifizierung abzuschließen, um Nachrichten auf WhatsApp zu senden. Ohne betriebliche Überprüfung wird Ihr Unternehmen immer noch in der Lage sein:

  • Antworten Sie auf unbegrenzte von Ihnen initiierte Gespräche.

  • Senden Sie geschäftlich initiierte Gespräche (Nachrichtenvorlagen) an 250 Kunden in einem rollenden 24-Stunden-Zeitraum.

  • Registrieren Sie bis zu 2 Telefonnummern.

Unternehmen können nur dann eine Überprüfung der Unternehmen einleiten, wenn sie'rerebereit sind, geschäftlich initiierte Gespräche zu skalieren oder ein offizielles Geschäftskonto werden möchten.

Kann ich meine Konversations-Einblicke für mein WhatsApp Business-Konto sehen?

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 mehr hier.

Was sind WhatsApp Messaging-Grenzen?

Messaging-Limits bestimmen die maximale Anzahl von von von Unternehmen initiierten Gesprächen, die jede Telefonnummer in einem rollenden 24-Stunden-Zeitraum senden kann. Diese Grenzen gelten nicht für vom Benutzer initiierte Gespräche. Ein von Unternehmen initiiertes Gespräch beginnt mit der ersten Nachricht an einen Kunden und endet 24 Stunden später. Lesen Sie mehr hier.

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, wie Sie eine Zahlungsmethode zu Ihrem WhatsApp Business Account hinzufügen können hier.

Warum konnte meine Nachricht nicht mit einem Fehler bei "Business Zahlungsproblem" gesendet werden?

Dies liegt am wahrscheinlichsten daran, dass Sie die monatliche kostenlose Statusschwelle ohne gültige Zahlungsmethode überschreiten. Um dieses Problem zu beheben, fügen Sie eine gültige Zahlungsmethodehinzu.

Was ist WhatsApp Cloud API Preis?

WhatsApp API verwendet ein kommunikationsbasiertes Preismodell, das Unternehmen für die Anzahl der Unterhaltungen belastet. Eine Konversation beginnt, wenn Ihre geschäftliche' Nachricht an einen Kunden übermittelt wird und dauert ein 24-stündiges Kundendienstfenster, während dem eine beliebige Anzahl von Nachrichten zwischen dem Kunden und dem Unternehmen ausgetauscht werden kann. Für Unternehmen entstehen Kosten für jedes einzelne Gespräch, unabhängig davon, wie viele Nachrichten in diesem Kundendienstfenster gesendet oder empfangen werden.

Erfahren Sie mehr über WhatsApp Pricing hier.

Wie lösche ich eine Telefonnummer von einem Firmenkonto?

Es sind einige Voraussetzungen und Schritte erforderlich, um eine Telefonnummer zu löschen, lesen Sie mehr hier.

Kann ich antword.io verwenden, um eine WhatsApp Cloud API mit der Meta-Testnummer zu senden?

Sie können eine Testübertragung von der Plattform mit der Meta-Testnummer versenden. Eine Sendung mit der Testnummer ist jedoch auf fünf Empfänger beschränkt. Sie müssen zuerst diese fünf Empfänger der Telefonnummernliste in den Meta-Entwicklerwerkzeugen hinzufügen.

Wenn Sie keine Empfänger zu dieser Liste hinzufügen oder versuchen, eine Sendung an Empfänger zu senden, die nicht auf dieser Liste sind erhalten Sie diese Fehlermeldung:

Kann ich die Meta-Testnummer von meinem verbundenen Cloud-API-Konto löschen?

Nein, diese Nummer wird automatisch allen Konten zur Verfügung gestellt und kann nicht gelöscht werden. Beachten Sie bitte, dass es sich hierbei um eine Testnummer handelt, die nicht für andere Zwecke verwendet werden kann.

Warum sehe ich doppelte Kontakte aus dem gleichen WhatsApp-Kanal?

WhatsApp übergibt die Telefonnummer des Kontakts im ein Format, das sich von dem im E.164-Format unterscheidet. Diese Differenz bewirkt, dass Kontakte aus bestimmten Ländern dupliziert werden. Sollte dies passieren, kontaktieren Sie uns bitte hier .

Wie ändere ich meinen Anzeigenamen für die Cloud API?

Um Ihren Namen für die Cloud-API-Anzeigezu ändern, folgen Sie diesen Schritten:

  1. Navigieren Sie zu Ihrem FBM > WhatsApp Konto > Telefonnummer. Diese Seite zeigt Ihnen Ihr Messaging-Limit und Ihre Qualität.

  2. Fahren Sie mit der Maus über das Stift-Symbol neben dem Anzeigenamen um die Bearbeitung zu aktivieren.

  3. Klicken Sie auf Nächste um Ihren neuen Anzeigenamen an Meta zur Genehmigung zu senden.

  4. Warten Sie auf die Bestätigung der Genehmigung von Meta.

Welche Schritte sollte ich unternehmen, sobald mein neuer Anzeigename für meine Cloud API freigegeben ist?

Nach der Freigabe von Meta für Ihren neuen Anzeigenamen führen Sie folgende Schritte aus:

  1. Registrieren Sie Ihre Telefonnummer unter Verwendung des neu genehmigten Anzeigenamens.

  2. Führen Sie einen POST API-Aufruf an aus, überprüfen Sie Ihre Telefonnummer.

  3. Machen Sie einen weiteren POST API-Aufruf an , registrieren Sie die verifizierte Telefonnummer.

  4. Sobald Sie erfolgreich sind, ist Ihre Cloud-API's Anzeigenamen-Aktualisierung abgeschlossen.

Warum ist mir der Fehler "Fehler bei der Überprüfung des Zugriffstoken aufgetreten: Die Sitzung wurde ungültig weil der Benutzer sein Passwort geändert hat oder Facebook die Sitzung aus Sicherheitsgründen" beim Senden einer Nachricht geändert hat?

Dieser Fehler tritt auf, wenn du deine Facebook-Anmeldeinformationen kürzlich aktualisiert hast, es könnte die Kanalverbindung auf unserer Plattform stören, was zu Fehlern beim Versenden von Nachrichten führt.

Um dieses Problem zu beheben, musst du die Kanal-Berechtigungen auf unserer Plattform mit deinen aktualisierten Facebook-Zugangsdaten aktualisieren. Dieser Prozess erfordert eine Admin-Rolle. Durch das Aktualisieren der Berechtigungen stellen Sie'll die Verbindung mit den neuen Anmeldeinformationen wieder her. Stellen Sie sicher, dass Ihre ausgehenden Nachrichten erfolgreich gesendet werden, ohne dass es zu Fehlern kommt.

Diesen Artikel teilen
Telegram
Facebook
Linkedin
Twitter

Verwandte Artikel 👩‍💻

WhatsApp Business Plattform (API) Schnellstart
Holen Sie sich schnell ein WhatsApp Business API Konto um mit Ihren Kunden zu chatten.
WhatsApp Business Calling API
Erfahren Sie, wie Sie WhatsApp Business Calling API verwenden, um Anrufe zu empfangen und zu tätigen.
Telefonnummer-Migration zu antworten. io WhatsApp Business Plattform (API)
Lerne wie du deine Telefonnummer von anderen BSPs migrierst um zu antworten. io WhatsApp Business API.
Bereit für eingehende Unterhaltungen
Erfahren Sie mehr über Gesprächsfenster, das Senden von Nachrichtenvorlagen und die Einrichtung eines einfachen Einstiegspunkts zur Verwaltung von WhatsApp-Nachrichten von Ihren Kunden.
WhatsApp Nachrichtenvorlagen
Verwenden Sie WhatsApp Nachrichtenvorlagen, um jederzeit mit Kontakten zu arbeiten.

Sie können nicht finden, was Sie suchen? 🔎