# 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](https://docs.voicelogica.ai/de/outbound-calls/campaigns/) 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](https://docs.voicelogica.ai/de/outbound-calls/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. ### 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](https://docs.voicelogica.ai/de/agent-configuration/built-in-tools/). ### 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. 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.