WhatsApp Business Plattform (API) Kanalkonfiguration

Konfigurieren des WhatsApp-Kanalnamens

Ein WhatsApp Business Platform (API)-Kanal kann mit einem eindeutigen Kanalnamen konfiguriert werden.

Schritt 1: Gehe zu Workspace-Einstellungen > klicke auf Kanäle.

Schritt 2: Suche den WhatsApp Business Platform (API)-Kanal > klicke auf Verwalten.

Schritt 3: Konfiguriere den Kanalnamen, der intern zur Identifizierung des Kontos verwendet wird.

Schritt 4: Klicke auf Änderungen speichern, um die Kanalkonfiguration zu aktualisieren.

Profilverwaltung für die WhatsApp Business Platform (API)

Wenn Sie eine Änderung vornehmen oder Ihr WhatsApp Business Platform (API)-Profil überprüfen müssen, können Sie dies auf der respond.io-Plattform tun.

Schritt 1: Gehe zu Workspace-Einstellungen > klicke auf Kanäle.

Schritt 2: Suche den WhatsApp Business Platform (API)-Kanal > Verwalten > Profil

Schritt 3: Wenn das Profil noch nicht synchronisiert wurde, klicke auf Profil synchronisieren, um die neuesten WhatsApp Business-Profilinformationen von WhatsApp zu erhalten.

Schritt 4: Sie können die folgenden Informationen nach Bedarf bearbeiten:

Schritt 5: Überprüfe die Informationen und klicke auf Profil speichern.

Vom Kanal empfangene Metadaten

Verschiedene Kanäle stellen der respond.io-Plattform unterschiedliche Sätze von Kontaktmetadaten bereit. Sie können die folgenden Daten des Kontakts von diesem Kanal erhalten:

• Telefonnummer

• Telefonnummern-ID

• Profilname

• WhatsApp-ID

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 maximale Dateigröße überschreitet, die über die WhatsApp Business Platform (API) gesendet wird, wird die Datei auf der respond.io-Plattform automatisch in einen URL-Link umgewandelt. Für Custom Payload kannst du auf Show More klicken, um die JSON-Nutzlast dieser Nachricht anzuzeigen. Beispiele für nicht unterstützte Nachrichten für die WhatsApp Business Platform (API) sind:
– Kontaktkarte
– Reaktionen
– Gelöschte Nachricht
– Umfragen
– Kurzlebige Nachricht

Stellen Sie sicher, dass das Dateiformat Ihrer Datei unterstützt wird. Andernfalls kann die Datei möglicherweise nicht gesendet werden, obwohl sie innerhalb der Größenbeschränkung liegt. Dies passiert, wenn die Datei nicht richtig konvertiert wird. Erfahre mehr über die unterstützten Medientypen.

Textformatierung

Sie können in Ihren Nachrichten Text- oder Markdown-Formatierungen verwenden. Erfahre mehr darüber, wie du deinen Text formatierst.

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. Erfahre mehr über die Rate-Limits für diesen Kanal.

Einschränkungen

WhatsApp-Gruppen

Gruppennachrichten werden von der WhatsApp Business Platform (API) nicht unterstützt. Meta hat die Entwicklung dieser Funktion eingestellt.

Nicht unterstützte Nummerntypen

WhatsApp erlaubt keine VoIP-, gebührenfreien oder Festnetznummern. Das umfasst:

• Telnyx-Nummern (seit Januar 2023 nicht mehr unterstützt)

• Google Voice-Nummern (VoIP)

Best Practices zur Vermeidung einer WABA-Deaktivierung

Für die langfristige Stabilität deiner WhatsApp Business‑Plattform (API)-Einrichtung und zur Vermeidung unerwarteter Sperrungen oder Unterbrechungen befolge diese Best Practices:

Verwende einen verifizierten und eindeutigen Meta Business Manager (MBM)

• Verwende pro Unternehmen nur einen MBM. Das Erstellen mehrerer MBMs mit demselben Firmennamen, derselben Adresse oder Website kann von Meta markiert werden.

• Wenn ein vorheriger MBM gesperrt wurde, vermeide es, dieselben Geschäftsdaten zur Erstellung eines neuen zu verwenden—Meta könnte ihn sofort sperren.

• Verifiziere deinen MBM durch Einreichen offizieller Geschäftsdokumente (z. B. Gewerbeschein, passende Website).

• Zugriff sorgfältig kontrollieren: Gewähre Administratorrechte nur echten Facebook-Profilen mit nachvollziehbarer Aktivität (Beiträge, Freundeskreis etc.).

• Aktiviere die Zwei-Faktor-Authentifizierung (2FA) für alle Admins.

Verwalte WhatsApp Business Accounts (WABAs) verantwortungsbewusst

