WhatsApp-API-Rate-Limits-Diagramm — drei Limit-Systeme: Durchsatz pro Sekunde, tägliches Messaging-Tier, Pro-Empfänger-Frequenz-Cap — mit Quality-Rating-Feedback-Schleife
In diesem Artikel: Die drei Rate-Limit-Systeme · Messaging-Tier-Tabelle · Tier-Aufstiegsregeln · Quality Rating (GREEN/YELLOW/RED) · Pro-Empfänger-Frequenz-Cap · Genaue Fehlercodes und Antworten · Was niemals erneut zu versuchen ist · Verhalten bei Konto-Pausierung · Produktions-Retry-Code · Strategie zum Aufwärmen der Nummer · FAQ

Die drei Rate-Limit-Systeme — und warum sie unterschiedlich sind

Das Wichtigste, das man über WhatsApp-Rate-Limits verstehen muss: Es gibt drei vollständig getrennte Systeme, die jeweils unabhängig von Metas Infrastruktur gewartet werden. Eines zu erreichen bedeutet nicht, dass Sie die anderen erreicht haben. Sie falsch zu handhaben — insbesondere Nachrichten erneut zu versuchen, die niemals erneut versucht werden sollten — verschlechtert aktiv Ihr Quality Rating und beschleunigt das Problem.

01
Durchsatz pro Sekunde
80 Nachrichten/Sekunde pro Telefonnummer. API-Infrastruktur-Limit. Gibt HTTP 429 sofort zurück. Mit exponentiellem Backoff erneut versuchen.
HTTP 429
02
Tägliches Messaging-Tier
1K / 10K / 100K / Unbegrenzt einzigartige geschäftlich initiierte Kontakte pro 24h. Reset um Mitternacht UTC. Nicht am selben Tag erneut versuchen.
Fehler 131048
03
Pro-Empfänger-Frequenz-Cap
Meta blockiert stillschweigend Marketing-Nachrichten an Empfänger, die in den letzten 24–48h zu viele von einem beliebigen Unternehmen erhalten haben. Niemals erneut versuchen.
Fehler 131049

Rate-Limit 1: API-Durchsatz pro Sekunde

Die Cloud API unterstützt standardmäßig 80 Nachrichten pro Sekunde pro Telefonnummer. Das ist ein reines API-Infrastruktur-Limit — auf Millisekunden-Ebene erzwungen. Ein Überschreiten gibt sofort HTTP 429 mit einem Standard-Rate-Limit-Fehler zurück. Dieses Limit ist skalierbar: Kontaktieren Sie Meta, um es für Sender mit hohem Volumen auf 1.000 Nachrichten pro Sekunde zu erhöhen.

Die Fehlerantwort, wenn Sie dieses Limit erreichen:

HTTP 429 Response
per-second-limit.json
HTTP/1.1 429 Too Many Requests Retry-After: 1 Content-Type: application/json { "error": { "message": "(#613) Calls to this api have exceeded the rate limit.", "type": "OAuthException", "code": 613, "fbtrace_id": "AbCdEfGh..." } } // Erneut versuchen: JA — verwenden Sie exponentielles Backoff, beginnend bei 1 Sekunde // Der Retry-After-Header ist eine Empfehlung — respektieren Sie ihn, aber fügen Sie auch Jitter hinzu

Vorbeugen ist besser als Heilen. Bei 80 msg/s dauert das Senden von 10.000 Nachrichten 125 Sekunden. Für Massenoperationen fügen Sie eine Verzögerung von 15–20 ms zwischen Sendungen hinzu, um komfortabel unter 50–60 msg/s zu bleiben — sicher unter dem Limit bei Beibehaltung einer Zustellerfolgsrate von 99 %+.

Rate-Limit 2: Limits des täglichen Messaging-Tiers

Dies ist das Limit, das die meisten Leute meinen, wenn sie von „WhatsApp-Rate-Limits" sprechen. Das Messaging-Tier steuert, an wie viele einzigartige Kunden Ihre Telefonnummer geschäftlich initiierte Nachrichten in einem rollierenden 24-Stunden-Fenster senden kann. Das Tier ist pro Telefonnummer, nicht pro Konto.

