Llamadas salientes
Con VoiceBooker también es posible realizar llamadas, es decir, llamar a clientes, lo cual puede usarse para varias tareas como:
- informarles automáticamente sobre cambios de cita,
- programar citas de forma activa,
- informarles sobre cambios de contrato, upgrades, etc.,
- realizar encuestas, etc.
Para realizar llamadas, simplemente haz una solicitud REST POST al siguiente endpoint:
https://voicebooker.de/app/api/v1/makeCall
con los siguientes headers:
Content-Type: application/json
Token: <token>y los siguientes datos JSON en el cuerpo:
{
"dest": "+49-351-123456789",
"botId": "<id>",
"sipAccountId": "<id>",
"ringTimeout": 25,
"startTimeout": 10,
"state": {
"customerId": "xyz..."
...
}
}Parámetros
| Parámetro | Descripción |
|---|---|
| dest | El número al que se debe llamar en formato E.164 |
| botId | El id del bot que debe usarse para la llamada |
| sipAccountId | La cuenta SIP que se debe usar para realizar la llamada. El número de esta cuenta aparecerá en la pantalla del destinatario como número de origen |
| ringTimeout | El número de segundos que el bot debe hacer sonar el destino antes de cancelar la llamada saliente si nadie contesta (predeterminado: 30 s) |
| startTimeout | El número de segundos que el bot debe esperar antes de empezar a hablar para permitir que el llamado hable primero cuando conteste |
| state | Datos de estado que pueden usarse para alimentar webhooks/llamadas de API con el fin de recuperar datos del cliente, como un ID de cliente, durante la llamada |
La llamada REST devolverá un callId que puede usarse para webhooks que se activarán si la llamada tuvo éxito o falló, etc.