Anruflimits und Anrufzeiten

Wie oft Voice Logica dieselbe Person anruft und zu welchen Uhrzeiten. Diese Regeln schützen die Angerufenen (und den Ruf Ihrer Nummer bei den Netzbetreibern). Sie gelten nur für ausgehende Anrufe. Wer Sie anruft, wird nie eingeschränkt.

Anrufzeiten

• Ausgehende Anrufe erfolgen nur zwischen 09:00 und 21:00 Uhr, in der Zeit des Landes Ihres Unternehmens.
• Einzelne Anrufe (API, Workflows, geplante Anrufe) erfolgen außerdem nicht am Samstag und Sonntag.
• Ein Anruf, der außerhalb dieser Zeiten angefordert wird, geht nicht verloren. Er wird für die nächste erlaubte Zeit geplant, und die API antwortet mit "scheduled": true und scheduleTime.
• Kampagnen rufen nur innerhalb ihrer eigenen Zeitplan-Tage und -Stunden an und nie außerhalb von 09:00–21:00 Uhr.
• Weiterleitungen und Anrufe, die eine Person aus den Apps oder von einem Tischtelefon tätigt, sind nicht eingeschränkt.

API-Anfragen können die Uhrzeiten mit overrideTimeRestriction: true und die Wochenendregel mit overrideDayRestriction: true umgehen. Anrufe nachts oder am Wochenende können gegen das Verbraucherschutzrecht Ihres Landes verstoßen. Nutzen Sie dies nur für Personen, die um einen Anruf zu dieser Zeit gebeten haben.

Einzelne Anrufe: höchstens 3 pro Tag und Nummer

Jeder einzeln getätigte Anruf (die API, ein Workflow, ein geplanter Anruf) ist standardmäßig geschützt. Pro Telefonnummer und Tag:

Regel	Limit	Bei Überschreitung
Zustande gekommene Anrufe	3	daily_call_limit_reached
Fehlgeschlagene Versuche (keine Route, abgelehnt)	3	failed_call_limit_reached
Abstand zwischen zustande gekommenen Anrufen	1 Stunde	cooldown_period_active
Gleichzeitige Anrufe an dieselbe Nummer	1	call_already_in_progress

• Anrufe der Person an Sie zählen nicht.
• Ein Rückruf, um den die Person gebeten hat („rufen Sie mich um 7 an“), erfolgt immer: Er umgeht diese Limits und die maximalen Wiederholungen der Kampagne. Die Anrufzeiten gelten weiterhin.
• Abgelehnte Anfragen zählen ebenfalls nicht.
• Der Tag wird um Mitternacht UTC zurückgesetzt.
• Eine abgelehnte Anfrage antwortet mit HTTP 429 (409 bei einem bereits laufenden Anruf), mit details.retryAfterSeconds, details.nextAllowedAt und einem Retry-After-Header. Warten Sie bis dahin. Senden Sie die Anfrage nicht in einer Schleife erneut.
• Eine API-Anfrage kann diese Limits mit useAntiHarassmentProtection: false abschalten. Tun Sie das nur für eigene Nummern oder Personen, die die Anrufe erwarten.

Kampagnen: wie oft eine Person angerufen wird

Kampagnen nutzen die Regel „3 pro Tag“ nicht. Sie legen auf der Registerkarte Stufen der Kampagne fest, wie oft jede Person auf der Liste (jeder Lead) angerufen wird.

Kurz gesagt

• Niemand hebt ab: Wir rufen erneut an, bis zur eingestellten Zahl an Wiederholungen, mit der eingestellten Wartezeit dazwischen. 3 Wiederholungen bedeuten bis zu 4 Anrufe.
• Jemand hebt ab, aber es gibt noch kein Ja oder Nein: Die Stufe Später erneut versuchen ruft später wieder an (bis zu 4 weitere Male, alle 5 Tage, sofern Sie es nicht ändern).
• Ein Limit pro Person: Beide Einstellungen teilen es sich. Höchstens gibt es den ersten Anruf plus den größeren der beiden Werte, nicht beide zusammengezählt.
• „Rufen Sie mich morgen um 6 an“ erfolgt immer, auch wenn die Anrufe aufgebraucht sind.
• Angerufen wird nur an den Tagen und zu den Uhrzeiten der Kampagne.

Wenn niemand abhebt

Öffnen Sie Stufen → Wenn niemand abhebt und legen Sie fest, wie oft zurückgerufen wird und wie lange zwischen den Anrufen gewartet wird.