Session-Nachrichten sind nicht tier-limitiert. Das tägliche Messaging-Tier zählt nur geschäftlich initiierte Nachrichten — Vorlagen-Nachrichten, die gesendet werden, um neue Konversationen zu starten oder an Kunden außerhalb des 24-Stunden-Service-Fensters. Wenn ein Kunde Ihnen zuerst eine Nachricht sendet, sind alle Antworten innerhalb des resultierenden 24-Stunden-Service-Fensters Session-Nachrichten — sie zählen NICHT zu Ihrem täglichen Tier. Sie können auf jedem Tier unbegrenzt Session-Nachrichten senden.
Tier Einzigartige Kontakte / 24h Anfangsstatus Upgrade-Bedingung Downgrade-Bedingung
Tier 1 1.000 einzigartige Kontakte Alle neuen Nummern 7 Tage konstante Nutzung bei 80 %+ Kapazität, GREEN/YELLOW-Qualität Quality Rating fällt auf RED
Tier 2 10.000 einzigartige Kontakte Auto-Upgrade 7 Tage bei 80 %+ von 10K/Tag, GREEN/YELLOW-Qualität Quality Rating RED → fällt auf Tier 1
Tier 3 100.000 einzigartige Kontakte Auto-Upgrade 7 Tage bei 80 %+ von 100K/Tag, GREEN/YELLOW-Qualität Quality Rating RED → fällt auf Tier 2
Tier 4 Unbegrenzt Auto-Upgrade Erreicht nach Tier-3-Progression Quality Rating RED → fällt auf Tier 3

Die Fehlerantwort, wenn Sie Ihr tägliches Tier überschreiten:

HTTP 200 mit Fehler im Body (Status: failed)
error-131048.json
{ "messaging_product": "whatsapp", "contacts": [{ "input": "+15550001234", "wa_id": "15550001234" }], "messages": [{ "id": "wamid.HBgL..." }] } // Der initiale Versand gibt 200 zurück. Der Fehlschlag kommt später als Status-Webhook-Ereignis: { "statuses": [{ "id": "wamid.HBgL...", "status": "failed", "errors": [{ "code": 131048, "title": "Message failed to send because too many messages were sent from the sender phone number.", "details": "Messages to this phone number are being sent too quickly." }] }] } // KRITISCH: NICHT bei 131048 erneut versuchen. Auf Mitternachts-UTC-Reset warten. // Erneutes Versuchen verschwendet API-Aufrufe und umgeht das Tier-Limit nicht.

Tier-Progression: wie man von 1K zu Unbegrenzt kommt

Metas Tier-Beförderung ist automatisch — Sie können sie nicht direkt anfordern. Sie erfolgt basierend auf drei Signalen, die über ein rollierendes 7-Tage-Fenster gemessen werden:

  1. Volumenschwelle: Sie müssen konstant 80 %+ des täglichen Limits Ihres aktuellen Tiers erreichen. Eine Nummer auf Tier 1, die nur 200 Nachrichten/Tag sendet, wird nie hochgestuft — selbst bei perfektem Quality Rating.
  2. Quality Rating: Muss GREEN oder YELLOW sein. Ein RED-Rating blockiert die Beförderung vollständig und löst eine sofortige Herabstufung aus.
  3. Zeit: Meta evaluiert nach 7 aufeinanderfolgenden Tagen, an denen beide Kriterien erfüllt sind. Die Beförderung ist nicht sofort.
Herabstufung ist sofort, Beförderung nicht: Ein Quality-Rating-Sturz auf RED versetzt Sie sofort ein Tier nach unten — Sie wachen am nächsten Tag mit einem niedrigeren Limit auf. Sich wieder hochzuarbeiten erfordert 7 Tage sauberen Betriebs auf dem neuen niedrigeren Tier. Diese Asymmetrie bedeutet, dass eine einzige schlechte Broadcast-Kampagne Ihren Tier-Aufstieg um Wochen zurückwerfen kann. Schützen Sie Ihr Quality Rating so aggressiv, wie Sie Ihren Absender-Ruf schützen.

