Zum Inhalt springen
Hilfe-Center
Support kontaktierenApp öffnen

Regeln und Grenzen für ausgehende Anrufe

Für ausgehende Anrufe gelten feste Grenzen. Sie gelten überall gleich: für Anrufe über die API, aus dem Dashboard und aus Kampagnen. Die API prüft sie beim Anlegen und noch einmal direkt vor dem Wählen.

Regel Wert Fehlercode
Zielländer Deutschland, Österreich, Schweiz country_not_allowed
Sonder- und Mehrwertnummern nie special_number
Anrufzeiten Montag bis Samstag, 8 bis 20 Uhr deutscher Zeit outside_call_hours
Tageslimit 200 Wählversuche je Organisation und Tag daily_limit_reached
je Nummer ein Anruf je Tag number_called_today
Versuche je Anruf höchstens 3, mindestens 120 Minuten Abstand invalid_request
Gleichzeitig ein ausgehender Anruf je Organisation keiner, weitere warten
Sperrliste und gesperrte Kontakte nie suppressed, contact_blocked
Eigene Rufnummern nie own_number

Ihr Assistent ruft nur Nummern in Deutschland (+49), Österreich (+43) und der Schweiz (+41) an. Eine Nummer braucht nach dem Pluszeichen mindestens 9 Ziffern, Kurzwahlen sind nicht möglich.

Diese Sonder- und Mehrwertnummern werden nie gewählt:

Land Gesperrte Anfänge Art
Deutschland +49900, +49180, +49137, +49700, +4912, +49118, +4919 Mehrwert, Service, Massenverkehr, persönliche Nummern, Auskunft und Dienste
Österreich +43900, +43901, +4393, +43810, +4382, +43118 Mehrwert, Service, Auskunft
Schweiz +41900, +41901, +41906, +4184, +4118 Mehrwert, Kostenteilung, Auskunft

Ihre eigenen SpeakKI-Rufnummern kann Ihr Assistent nicht anrufen.

Als Absender sind nur eigene, aktive Rufnummern Ihrer Organisation möglich. GET /v1/phone-numbers listet sie auf.

Ihr Assistent ruft nur von Montag bis Samstag zwischen 8 und 20 Uhr an. Es gilt die deutsche Zeit (Europe/Berlin), auch für Nummern in Österreich und der Schweiz. An Sonntagen ruft er nie an. Gesetzliche Feiertage erkennt die API nicht, sparen Sie diese in Ihrem Programm selbst aus.

Ihre Organisation kann das Zeitfenster enger stellen, im Dashboard unter Ausgehende Anrufe › Einstellungen bei Anrufzeiten. Eine Kampagne kann es mit call_window noch einmal einschränken. Weiter als Montag bis Samstag, 8 bis 20 Uhr geht es nie.

  • Einzelner Anruf: Liegt der Start außerhalb der Anrufzeiten, lehnt die API ab (outside_call_hours).
  • Kampagne und Wiederholversuch: Der Anruf wartet und startet zum nächsten erlaubten Zeitpunkt.
  • Tageslimit: Je Organisation sind 200 Wählversuche am Tag möglich. Jeder Versuch zählt, auch wenn niemand abnimmt. Ist das Limit erreicht, lehnt die API neue Anrufe für heute ab (daily_limit_reached). Kampagnen machen am nächsten Tag weiter. Brauchen Sie mehr, schreiben Sie uns im Support-Chat.
  • Ein Anruf je Nummer und Tag: Gibt es für eine Nummer an einem Tag schon einen Anruf, lehnt die API einen zweiten ab (number_called_today). Abgebrochene und abgelehnte Anrufe zählen dabei nicht, Wiederholversuche desselben Anrufs auch nicht.
  • Höchstens drei Versuche: Ein Anruf hat höchstens 3 Versuche, also zwei Wiederholungen. Dazwischen liegen mindestens 120 Minuten.
  • Ein Anruf gleichzeitig: Je Organisation läuft ein ausgehender Anruf zur selben Zeit. Weitere warten, bis die Leitung frei ist. Für eingehende Anrufe bleibt dabei immer Platz.
  • Dauer: Es klingelt höchstens 30 Sekunden. Ein Gespräch dauert höchstens 30 Minuten.
  • Kampagnen: höchstens 2000 Empfänger je Kampagne und 5 laufende Kampagnen je Organisation.
  • Anfragen: 120 je Minute und Schlüssel, für POST /v1/calls 30 je Minute. Siehe Rate-Limits.