• „Niemand hat abgehoben“ heißt: besetzt, Mailbox, keine Antwort oder ein Anruf, der nicht zustande kam. Eine Nummer, die nicht existiert, wird nicht erneut angerufen.
• Wiederholungen (0 bis 10, Standard 3) sind die Anrufe nach dem ersten. 3 Wiederholungen = bis zu 4 Anrufe insgesamt. 0 = nur ein Anruf.
• Wartezeit zwischen den Anrufen: 1 Stunde bis 4 Wochen, Standard 4 Stunden.

Wenn jemand abhebt

Nach jedem angenommenen Anruf wählt die KI die Stufe, die zum Verlauf passt, zum Beispiel Erfolgreich, Fehlgeschlagen oder Später erneut versuchen. Eine Stufe mit Erneut versuchen ruft die Person später wieder an. Sie legen Anrufe in dieser Stufe (1 bis 10) und die Wartezeit (30 Minuten bis 1 Woche) fest. Anrufe in dieser Stufe zählt den Anruf mit, der die Person in die Stufe gebracht hat. Beispiel: Später erneut versuchen auf 5 = bis zu 4 weitere Anrufe, alle 5 Tage. Wer ablehnt, wird als Abgebrochen geschlossen und nicht mehr angerufen.

Beide Einstellungen teilen sich ein Limit

Niemand wird öfter angerufen als der erste Anruf + der größere der beiden Werte: die Wiederholungen unter Wenn niemand abhebt oder die höchste Anzahl bei Erneut versuchen. Die beiden Werte werden nicht addiert.

Wiederholungen	Später erneut versuchen	Höchstens Anrufe pro Person
3	5	6 (1 + 5), nicht 9
3	2	4 (1 + 3)
0	5	6 (1 + 5)

Unbeantwortete Anrufe und Anrufe aus Später erneut versuchen gehen vom selben Kontingent ab. Wer dreimal nicht abgehoben hat, hat weniger Anrufe aus Später erneut versuchen übrig. Mit einer Stufe Später erneut versuchen kann eine Person, die nie abhebt, auch bei 0 Wiederholungen mehr als einmal angerufen werden. Für weniger Anrufe senken Sie beide Werte.

Zusätzliche Nummern und „rufen Sie mich um 6 an“

• Mehr als eine Nummer: Wird die erste Nummer nicht angenommen, versuchen wir etwa eine Minute später die nächste. Das verbraucht keine Wiederholung; die Wartezeit beginnt, wenn alle Nummern versucht wurden.
• Die Person nennt eine Uhrzeit („rufen Sie mich morgen um 6 an“): Dieser Anruf erfolgt immer, auch wenn die Anrufe aufgebraucht sind, innerhalb der Anrufzeiten und der Tage und Uhrzeiten der Kampagne. Er zählt trotzdem als einer ihrer Anrufe, danach sind also möglicherweise keine mehr übrig. Bittet die Person um einen Rückruf ohne Uhrzeit, rufen wir nach der eingestellten Wartezeit erneut an (bei Terminkampagnen nach 2 Tagen).
• Das Tool Schedule Callback ist etwas anderes: Es legt eine Rückrufaufgabe für Ihr Team an und tätigt nicht den Kampagnenanruf. Max callbacks per caller (1 bis 3) begrenzt diese Aufgaben, nicht die Kampagnenanrufe. Siehe Tools & Workflows.

Anrufe warten auf die Zeiten der Kampagne

Jede Wiederholung und jeder Rückruf erfolgt nur an den Tagen und zu den Uhrzeiten des Zeitplans der Kampagne. Fällt einer außerhalb, geht er nicht verloren: Er erfolgt, sobald das Zeitfenster wieder öffnet. Beispiel: Zeiten 09:00–20:00 Uhr, Wartezeit 4 Stunden, unbeantworteter Anruf um 18:00 Uhr. Der nächste Anruf erfolgt um 09:00 Uhr am nächsten Anruftag.

Einstellungen während der Kampagne ändern

Sie können die Wiederholungen, die Wartezeit und die Stufen jederzeit ändern. Die Änderung gilt innerhalb weniger Sekunden:

• Personen, die bereits auf einen Anruf zu einer festen Uhrzeit warten, behalten diese Uhrzeit. Die neue Wartezeit gilt nach diesem Anruf.
• Weniger Wiederholungen: Personen, die schon so viele Anrufe hatten, werden nicht mehr angerufen.
• Mehr Wiederholungen: Personen mit Alle Versuche ausgeschöpft bleiben geschlossen. Um sie erneut anzurufen, fügen Sie sie der Kampagne erneut hinzu.

Wie oft jede Person angerufen wurde

In der Lead-Tabelle der Kampagne zeigt Anrufversuche die bisherigen Anrufe pro Person. Der Status zeigt Wiederholung geplant, solange die Person auf den nächsten Anruf wartet, und Alle Versuche ausgeschöpft, wenn keine Anrufe mehr übrig sind. Öffnen Sie einen Lead, um jeden Anruf und seine Stufe zu sehen.

