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.
Auf einen Blick
Abschnitt betitelt „Auf einen Blick“| 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 |
Zielnummern
Abschnitt betitelt „Zielnummern“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.
Anrufzeiten
Abschnitt betitelt „Anrufzeiten“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/calls30 je Minute. Siehe Rate-Limits.
Sperrliste
Abschnitt betitelt „Sperrliste“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 (
sourceistassistant). - Im Dashboard: unter Ausgehende Anrufe › Einstellungen bei Sperrliste (
manual). - Über die API (
api):
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.
# 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).
Abrechnung
Abschnitt betitelt „Abrechnung“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.
Rechtlicher Rahmen
Abschnitt betitelt „Rechtlicher Rahmen“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_confirmedund nennen mitcontact_sourcedie 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.