Limits und Regeln der Partner API: Metas Richtlinien, 20 Nachrichten pro Sekunde und die 14-Tage-Regel
Eine über die Partner API von easyCoexistence verbundene Coexistence-Nummer sendet bis zu 20 Nachrichten pro Sekunde, eine von Meta festgelegte Rate, und Meta trennt eine Nummer, deren Telefon rund 14 Tage inaktiv bleibt. Eine Plattform, die die Konten ihrer Kunden verbindet, handelt in deren Auftrag und hält deshalb die Regeln jedes Netzwerks für sie ein: auf WhatsApp Antworten innerhalb des 24-Stunden-Kundenservicefensters, genehmigte Templates außerhalb davon, kein Spam und keine KI-Chatbots für allgemeine Zwecke.
Feste Durchsatzrate, die Meta für eine Nummer festlegt, die sowohl mit der WhatsApp Business App als auch mit der Cloud API genutzt wird.
Standarddurchsatz der Cloud API für eine Nummer, die nur über die API genutzt wird; er kann automatisch auf 1,000 steigen.
Inaktivität des Telefons mit der WhatsApp Business App, nach der Meta die Nummer trennt, Grund PRIMARY_INACTIVITY.
Das Kundenservicefenster, das eine Nachricht des Nutzers öffnet; außerhalb davon darf ein Unternehmen nur genehmigte Templates senden.
Nachrichtenlimit eines neuen Business Portfolios: Personen, die außerhalb des Servicefensters erreicht werden, pro gleitende 24 Stunden.
Welche Regeln hält eine Plattform ein?
Die jedes Netzwerks, für jeden Kunden, den sie verbindet. Die Konten laufen über die offizielle API jedes Netzwerks, und deren Regeln gelten für alles, was Ihre Software darüber sendet und veröffentlicht. Auf WhatsApp trifft die Durchsetzung von Meta das WhatsApp Business Account des Kunden und die App, über die die Nummer verbunden ist. Deshalb beendet ein Verstoß gegen Metas Regeln den API-Schlüssel einer Plattform.
Welche Meta-Regeln gelten auf WhatsApp?
Metas Nachrichtenregeln, eingehalten von der Software, die für das Unternehmen sendet:
- Freitext-Antworten nur innerhalb von 24 Stunden nach der letzten Nachricht der Person; jede neue Nachricht von ihr startet das Fenster neu.
- Außerhalb des Fensters nur von Meta genehmigte Templates.
- Nachrichten nur an Personen, die zugestimmt haben, Nachrichten vom Unternehmen zu erhalten.
- Kein Spam und keine KI-Chatbots für allgemeine Zwecke auf der Nummer.
- Die Reichweite außerhalb des Fensters wird pro Business Portfolio gezählt; ein neues beginnt bei 250 Personen pro gleitende 24 Stunden.
Wie schnell kann eine Coexistence-Nummer senden?
Mit 20 Nachrichten pro Sekunde, einer festen Rate, die Meta festlegt, damit die Nummer mit der WhatsApp Business App kompatibel bleibt. Eine Nummer, die nur über die Cloud API läuft, beginnt bei 80 und kann automatisch auf 1,000 erhöht werden, eine Coexistence-Nummer bleibt jedoch bei 20. Das Nachrichtenlimit des Portfolios gilt zusätzlich und zählt die Personen, die außerhalb des Servicefensters erreicht werden.
Was ist die 14-Tage-Regel?
Meta trennt eine Coexistence-Nummer, wenn das Telefon mit der WhatsApp Business App rund 14 Tage inaktiv war, mit dem Grund PRIMARY_INACTIVITY. easyCoexistence überwacht jede Nummer und sendet an Ihre Event-URL connection.disconnected mit diesem Grund. Die Lösung ist ein neuer Verbindungslink für diesen Kunden: Er durchläuft den Ablauf erneut mit derselben Nummer, und sie kehrt zurück.
Welche anderen Trennungen meldet Meta?
Wenn Meta die Verbindung einer Nummer beendet, enthält connection.disconnected den Ursachencode von Meta, sofern er bekannt ist. Neben PRIMARY_INACTIVITY nennt Meta diese:
ACCOUNT_DISCONNECTED: Durchsetzung durch Meta, oder der Kunde hat sein WhatsApp-Konto gelöscht; ausgelöst durch den Nutzer oder durch das System.CHANGE_NUMBER: Der Kunde hat seine Telefonnummer geändert.BUSINESS_DOWNGRADE: Die Nummer wurde in der WhatsApp-App für Privatnutzer registriert.USER_RE_REGISTERED: Der Kunde hat WhatsApp auf einem neuen Gerät erneut registriert.COMPANION_INACTIVITY: Ein verknüpftes Gerät blieb rund 30 Tage ungenutzt.
Was beendet einen Partner-API-Schlüssel?
Drei Dinge. Sie rotieren ihn, wodurch er sofort durch einen neuen Schlüssel ersetzt wird; Sie widerrufen ihn, wodurch das Konto ohne Schlüssel bleibt; oder easyCoexistence beendet ihn, weil das Konto Metas Regeln missbraucht hat. Ein Schlüssel hat kein eigenes Ablaufdatum, und nach seiner Beendigung liefert jede Anfrage 401 unauthorized.
Welche Limits gelten für Verbindungssitzungen?
Ein Konto kann gleichzeitig 50 offene Verbindungssitzungen halten und stündlich 100 neue erstellen. Meta zählt jede Erstregistrierung gegen ein Limit für die gesamte App, die alle easyCoexistence-Konten teilen; die Obergrenzen verhindern, dass der Massenimport einer Plattform es für alle aufbraucht. Eine Obergrenze antwortet mit 429 cap_reached oder rate_limited.
Welche Regeln setzen die sozialen Netzwerke?
Die jedes Netzwerks, angewendet auf die Konten, die Ihre Kunden verbinden; sie unterscheiden sich in denselben wenigen Punkten:
- Nachrichtenfenster: Instagram- und Facebook-DMs können innerhalb eines Standardfensters beantwortet werden, meist 24 Stunden nach der letzten Nachricht der Person.
- Veröffentlichungsgrenzen und API-Kontingente pro Konto, die je nach Netzwerk variieren.
- Token-Laufzeiten: Manche Netzwerke stellen Token aus, die eine Stunde oder einen Tag gelten; easyCoexistence erneuert sie.
- Einwilligung: Der Kontoinhaber kann den Zugriff jederzeit in den Einstellungen des Netzwerks widerrufen; dies wird als channel.disconnected gemeldet.
- Funktionen: TikTok, YouTube und LinkedIn bieten hier keine DMs an, und easyCoexistence empfängt von YouTube und LinkedIn keine Kommentar-Events.
Häufige Fehler
- Stoßweises Senden von einer Coexistence-Nummer. Meta begrenzt sie auf 20 Nachrichten pro Sekunde; stellen Sie die Sendungen jeder Nummer daher mit dieser Rate in eine Warteschlange, statt sie alle gleichzeitig abzufeuern.
- Darauf zählen, dass die WhatsApp Business App Templates sendet. In Coexistence sendet nur die API Templates, daher muss alles außerhalb des 24-Stunden-Fensters über Ihr Backend laufen.
- Ein Access-Token eines sozialen Netzwerks für später speichern. Manche gelten eine Stunde oder einen Tag, daher sollten Zugangsdaten bei jedem Jobstart frisch von easyCoexistence abgerufen werden.
easyCoexistence verwaltet die WhatsApp-Nummern Ihrer Kunden sowie ihre Instagram-, Facebook-, TikTok-, YouTube- und LinkedIn-Konten und weitere Kanäle, verbunden über die offizielle API jedes Netzwerks, und informiert Ihre Plattform mit einem signierten Event, wenn eine Verbindung abbricht, mit dem Grund, sofern bekannt. Von US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit weiteren Verbindungen, mit einer kostenlosen Testphase von 3 Tagen.
Häufig gestellte Fragen
Was bedeutet COMPANION_INACTIVITY?
Ein verknüpftes Gerät blieb rund 30 Tage ungenutzt, ein Grund, den Meta für das Trennen einer Nummer angibt.
Was passiert mit meinen Kunden, wenn Ihre Plattform Metas Regeln verletzt?
Die Durchsetzung von Meta trifft deren WhatsApp-Business-Konten und die App, über die ihre Nummern verbunden sind, und easyCoexistence beendet den API-Schlüssel eines Kontos, das die Regeln missbraucht.
Gilt die 14-Tage-Regel auch für Social-Media-Konten?
Nein. Sie ist Metas Regel für Nummern, die zwischen der WhatsApp Business App und der API geteilt werden. Ein Social-Media-Konto fällt weg, wenn das Netzwerk seinen Token ablehnt oder der Inhaber den Zugriff widerruft; dies wird als channel.disconnected gemeldet.
Unterscheiden sich die Limits je nach Netzwerk?
Ja. Jedes Netzwerk legt eigene Nachrichtenfenster, Veröffentlichungsgrenzen, API-Kontingente und Token-Laufzeiten fest, und sie gelten für die Konten, die Sie verbinden, genauso wie für Ihre eigenen.
Weiterlesen
Verbinden Sie Ihren ersten Kanal in zwei Minuten.
Keine Plattform-Prüfungen, auf die Sie warten müssen. Verbinden Sie WhatsApp, Instagram, TikTok oder einen anderen Kanal, bitten Sie dann Ihre KI, zu posten, zu antworten oder Berichte zu erstellen, und sehen Sie ihr bei der Arbeit zu.
- 3 Tage kostenlos
- Jederzeit kündbar
- Nur offizielle APIs
- Überwacht rund um die Uhr (24/7)
Verifiziert am