• Wenn eine WABA gesperrt wird, lege Einspruch über den Meta Support ein. Erstelle während eines laufenden Einspruchs keine neue—das könnte als Umgehung der Richtlinien angesehen werden.

• Verwende klare und genaue Anzeigenamen. Zum Beispiel ist "Acme Co – California" besser als nur "Acme".

• Lösche Telefonnummern nicht häufig und lege sie nicht neu an (sogenannte „burning“-Nummern). Löse stattdessen das gemeldete Problem über Meta.

Gehe richtig mit Facebook-Nutzern um

• Admins müssen authentische Facebook-Konten mit nachvollziehbarer Historie verwenden.

• Vermeide die Verwendung neu erstellter oder doppelter Konten nur zum Zweck des Zugriffs.

• Beschränke den Zugriff auf notwendige Teammitglieder und überprüfe die MBM-Benutzer regelmäßig.

• Setze 2FA durch, um das Risiko unbefugter Zugriffe zu verringern.

Halte dein Unternehmen plattformübergreifend konsistent

• Stelle sicher, dass dein Geschäftsname, deine Adresse, deine Website und andere Angaben in deinem MBM, WABA und Ad Account übereinstimmen.

• Diese Übereinstimmung erhöht das Vertrauen von Meta und verbessert deine Chancen auf Verifizierung.

Wenn deine WABA deaktiviert wird

• Keine Panik und keine neue WABA erstellen.

• Reiche einen Einspruch ein via Meta Business Support.

• Sammle und lege die notwendigen Dokumente vor (z. B. Gewerbeschein, Nachweis der Domain-Inhaberschaft).

• Überprüfe und behebe Verstöße gegen Metas Business Messaging Policy.

Wenn du diese Best Practices befolgst, bleibt deine WhatsApp-Konfiguration sicher, stabil und konform mit Metas Richtlinien.

FAQ und Fehlerbehebung

Welche Anforderungen muss eine Telefonnummer erfüllen, um sich für die WhatsApp Business Platform (API) anzumelden?

• Die für die WhatsApp Business Platform (API) verwendete Telefonnummer darf nicht in der WhatsApp Personal- oder Business-App verwendet werden. Du musst das Konto in der WhatsApp Personal- oder Business-App löschen, bevor du die Nummer für die Anmeldung bei der WhatsApp Business Platform (API) verwenden kannst.

• Du kannst die Telefonnummer nach der Registrierung auf der WhatsApp Business Platform weiterhin für andere Zwecke nutzen, z. B. zum Telefonieren und Empfangen von SMS.

Kann ich Einblicke in meine Konversationen für mein WhatsApp Business‑Konto einsehen?

Ja, du kannst deine Messaging- und Ausgabenanalysen in Echtzeit für dein WhatsApp Business‑Konto im Reiter Insights deines Meta WhatsApp Managers überwachen. Mehr dazu hier.

Warum sehe ich doppelte Kontakte aus demselben WhatsApp‑Kanal?

WhatsApp übermittelt die Telefonnummer des Kontakts in einem Format, das sich vom E.164-Format unterscheidet, das respond.io verwendet. Dieser Unterschied führt dazu, dass Kontakte aus bestimmten Ländern dupliziert werden. Sollte dies auftreten, melde dich bei uns hier.

Wie bekomme ich meinen Geschäftsnamen bei Kontakten auf WhatsApp anstatt der Nummer angezeigt?

Standard-Accounts der WhatsApp Business Platform (API) zeigen die Geschäftsnummer statt des Namens an. Um deinen Geschäftsnamen Kontakten anzuzeigen, auch wenn sie dein Unternehmen nicht ins Adressbuch aufgenommen haben, benötigst du ein offizielles WhatsApp‑Geschäftskonto.

Offizielle Unternehmenskonten haben einen grünen Haken neben dem Firmennamen; üblicherweise erhalten diesen Status nur große, repräsentative Unternehmen. Mehr dazu, wie du ein Official Business Account beantragst, findest du hier.

Was ist der Meta Product Catalog und wie kann ich ihn nutzen?

Der Meta Product Catalog ist eine Funktion, mit der du einen Produktkatalog erstellen und mit deinen Kunden teilen kannst. Mehr darüber, wie du den Meta Product Catalog in respond.io verwendest, erfährst du hier.

Kann eine Tochtergesellschaft oder eine Agentur ein WhatsApp Business‑Konto im Namen eines anderen Unternehmens registrieren?

Ja, das können sie. Das Meta Business Account und die Geschäftsinformationen, die zur Registrierung des WhatsApp Business‑Kontos verwendet werden, müssen jedoch zu einer juristischen Einheit gehören, die mit den entsprechenden rechtlichen Dokumenten verifiziert werden kann. Mehr zur Meta Business‑Verifizierung findest du hier.