Die Quality-Rating-Feedback-Schleife

Das Quality Rating (GREEN / YELLOW / RED) ist die wichtigste Zahl für die Gesundheit Ihrer WhatsApp-API. Es wird von Meta über ein rollierendes 7-Tage-Fenster basierend auf Signalen von Nachrichtenempfängern berechnet — speziell: Blockierungen, Spam-Meldungen und negatives Feedback relativ zu Ihrem Sendevolumen.

GREEN
Gesund — berechtigt zum Tier-Upgrade
Niedrige Blockierungs- und Spam-Melderate im Verhältnis zum Sendevolumen. Empfänger interagieren positiv — antworten, setzen Konversationen fort. Nach 7 Tagen bei 80 %+ Kapazität für automatisches Tier-Upgrade berechtigt. Das ist der Zielzustand für jeden Produktionssender.
YELLOW
Warnung — Tier-Upgrade pausiert
Moderate Blockierungs- oder Spam-Melderate. Sie können noch bis zur Grenze Ihres aktuellen Tiers senden — keine sofortige Herabstufung. Aber das Tier-Upgrade ist pausiert. Meta beobachtet 7 Tage lang: Wenn sich die Qualität auf GREEN verbessert, bleiben Sie auf dem aktuellen Tier. Verschlechtert sie sich auf RED, erfolgt eine sofortige Herabstufung.
RED
Kritisch — sofortige Herabstufung
Hohe Blockierungs- oder Spam-Melderate. Sofort: Sie werden ein Tier nach unten verschoben. Anhaltendes RED für 7+ Tage riskiert, dass die Telefonnummer markiert oder vollständig deaktiviert wird. Das ist der kaskadierende Fehlerzustand — eine schlechte Kampagne erzeugt RED-Rating → Herabstufung → die nächste Kampagne hat weniger Kapazität → mehr Druck, am Limit zu senden → mehr Blockierungen.

Das Quality Rating wird in der Cloud API nicht direkt offengelegt — Sie müssen es im Meta Business Manager (WhatsApp Manager → Phone Numbers → Spalte Quality Rating) prüfen oder das phone_number_quality_update-Webhook-Feld abonnieren. Abonnieren Sie dieses Feld und richten Sie Alerts ein, damit Sie sofort wissen, wenn sich Ihre Qualität verschlechtert.

Rate-Limit 3: Pro-Empfänger-Frequenz-Cap (den niemand erklärt)

Dies ist das Rate-Limit, das die meisten Entwickler verwirrt, weil es vollständig vom Tier Ihres Kontos getrennt ist, global über alle Unternehmen hinweg arbeitet und stillschweigend mit einer irreführenden Fehlermeldung fehlschlägt.

Metas Frequency-Capping begrenzt, wie viele Marketing-Nachrichten ein bestimmter WhatsApp-Nutzer von irgendeinem Unternehmen in einem definierten Zeitfenster (24–48 Stunden) erhalten kann. Das ist Meta, das Nutzer vor Marketing-Nachrichten-Überlastung über die gesamte Plattform schützt — nicht nur Ihre Nachrichten. Wenn ein Nutzer heute Marketing-Vorlagen-Nachrichten von 5 anderen Unternehmen erhalten hat, kann Ihre völlig legitime Marketing-Nachricht an diesen Nutzer stillschweigend blockiert werden.

Der Fehler, den Sie erhalten:

Status-Webhook — Fehler 131049
frequency-cap-error.json
{ "statuses": [{ "id": "wamid.HBgL...", "status": "failed", "errors": [{ "code": 131049, "title": "This message was not delivered to maintain a healthy ecosystem.", "details": "Unhealthy system activity" }] }] } // Das ist Pro-Empfänger-Frequency-Capping — nicht die Schuld Ihres Kontos // Betrifft NUR MARKETING-Vorlagen // UTILITY- und AUTHENTICATION-Vorlagen sind NICHT pro Empfänger frequency-cappt // NICHT erneut versuchen — der Cap ist systemweit, nicht pro Sender // Fehlgeschlagene Kontakte loggen, 48h lang nicht erneut versuchen