Auf der Sperrliste stehen Nummern, die Ihre Organisation nie ausgehend anruft. Ein Anruf an eine solche Nummer wird mit suppressed abgelehnt.

Eine Nummer kommt auf drei Wegen auf die Liste:

  • Im Gespräch: Sagt die angerufene Person, dass sie nicht mehr angerufen werden möchte, trägt Ihr Assistent die Nummer selbst ein (source ist assistant).
  • Im Dashboard: unter Ausgehende Anrufe › Einstellungen bei Sperrliste (manual).
  • Über die API (api):
Terminal-Fenster
curl https://api.speakki.de/v1/suppressions \
-H "Authorization: Bearer spk_live_IHR_SCHLUESSEL" \
-H "Content-Type: application/json" \
-d '{ "number": "+4915228817386", "reason": "Widerspruch per E-Mail" }'

Steht die Nummer schon auf der Liste, bleibt der vorhandene Eintrag und kommt unverändert zurück. reason ist ein freier Vermerk nur für Sie, höchstens 200 Zeichen.

Terminal-Fenster
# Sperrliste lesen (Berechtigung calls:read)
curl "https://api.speakki.de/v1/suppressions?limit=100" \
-H "Authorization: Bearer spk_live_IHR_SCHLUESSEL"
# Sperre aufheben (Berechtigung suppressions:write)
curl -X DELETE https://api.speakki.de/v1/suppressions/7b2e4c9a-1f3d-4e8b-9a6c-2d5f8e1b4a7c \
-H "Authorization: Bearer spk_live_IHR_SCHLUESSEL"

Die Liste kommt neueste zuerst und blättert mit limit und cursor wie alle Listen.

Tragen Sie Widersprüche, die Sie auf anderem Weg erreichen, sofort ein. Heben Sie eine Sperre nur auf, wenn die Person es ausdrücklich wünscht.

Kontakte, deren Anrufe Sie im Dashboard gesperrt haben, ruft Ihr Assistent ebenfalls nicht an (contact_blocked).

Ausgehende Anrufe zählen auf dasselbe Minutenkontingent wie eingehende.

  • Eine ausgehende Gesprächsminute zählt 1,5-fach. Ein Gespräch von 2 Minuten verbraucht 3 Minuten Ihres Kontingents.
  • Anrufe, die niemanden erreichen, zählen nicht: nicht abgenommen, besetzt, Mailbox oder fehlgeschlagen.
  • Sind die Inklusivminuten aufgebraucht, gilt der Minutenpreis Ihres Tarifs.
  • Der API-Zugang selbst ist im Tarif Professional enthalten.

Sind Anrufe wegen Tarif oder Zahlung gerade nicht möglich, lehnt die API mit billing_blocked ab.

Für jeden Anruf sind Sie als Auftraggeber verantwortlich. Die folgenden Punkte sind keine Rechtsberatung. Lassen Sie Ihren Anwendungsfall im Zweifel prüfen.

  • Nur mit Einwilligung: Rufen Sie nur Personen an, die dem Anruf vorher zugestimmt haben oder mit denen eine Geschäftsbeziehung besteht. Halten Sie fest, wann und wie die Einwilligung gegeben wurde.
  • Keine Kaltakquise: Werbeanrufe an Personen ohne Einwilligung sind verboten. Bei einer Kampagne bestätigen Sie die Einwilligung mit consent_confirmed und nennen mit contact_source die Herkunft der Kontakte.
  • KI-Hinweis: Ihr Assistent nennt zu Beginn den Namen Ihres Unternehmens und sagt, dass eine KI spricht. Schreiben Sie das in die Begrüßung für ausgehende Anrufe.
  • Aufzeichnung nur mit Ansage: Ausgehende Gespräche zeichnet SpeakKI nur auf, wenn am Assistenten der Hinweis für die Aufzeichnung eingerichtet ist. Ihr Assistent sagt ihn zu Beginn an.
  • Widerspruch gilt sofort: Wer nicht mehr angerufen werden möchte, wird nicht mehr angerufen. Dafür gibt es die Sperrliste.
  • Eigene Rufnummer: Ihr Assistent ruft immer mit einer Ihrer eigenen Rufnummern an.

Diese Regeln bestätigt ein Administrator Ihrer Organisation, wenn er die Freischaltung im Dashboard beantragt. Verbindlich sind die dort gezeigten Regeln für ausgehende Anrufe und unsere AGB.