Ausgehende Anrufe
Mit VoiceBooker ist es auch möglich, Anrufe zu tätigen, d. h. Kunden anzurufen, um verschiedene Aufgaben auszuführen, wie zum Beispiel:
- sie automatisch über Terminänderungen zu informieren,
- aktiv Termine zu vereinbaren,
- sie über Vertragsänderungen, Upgrades usw. zu informieren,
- Umfragen durchzuführen usw.
Um Anrufe zu tätigen, senden Sie einfach einen POST-API-REST-Request an folgenden Endpoint:
https://voicebooker.de/app/api/v1/makeCall
mit den folgenden Header-Daten
Content-Type: application/json
Token: <token>und den folgenden JSON-Daten im Body:
{
"dest": "+49-351-123456789",
"botId": "<id>",
"sipAccountId": "<id>",
"ringTimeout": 25,
"startTimeout": 10,
"state": {
"customerId": "xyz..."
...
}
}Parameter
| Parameter | Beschreibung |
|---|---|
| dest | Die Nummer, die im E.164-Format angerufen werden soll |
| botId | Die ID des Bots, der für den Anruf verwendet werden soll |
| sipAccountId | Das SIP-Konto, das für den Anruf verwendet werden soll. Die Nummer dieses Kontos erscheint beim Angerufenen als Anrufernummer |
| ringTimeout | Zeit in Sekunden, wie lange der Bot die Zielnummer klingeln lässt, bevor der ausgehende Anruf abgebrochen wird (Standard: 30 s) |
| startTimeout | Zeit in Sekunden, die der Bot wartet, bevor er zu sprechen beginnt, damit der Angerufene zuerst sprechen kann, wenn er abhebt |
| state | State-Daten, die z. B. für Webhooks/API-Aufrufe genutzt werden können, um Kundendaten wie eine Kunden-ID während des Anrufs abzurufen |
Der REST-API-Aufruf gibt eine callId zurück, die für Webhook-Aufrufe verwendet werden kann, die ausgelöst werden, wenn der Anruf erfolgreich war oder fehlgeschlagen ist usw.