Wichtige Fakten zum Pro-Empfänger-Frequency-Capping:

  • Nur Marketing-Vorlagen. Utility-Vorlagen (Bestellbestätigungen, Versand-Updates, Terminerinnerungen) und Authentifizierungs-Vorlagen (OTPs) unterliegen NICHT dem Pro-Empfänger-Frequency-Capping. Wenn Ihre „Marketing"-Kampagne legitim als Utility eingestuft werden kann, klassifizieren Sie die Vorlage neu.
  • Der Cap ist global, nicht pro Sender. Sie haben keine Sicht darauf, wie viele Marketing-Nachrichten der Empfänger von anderen Unternehmen erhalten hat. Sie können nicht vorhersagen, welche Sendungen gecappt werden.
  • Eine erwartete Fehlerrate von 10–40 % bei Marketing-Kampagnen an hochaktive WhatsApp-Nutzer ist normal. Das ist kein Problem mit Ihrem Konto — es ist die Plattform, die Nutzer schützt. Planen Sie es ein.
  • Niemals 131049-Fehler erneut versuchen. Der Empfänger ist 24–48 Stunden lang frequency-cappt. Erneutes Versuchen verschwendet Sendungen, verbrennt Ihr tägliches Tier-Kontingent und schadet potenziell Ihrem Quality Rating.

Vollständige Fehlercode-Referenz

HTTP 429
Durchsatz-pro-Sekunde-Limit überschritten
Zu viele API-Aufrufe in zu kurzer Zeit. Sofort mit Retry-After-Header zurückgegeben. Ihre Senderate hat 80 msg/s (oder Ihr benutzerdefiniertes Limit) überschritten. Das ist eine Blockierung auf Infrastruktur-Ebene — die Nachricht wurde nie in die Warteschlange gestellt.
✓ Mit exponentiellem Backoff + Jitter erneut versuchen
131048
Tägliches Messaging-Tier-Limit überschritten
Ihre Telefonnummer hat ihr 24-Stunden-Limit für einzigartige Kontakte für das aktuelle Tier erreicht (1K, 10K oder 100K). Die Sendung scheint zunächst erfolgreich (gibt 200 zurück), schlägt aber asynchron fehl — Sie erhalten diesen Code in einem Status-Webhook-Ereignis. Die Nachricht wurde nicht zugestellt.
⏳ Heute nicht erneut versuchen — nach Mitternachts-UTC-Reset planen
131049
Pro-Empfänger-Frequenz-Cap — „Unhealthy system activity"
Der spezifische Empfänger hat in den letzten 24–48 Stunden zu viele Marketing-Nachrichten von allen Unternehmen erhalten. Meta hat die Zustellung Ihrer Marketing-Vorlage blockiert, um diesen Nutzer zu schützen. Gilt nur für Vorlagen der Kategorie Marketing. Utility- und Authentifizierungs-Vorlagen sind nicht betroffen.
✗ Niemals erneut versuchen — Empfänger ist global für 24–48h gecappt
131016
Dienst vorübergehend nicht verfügbar
Vorübergehender Meta-Infrastruktur-Fehler. Kein Rate-Limit — ein serverseitiger Ausfall. Die Nachricht kann oder kann nicht in die Warteschlange gestellt worden sein, bevor der Fehler auftrat. Sicher erneut versuchbar nach 30–60 Sekunden. Prüfen Sie Meta Status auf laufende Vorfälle.
✓ Nach 30–60s erneut versuchen (max. 3 Versuche)
131031
Geschäftskonto gesperrt
Ihr WhatsApp Business Account wurde aufgrund verdächtiger Aktivität oder einer Richtlinienverletzung vorübergehend gesperrt. Alle Sendungen schlagen sofort fehl. Prüfen Sie den Meta Business Manager auf Verletzungsdetails. Versuchen Sie nicht, dies zu umgehen — beheben Sie die Verletzung direkt mit dem Meta-Support.
✗ Nicht erneut versuchen — Verletzung im Meta Business Manager beheben