Wie viele Telefonnummern kann ein Unternehmen bei der Anmeldung für ein Konto der WhatsApp Business Platform (API) registrieren und wie lässt sich dieses Limit erhöhen?

Wenn ein Unternehmen sich für ein WhatsApp Business Platform (API)-Konto anmeldet und unbestätigt ist, kann es nur bis zu 2 Telefonnummern registrieren. Verifizierte Unternehmen können mehr Telefonnummern registrieren. Für einen einzelnen Business Manager dürfen sie bis zu 20 Telefonnummern registrieren.

Wenn du bei einer niedrigeren Anzahl, z. B. 5 Telefonnummern, feststeckst und keine weiteren Nummern registrieren kannst, kannst du ein Ticket direkt bei Meta einreichen, um eine Erhöhung des Telefonnummernlimits zu beantragen.

Schritte:

1. Klicke für direkten Support auf diesen Link.

2. Gehe zu Ask a Question > WABiz: Account & WABA > Request type > Increase Phone Number Limits

3. Gib eine Begründung an, warum du das Telefonnummernlimit erhöhen möchtest.

4. Sende deine Anfrage ab.

Wie kann ich meinen WhatsApp‑Gesprächsverbrauch prüfen?

Um deinen WhatsApp-Konversationsverbrauch zu prüfen, folge diesen Schritten:

1. Gehe zu deinem Meta Business Manager.

2. Klicke auf Settings > Business Settings > WhatsApp Accounts

3. Wähle deine WABA und klicke auf Settings > WhatsApp Manager.

4. Unter Account tools klicke auf Insight.

Warum erscheint die Nachricht als nicht unterstützte Nachricht mit dem Fehlercode: 131051?

Ein möglicher Grund ist, dass WhatsApp API-Konten nicht dafür ausgelegt sind, mit anderen WhatsApp API-Konten zu chatten. Dies ist eine Einschränkung von Meta. Beachte, dass der Fehlercode: 131051 für verschiedene Arten von Fehlern in Bezug auf nicht unterstützte Nachrichtentypen verwendet wird. Wenn du unsicher bezüglich dieses Fehlers bist, kannst du unser Support-Team kontaktieren.

Warum erhalte ich beim Versenden von Nachrichten die Fehlermeldung "Undefined: Receiver is incapable of receiving this message"?

Diese Fehlermeldung stammt von Meta. Hier einige von Meta vorgeschlagene Schritte zur Fehlerbehebung:

Stelle sicher, dass der empfangende Kontakt:

• ein aktives WhatsApp-Konto hat.

• die neueste Version von WhatsApp verwendet.

• den neuen Nutzungsbedingungen und der Datenschutzrichtlinie zugestimmt hat.

• nicht auf WhatsApp gesperrt ist oder sich nicht in einem Land befindet, in dem WhatsApp gesperrt ist.

Ich habe die Zugangsdaten für mein Meta Business Manager-Konto verloren. Was soll ich tun?

Um wieder Zugriff auf dein Meta Business Manager-Konto zu erhalten, erfährst du hier, wie du dein Passwort zurücksetzt und deine E-Mail-Adresse oder Telefonnummer wiederherstellst.

Warum wurde mein WhatsApp Business‑Konto deaktiviert?

Dein WhatsApp Business API (WABA)-Konto kann aus verschiedenen Gründen deaktiviert werden. Häufige Gründe sind die Nichteinhaltung von Metas Commerce Policies und die Angabe einer ungültigen Website. Um gegen diese Entscheidung Einspruch zu erheben, solltest du folgende Schritte unternehmen:

Sorge für die Einhaltung von Metas Commerce Policies: Überprüfe und passe deine Geschäftspraktiken an Metas Richtlinien an. Das ist entscheidend für einen erfolgreichen Einspruch.

Stelle sicher, dass du einegültigeWebsite hast: Aktualisiere deine Geschäftsinformationen im Meta Business Manager (MBM), um eine gültige und klare Website anzugeben, die Art und Details deines Unternehmens zeigt.

Bereite einen Einspruch vor: Erkläre im Einspruchsdialog, wie dein Unternehmen WhatsApp für die Kommunikation nutzt. Hebe hervor, dass:

• Nachrichten werden nur an Kunden gesendet, die zugestimmt haben.

• Alle Kommunikationen sind geschäftsbezogen und entsprechen den WhatsApp-Richtlinien.

Erfahre, wie du eine Überprüfung bei Meta anfordern kannst, hier.

Was soll ich tun, um einen Einspruch vorzubereiten, wenn meine WABA deaktiviert ist?

Befolge diese Schritte und überprüfe die wichtigsten Informationen, damit dein Einspruch gut vorbereitet ist. Wenn du über unser Kundensupport-Team Einspruch einlegst, stelle bitte sicher, dass diese Screenshots ebenfalls mitgeteilt werden.