Eine Nachricht, wenn die Anrufe aufgebraucht sind

Wählen Sie unter Wenn alle Anrufe aufgebraucht sind eine SMS, eine E-Mail oder beides, und für eine SMS den Absender (Von: Automatisch nutzt den SMS-Absender Ihres Agenten oder den eigenen verifizierten Absender Ihres Unternehmens). Sie wird einmal pro Person gesendet, wenn sie Alle Versuche ausgeschöpft erreicht: Die Rückrufe oder das Anruflimit einer Stufe sind ohne Ergebnis aufgebraucht, auch wenn die Person abgehoben und aufgelegt hat. Sie geht innerhalb der Anrufzeiten der Kampagne raus (wer abends keine Anrufe mehr hat, erhält sie, sobald das nächste Anruffenster beginnt), nie an eine Nummer, die nicht mehr angerufen werden will, und nicht, wenn bei einem ihrer Anrufe ein Termin gebucht wurde.

Achtung

10 Wiederholungen im Abstand von 1 Stunde können 11 Anrufe an dieselbe Person an einem Tag bedeuten. Für Personen, die nicht um einen Anruf gebeten haben, sollten Sie 2–3 Wiederholungen und eine Verzögerung von 4 Stunden oder 1 Tag einstellen.

Nummern in den Allowed test numbers der Kampagne umgehen alle Limits. Nutzen Sie das nur für Ihre eigenen Telefone während Tests.

Der Widerspruch ist dauerhaft

Wenn jemand bittet, nicht mehr angerufen zu werden, wird seine Nummer als abgemeldet (opted out) markiert:

• Kein Agent und keine Kampagne Ihres Unternehmens ruft sie erneut an (callee_opted_out).
• Die Leads dieser Person in Kampagnen werden zurückgestellt.
• Fügen Sie sie nicht als neuen Kontakt oder in einer neuen Kampagne wieder hinzu.

Gesperrte Kontakte

Sperren Sie einen Kontakt unter Kontakte, wenn diese Person nur mit Ihrem Team sprechen soll, nie mit einem AI-Agent. Ihre Anrufe an eine Nummer, die ein Agent annimmt, werden abgelehnt, bevor der Agent abhebt (SIP 603 Decline), damit Ihr Netzbetreiber oder Ihre Telefonanlage sie an Ihr Team weiterleiten kann. Kein Agent und keine Kampagne ruft sie an (callee_opted_out, Grund contact_blocked). Anrufe, die an einen Benutzer oder eine Benutzergruppe geleitet werden, und Anrufe Ihres Teams sind nicht betroffen. Heben Sie die Sperre des Kontakts auf, um dies rückgängig zu machen.

Häufige Fragen

Kann der Agent dieselbe Person 10-mal am Tag anrufen?

Nicht mit einzelnen Anrufen: Das Limit liegt bei 3 Anrufen pro Tag an dieselbe Nummer, im Abstand von 1 Stunde. Eine Kampagne mit 10 Wiederholungen und 1 Stunde Verzögerung kann das. Stellen Sie die Verzögerung so ein, dass sich die Anrufe auf mehrere Tage verteilen.

Warum wurde mein ausgehender API-Anruf geplant statt sofort ausgeführt?

Er lag außerhalb von 09:00–21:00 Uhr oder an einem Wochenende im Land Ihres Unternehmens. Der Anruf erfolgt automatisch zur scheduleTime in der Antwort.

Ich teste ausgehende Anrufe auf meinem eigenen Telefon und habe das Limit erreicht. Was tun?

Fügen Sie Ihre Nummer zu den Allowed test numbers einer Kampagne hinzu, oder senden Sie useAntiHarassmentProtection: false in Ihren Test-API-Anfragen.

Ich habe 3 Wiederholungen und Später erneut versuchen 5 eingestellt. Warum wurde ein Lead 6-mal angerufen?

Eine Kampagne mit Stufen hat ein Limit pro Lead: den ersten Anruf plus den größeren der beiden Werte, hier 1 + 5 = 6. Unbeantwortete Anrufe und Rückrufe aus „Später erneut versuchen“ zählen beide dazu. Für weniger Anrufe senken Sie auch die Anzahl von Erneut versuchen in der Stufe.

Der Lead hatte keine Wiederholungen mehr, wurde aber trotzdem angerufen. Warum?

Die Person hat um einen Rückruf zu einer bestimmten Uhrzeit gebeten. Ein solcher Rückruf erfolgt immer, innerhalb der Anrufzeiten und des Kampagnen-Zeitplans. Er zählt trotzdem als einer der Anrufe des Leads.