Was niemals erneut zu versuchen ist — die Regel, die Ihr Quality Rating rettet

Der schädlichste Fehler bei der WhatsApp-API-Fehlerbehandlung: das erneute Versuchen von 131048- und 131049-Fehlern. Beide sind asynchrone Fehlschläge — die API gab 200 zurück, Sie dachten, die Nachricht wurde gesendet, dann erhalten Sie den Fehler später in einem Status-Webhook-Ereignis. Viele Entwickler sehen den Fehlschlag und versuchen es sofort erneut. Das ist falsch, und hier ist der Grund:

  • 131048 (Tier-Limit): Das Fenster setzt sich erst um Mitternacht UTC zurück. Erneutes Versuchen bedeutet, dass Sie zusätzliche Nachrichten von Ihrem täglichen Kontingent verbrennen, erneut scheitern und mehr Kontingent verbrennen. Sie riskieren auch, demselben Kunden eine doppelte Nachricht zu senden, wenn sich das Fenster zurücksetzt. Loggen Sie den Fehler mit der geplanten Retry-Zeit (Mitternacht UTC) und gehen Sie weiter.
  • 131049 (Frequenz-Cap): Der Empfänger ist systemweit gecappt, nicht von Ihnen. Erneutes Versuchen bewirkt nichts außer: (a) Verbrauch Ihres täglichen Tier-Kontingents, (b) Risiko, ein „failed"-Zustellstatus-Signal zu erzeugen, das Ihr Quality Rating marginal beeinflussen könnte, wenn es als Spam-Versuch interpretiert wird, (c) potenzielle Verärgerung des Empfängers, wenn der Cap aufgehoben wird und er Duplikate erhält. Loggen und 48 Stunden lang überspringen.
Der Retry-Entscheidungsbaum: HTTP 429 → mit Backoff erneut versuchen. Fehler 131048 im Status-Webhook → loggen, nach Mitternacht UTC planen. Fehler 131049 im Status-Webhook → loggen, 48h überspringen. Fehler 131016 → einmal nach 30–60s erneut versuchen. Fehler 131031 → alle Sendungen stoppen, Konto reparieren. Jeder andere 5xx → bis zu 3 Mal mit exponentiellem Backoff erneut versuchen.

Konto-Pausierung vs. Beschränkung auf Nummern-Ebene

Es gibt zwei verschiedene Kontostatus, die aussehen wie „mein Konto funktioniert nicht mehr", aber unterschiedliche Ursachen und Lösungen haben:

Telefonnummer-Beschränkung — die Messaging-Funktion der spezifischen Telefonnummer ist begrenzt oder pausiert. Das passiert, wenn das Quality Rating für 7+ Tage RED bleibt oder wenn die Nummer eine spezifische Richtlinienverletzung erhält. Andere Nummern in Ihrem WABA funktionieren weiter. Prüfen Sie den Status der Nummer im WhatsApp Manager → Phone Numbers. Das Statusfeld zeigt „Connected", „Offline", „Flagged" oder „Restricted".

WABA-Sperrung — das gesamte WhatsApp Business Account ist gesperrt. Alle Telefonnummern unter dem WABA stoppen das Senden und Empfangen. Das passiert bei schweren Richtlinienverletzungen oder bei Betrugserkennung auf Kontoebene. Sie erhalten ein account_update-Webhook-Ereignis mit event: ACCOUNT_RESTRICTION oder event: ACCOUNT_VIOLATION.

Für Agenturen: Deshalb ist ein WABA pro Kunde obligatorisch. Eine Sperrung des WABA eines Kunden hat null Auswirkungen auf die WABAs anderer Kunden.

Produktions-Retry-Code: alle Rate-Limit-Typen korrekt handhaben