1. Überprüfe die Qualität deines Geschäftskontos: Gehe zu Account overview -> Klicke auf View my accounts

2. Überprüfe Geschäftsdaten: Gehe zu Business portfolio info

3. Rufe deine MBM-ID, WABA-ID und die Bewertung der Telefonnummernqualität ab, um einen Einspruch einzureichen:
- Rufe deine MBM-ID aus deinen Geschäftsinformationen ab.

- Gehe zu WhatsApp accounts und kopiere deine WABA-ID. Wähle das richtige WhatsApp-Konto aus und klicke, um die WABA-ID zu kopieren.

- Scrolle nach unten und öffne deinen WhatsApp Manager, um die Bewertung der Telefonnummernqualität einzusehen.

Warum habe ich beim Senden einer Nachricht den Fehler "Business eligibility payment issue" erhalten?

Dieser Fehler kann auftreten, wenn du kürzlich einen Kanal gelöscht hast und versucht hast, eine WhatsApp‑Nachrichtenvorlage zu senden oder eine neue Konversation mit einer anderen WhatsApp‑Business‑Nummer zu starten. Dies liegt daran, dass die Kreditlinie von der Telefonnummer deines gelöschten Kanals freigegeben und auf deine verbleibenden Telefonnummern umverteilt wird. Dieser Vorgang kann bis zu 5 Minuten dauern. Wir empfehlen, 5 Minuten zu warten, bevor du die Nachricht erneut sendest.

Dieser Fehler tritt nur auf, wenn du mehr als eine Nummer unter demselben Business Manager hast und diese Nummern mit der Plattform verbunden sind.

Kann sich meine WhatsApp API‑Nummer, die mit einem in Business Suite registrierten WhatsApp Business‑Konto (WABA) verbunden ist, direkt mit respond.io verbinden?

Nein, es ist nicht möglich, dass sich deine WhatsApp API-Nummer, die mit einer in Business Suite registrierten WABA verbunden ist, direkt mit respond.io verbindet.

Warum wird das Profilbild meines Kontakts nicht angezeigt?

Aufgrund von Einschränkungen des WhatsApp‑Kanals können wir das Profilbild deines Kontakts nicht anzeigen. WhatsApp stellt keine API zur Verfügung, mit der wir diese Information abrufen könnten.

Was passiert, wenn ich meinen WhatsApp‑Kanal lösche?

Das Löschen eines WhatsApp-Kanals entfernt nicht die zugehörigen Kontakte oder den Chatverlauf.

Der Chatverlauf ist mit deinen Kontakten verknüpft; sofern du einen Kontakt nicht manuell im Kontakte‑Modul löschst, bleiben sowohl der Kontakt als auch dessen Gesprächsverlauf im Arbeitsbereich erhalten.

Wenn du denselben WhatsApp-Channel wieder verbindest und eine Nachricht von derselben Nummer erhältst, wird der Kontakt mit dem bestehenden zusammengeführt.

Warum sehe ich „Meta Error (#131057): Account in maintenance mode“ auf WhatsApp?

Das passiert, wenn dein WhatsApp Business‑Konto vorübergehend im Wartungsmodus ist, meistens während eines Durchsatz‑Upgrades. Es dauert etwa eine Minute, und deine Nummer funktioniert danach automatisch wieder.

Warum sehe ich beim Senden einer Vorlage einen „Media Upload Error“ oder „Media Download Error“?

Diese Fehler treten auf, wenn die an deine Vorlage angehängte Mediendatei nicht den Anforderungen von Meta entspricht. Häufige Ursachen sind:

• Das Dateiformat wird nicht unterstützt.

• Der Dateityp ist falsch.

• Die Mediendatei überschreitet Metas Größenbegrenzungen.

Diese Probleme stammen von Meta und liegen außerhalb der Kontrolle von respond.io. Du kannst dich auch auf Metas Dokumentation zu Fehlercodes beziehen, um Details zu spezifischen Fehlermeldungen zu erhalten.

Warum kann mein Kontakt nicht sehen, auf welche Nachricht ich auf WhatsApp antworte?

Das geschieht, weil WhatsApp-Nachrichten, die älter als 30 Tage sind, von Meta in die Langzeitspeicherung verschoben werden und der Kontext der beantworteten Nachricht nicht mehr verfügbar ist. Infolgedessen erscheint die „Antwort-auf“-Blase nicht bei als Antwort gesendeten Nachrichten auf diese älteren Nachrichten.

Unterstützt die WhatsApp Business Platform (API) Gruppenchats?

Nein, sie unterstützt nicht das Verwalten oder Senden von Nachrichten an Gruppenchats. Meta hat die Weiterentwicklung dieser Funktion eingestellt.