Ratenlimits

Warum verbundene Kanäle Ratenlimits haben, welche Lese- und Sendelimits pro Anbieter gelten und was passiert, wenn ein Limit erreicht wird.

Wenn Sie einen Kanal verbinden (LinkedIn, WhatsApp, E-Mail und so weiter), kommuniziert Customermates über Unipile mit diesem Anbieter. Jeder Anbieter erzwingt eigene Anfragelimits, und ein Überschreiten kann das zugrunde liegende Konto drosseln oder sperren. Um innerhalb sicherer Grenzen zu bleiben, wendet Customermates pro Kanal ein konservatives Anfragebudget an und pausiert, bevor ein Anbieter eingreifen würde.

Eine pausierte Synchronisierung ist erwartetes Verhalten: Sie hält das verbundene Konto innerhalb der Anbieterlimits und setzt von selbst fort.

Wie funktionieren die Limits?

Die Limits werden im Unipile-Dashboard konfiguriert und von Unipile erzwungen. Sie gelten pro verbundenem Konto und gleichzeitig auf drei Ebenen:

  • Pro Endpunkt: eine Obergrenze für jede einzelne Operation (Chats auflisten, Nachrichten lesen) über ein gleitendes Minuten- und Tagesfenster. Das sind die Leselimits unten.
  • Pro sensibler Methode: eine strengere Grenze für riskantere Operationen (Profilabrufe, Nachricht oder Kontaktanfrage senden). Das sind die sensiblen Limits unten.
  • Pro Konto: eine Gesamtgrenze über alle Aufrufe des Kontos.

Ist ein Fenster voll, werden weitere Aufrufe abgelehnt, bis es sich erneuert.

Welche Leselimits gelten pro Anbieter?

Lesevorgänge synchronisieren den Verlauf. Sie sind höher angesetzt als Schreibvorgänge, da Lesen selten eine Anbieter-Sperre auslöst.

AnbieterLesen / MinuteLesen / Tag
LinkedIn20300
WhatsApp30510
Instagram50510
Telegram50keine
Gmail / Google100keine
Outlook100keine
IMAP100keine

LinkedIn bleibt am konservativsten, da die Erkennung automatisierter Aktivität dort am strengsten ist. Einige Werte richten sich nach den Obergrenzen des Anbieters: soziale Kanäle begrenzen das Minuten-Leselimit auf 50, E-Mail-Kanäle auf 100, und das Tageslimit bewegt sich in 30er-Schritten (ein Zielwert von 500 wird daher als 510 angewendet). Telegram und die E-Mail-Anbieter bieten kein separates Tages-Leselimit.

Welche Limits gelten für Senden und Profilabrufe?

Die riskanteren Operationen bleiben unabhängig vom Lesebudget konservativ: Profilabrufe (die Anbieter als scraping-sensibel behandeln) und jede Sendeaktion.

AnbieterAktionLimit
LinkedInUnternehmensprofil abrufen1 / Sekunde
LinkedInNutzerprofil abrufen1 / Sekunde
LinkedInKontaktanfrage senden50 / Tag, 1 / 10 Sekunden
WhatsAppChat starten3 / Minute, 30 / Tag
TelegramChat starten3 / Minute, 30 / Tag
InstagramChat starten3 / Minute, 30 / Tag
Gmail / GoogleE-Mail senden300 / Tag
OutlookE-Mail senden300 / Tag
IMAPE-Mail senden300 / Tag

Operationen ohne eigene Zeile, etwa das Senden einer LinkedIn-Nachricht oder InMail und Suchen in LinkedIn Sales Navigator, fallen trotzdem unter die Grenzen pro Endpunkt und pro Konto und liefern dieselbe Rate-Limit-Meldung, wenn ein Fenster voll ist.

Was passiert, wenn ein Limit erreicht wird?

Weitere Aufrufe für dieses Konto werden abgelehnt, bis sich das Fenster erneuert, und die Aktion nennt die Wartezeit. Beim Senden einer Nachricht oder Starten einer Konversation erscheint:

Andere Aktionen formulieren es anders:

  • Konversation neu synchronisieren, ältere Nachrichten am Anfang einer Konversation und Medien in einer Nachricht: „Das Rate-Limit dieses Kanals wurde erreicht.“ mit der Wartezeit und Mehr erfahren.
  • Aktualisieren im Posteingang: „Einige Kanäle haben ihr Rate-Limit erreicht. Bitte in ein paar Minuten erneut versuchen.“
  • Eine E-Mail in einen anderen Ordner verschieben: „Ablegen in {folder} gestoppt, weil der Anbieter die Rate begrenzt.“ mit der Wartezeit für den Rest.

Die Wartezeit in der Meldung stammt aus dem Retry-After-Wert der Rate-Limit-Antwort, die Unipile zurückgibt; fehlt er, setzt die Meldung ersatzweise 60 Sekunden an und lautet „in 1 Minute“. Customermates wiederholt die Aktion nicht selbst: Die Wartezeit ist nur ein Hinweis, und sobald das angegebene Fenster vorbei ist, können Sie es erneut versuchen. Es geht nichts verloren. Über MCP und die REST-API schlägt der Aufruf mit derselben Meldung und Wartezeit fehl: Die REST-API antwortet mit HTTP-Status 429, und MCP liefert einen Fehler der Art rate_limit, dessen Eintrag in _meta.failure customCode: "unipileRateLimit" trägt.

Link: die Seite Posteingang, /inbox. Mate: navigate und highlight_element mit nav-inbox; Aktualisieren und Konversation neu synchronisieren sind keine Highlight-Ziele, deshalb nennt Mate sie beim Namen.

Setzt der Verlaufsimport von selbst fort?

Der Import des gesamten Nachrichtenverlaufs kann umfangreich sein, etwa eine Anfrage pro Unterhaltung. Wird mitten im Import ein Limit erreicht, pausiert der Hintergrund-Import und setzt automatisch fort, sobald sich das Fenster erneuert; Sie müssen nichts tun. Eine Wartezeit von mehr als zehn Minuten verschiebt den Import auf einen späteren Durchlauf. Mit Verwalten bei Inbox-Nachrichten lädt Scrollen bis zum Anfang einer Unterhaltung oder Konversation neu synchronisieren ältere Nachrichten vom Anbieter, und beides zählt gegen dieselben Limits; neue Aktivität trifft in Echtzeit über Webhooks ein.