Node.js — produktionstaugliches Rate-Limit-bewusstes Senden
rateLimitAwareSend.js
const { sendWhatsApp } = require('./whatsapp'); const { scheduleRetry } = require('./scheduler'); const { logFailure } = require('./logger'); // Fehlercodes, die NIEMALS sofort erneut versucht werden sollten const NO_RETRY_CODES = new Set([131049, 131031]); // Freq-Cap, Konto-Sperre const RETRY_NEXT_DAY = new Set([131048]); // Tier-Limit const RETRY_WITH_BACKOFF = new Set([131016]); // vorübergehender Fehler async function sleep(ms) { return new Promise(r => setTimeout(r, ms)); } // Behandelt Pro-Sekunde-429s mit exponentiellem Backoff async function sendWithThroughputRetry(to, body, attempt = 0) { try { return await sendWhatsApp(to, body); } catch (err) { if (err.status !== 429 || attempt >= 5) throw err; // Exponentielles Backoff mit Jitter für das Pro-Sekunde-Durchsatz-Limit const delay = Math.min( 1000 * 2 ** attempt + Math.random() * 500, 60000 ); console.warn(`429 — waiting ${Math.round(delay)}ms (attempt ${attempt + 1}/5)`); await sleep(delay); return sendWithThroughputRetry(to, body, attempt + 1); } } // Wird von Ihrem Status-Webhook-Handler aufgerufen, wenn eine Nachricht asynchron fehlschlägt async function handleFailedStatus(failedStatus) { const errorCode = failedStatus.errors?.[0]?.code; const recipient = failedStatus.recipient_id; const messageId = failedStatus.id; if (NO_RETRY_CODES.has(errorCode)) { // 131049: Frequency-Cap — 48h überspringen. 131031: Konto-Sperre — manuell beheben. await logFailure({ messageId, recipient, errorCode, action: 'no_retry' }); return; } if (RETRY_NEXT_DAY.has(errorCode)) { // 131048: tägliches Tier-Limit — Retry nach Mitternacht UTC planen const midnightUTC = new Date(); midnightUTC.setUTCHours(0, 5, 0, 0); // 00:05 UTC am nächsten Tag — 5min Puffer midnightUTC.setUTCDate(midnightUTC.getUTCDate() + 1); await scheduleRetry({ messageId, recipient, retryAt: midnightUTC }); await logFailure({ messageId, recipient, errorCode, action: 'scheduled_retry', retryAt: midnightUTC }); return; } if (RETRY_WITH_BACKOFF.has(errorCode)) { // 131016: vorübergehender Fehler — einmal nach 60s erneut versuchen await scheduleRetry({ messageId, recipient, retryAt: new Date(Date.now() + 60000) }); return; } // Unbekannter Fehlercode — loggen und für manuelle Prüfung alarmieren await logFailure({ messageId, recipient, errorCode, action: 'manual_review' }); } // Massenversender mit eingebautem Rate-Limiting async function bulkSendThrottled(contacts, message, delayMs = 20) { const results = { sent: 0, failed: [] }; for (const contact of contacts) { try { await sendWithThroughputRetry(contact.phone, message); results.sent++; } catch (err) { results.failed.push({ ...contact, error: err.message }); } await sleep(delayMs); // 20ms = ~50 msg/s — sicher unter dem 80-msg/s-Limit } return results; } module.exports = { sendWithThroughputRetry, handleFailedStatus, bulkSendThrottled };

Nummern-Aufwärmen: der richtige Weg zum Tier 4

Eine neue WhatsApp-Business-Nummer startet auf Tier 1 (1.000 Kontakte/Tag). Sofort zu großen Broadcast-Kampagnen zu springen ist der schnellste Weg, Blockierungen und Spam-Meldungen zu sammeln und Ihr Quality Rating zu zerstören, bevor Sie irgendein Vertrauenssignal aufgebaut haben. Der richtige Ansatz: schrittweise über 2–4 Wochen aufwärmen.

Die Aufwärm-Strategie, die die Geschwindigkeit der Tier-Progression maximiert und gleichzeitig das Quality Rating schützt:

  • Woche 1: Senden Sie nur an Ihre engagiertesten Kontakte — Kunden, die Ihnen zuvor geantwortet haben, kürzlich gekauft haben oder sich explizit über einen Prozess mit Friktion opt-in entschieden haben. Zielen Sie auf 500–800 Kontakte/Tag (80 % von Tier 1). Überwachen Sie das Quality Rating täglich.
  • Woche 2–3: Wenn die Qualität GREEN ist, sollten Sie automatisch auf Tier 2 hochgestuft werden. Erhöhen Sie auf 7.000–8.000 Kontakte/Tag (80 % von Tier 2). Senden Sie weiterhin nur an engagierte Segmente. Unterdrücken Sie nicht reagierende Kontakte, die seit 90+ Tagen nicht interagiert haben.
  • Woche 4+: Setzen Sie das Muster fort. Jedes Tier erfordert 7 Tage 80 %+ Nutzung mit GREEN/YELLOW-Rating. Gesamtzeit von Tier 1 zu Tier 4: mindestens 3–4 Wochen konstantes Volumen mit hoher Qualität.
  • Überwachen Sie immer die 131049-Fehlerraten. Wenn Sie 131049-Fehler (Frequenz-Cap) sehen, die 20–25 % Ihrer Sendungen überschreiten, zielen Sie auf zu viele hochgesättigte Nutzer. Verbessern Sie die Qualität Ihrer Liste oder reduzieren Sie die Frequenz, bevor Sie weiter skalieren.
Die Eingangs-Ausnahme: Eingehende Nachrichten (Kunden, die Sie zuerst kontaktieren) und Session-Antworten zählen nicht zu Ihrem täglichen Tier. Wenn Ihr Kundenservice-Betrieb hauptsächlich eingehend ist — Kunden melden sich, Ihr Team antwortet innerhalb des 24-Stunden-Fensters — können Sie täglich Tausende von Konversationen auf Tier 1 ohne jegliche Rate-Limit-Sorge bewältigen. Rate-Limits gelten nur für geschäftlich initiierte ausgehende Nachrichten. Empfangen Sie so viele eingehende Nachrichten, wie Sie möchten, bei SocialHook für pauschal 50 $/Monat — kein Rate-Limit auf der Empfangsseite.
FAQ

Häufige Fragen

Was sind die drei Arten von WhatsApp-API-Rate-Limits?
(1) Durchsatz pro Sekunde: 80 Nachrichten/Sekunde pro Telefonnummer — gibt HTTP 429 sofort zurück. Mit exponentiellem Backoff erneut versuchen. (2) Tägliches Messaging-Tier: begrenzt einzigartige geschäftlich initiierte Kontakte pro 24 Stunden (1K/10K/100K/Unbegrenzt) — gibt Fehler 131048 asynchron per Webhook zurück. NICHT vor Mitternacht UTC erneut versuchen. (3) Pro-Empfänger-Frequenz-Cap: Meta blockiert stillschweigend Marketing-Nachrichten an Nutzer, die in 24–48h zu viele von allen Unternehmen erhalten haben — gibt Fehler 131049 zurück. Niemals erneut versuchen.
Was bedeutet Fehler 131048 und sollte ich ihn erneut versuchen?
Fehler 131048 bedeutet „Message failed to send because too many messages were sent from the sender phone number" — Sie haben Ihr tägliches Messaging-Tier-Limit überschritten. Nicht am selben Tag erneut versuchen. Das Tier-Fenster setzt sich um Mitternacht UTC zurück. Planen Sie einen Retry für 00:05 UTC am folgenden Tag. Sofortiges erneutes Versuchen verschwendet Ihr verbleibendes Kontingent und umgeht das Limit nicht.
Was bedeutet Fehler 131049 und warum ist meine Fehlerrate hoch?
Fehler 131049 („Unhealthy system activity") ist Metas Pro-Empfänger-Frequenz-Cap. Der spezifische Empfänger hat in den letzten 24–48 Stunden zu viele Marketing-Nachrichten von allen Unternehmen erhalten. Eine 131049-Fehlerrate von 10–40 % bei Marketing-Kampagnen an aktive WhatsApp-Nutzer ist völlig normal — kein Problem mit Ihrem Konto. Das betrifft nur Vorlagen der Kategorie Marketing. Utility- und Authentifizierungs-Vorlagen sind nicht pro Empfänger frequency-cappt. Niemals 131049-Fehler erneut versuchen.
Wie steige ich in meinem WhatsApp-Messaging-Tier auf?
Tier-Upgrades sind automatisch — Sie können sie nicht anfordern. Sie müssen: (1) konstant 80 %+ des täglichen Limits Ihres aktuellen Tiers für 7 aufeinanderfolgende Tage erreichen, und (2) während dieser Zeit ein GREEN- oder YELLOW-Quality-Rating beibehalten. Wenn Ihre Qualität nach 7 Tagen bei 80 %+ Kapazität GREEN ist, befördert Meta Sie automatisch. YELLOW pausiert die Beförderung. RED stuft Sie sofort ein Tier herab. Bauen Sie das Tier auf, indem Sie sich zuerst auf engagierte Zielgruppen konzentrieren, um das Quality Rating zu schützen.
Zählen Session-Nachrichten (Antworten auf vom Kunden initiierte Konversationen) zum täglichen Tier?
Nein. Das tägliche Messaging-Tier zählt nur geschäftlich initiierte Nachrichten — Vorlagen-Nachrichten, die gesendet werden, um neue Konversationen zu starten, oder an Kunden außerhalb ihres 24-Stunden-Service-Fensters. Wenn ein Kunde Ihnen zuerst schreibt und Sie innerhalb des resultierenden 24-Stunden-Fensters antworten, sind das Session-Nachrichten. Sie zählen nicht zu Ihrem Tier-Limit und haben auf keinem Tier-Level eine Tagesobergrenze.
Was passiert mit meinem Quality Rating, wenn ich Blockierungen und Spam-Meldungen erhalte?
Blockierungen und Spam-Meldungen reduzieren Ihr Quality Rating direkt über ein rollierendes 7-Tage-Fenster. YELLOW-Rating pausiert die Tier-Upgrade-Berechtigung. RED-Rating stuft Sie sofort ein Tier herab (z. B. Tier 2 → Tier 1) und blockiert weitere Upgrades, bis Sie zu GREEN zurückkehren. Anhaltendes RED für 7+ Tage kann dazu führen, dass die Telefonnummer markiert oder vorübergehend deaktiviert wird. Schützen Sie Ihr Rating, indem Sie nur an opt-in-Kontakte senden, die Ihre Nachrichten erwarten, Nicht-Engagierte unterdrücken und Nachrichten als Utility/Authentifizierung statt Marketing klassifizieren, wo es legitim ist.
Tutorial
Nachrichten über Cloud API senden
Node.js-, Python- und PHP-Code für jeden Nachrichtentyp — einschließlich Massenversender mit Rate-Limit-konformer Verzögerung.
Feature
WhatsApp Eingangs-Webhooks
Keine Rate-Limits beim Empfang. Jede eingehende Nachricht als sauberes JSON geliefert. 50 $/Monat pauschal.
Agentur-Leitfaden
Mehrere Kundennummern verwalten
Warum getrennte WABAs pro Kunde Rate-Limits und Quality Ratings über Ihr gesamtes Kundenportfolio isolieren.

Rate-Limits gelten beim Senden.
Empfangen ist unbegrenzt.

Jede eingehende Nachricht — unabhängig vom Volumen — wird als sauberes JSON an Ihren Webhook-Endpunkt geliefert. Kein Pro-Sekunde-Limit, kein tägliches Tier, kein Frequenz-Cap beim Empfang. Verbinden Sie Ihre WhatsApp-Nummer mit SocialHook und bewältigen Sie so viele eingehende Konversationen, wie Ihre Kunden generieren.

WhatsApp kostenlos verbinden → Dokumentation lesen
Keine Kreditkarte erforderlich · 50 $/Monat nach der Testphase · Unbegrenztes Eingangs-Volumen