Chiamate in uscita
Con VoiceBooker è anche possibile effettuare chiamate, cioè chiamare clienti, che possono essere utilizzate per diversi compiti come:
- informarli automaticamente dei cambi di appuntamento,
- pianificare attivamente appuntamenti,
- informarli su modifiche contrattuali, upgrade, ecc.,
- condurre sondaggi, ecc.
Per effettuare chiamate, basta inviare una richiesta REST POST al seguente endpoint:
https://voicebooker.de/app/api/v1/makeCall
con i seguenti header:
Content-Type: application/json
Token: <token>e i seguenti dati JSON nel body:
{
"dest": "+49-351-123456789",
"botId": "<id>",
"sipAccountId": "<id>",
"ringTimeout": 25,
"startTimeout": 10,
"state": {
"customerId": "xyz..."
...
}
}Parametri
| Parametro | Descrizione |
|---|---|
| dest | Il numero da chiamare nel formato E.164 |
| botId | L’ID del bot da usare per la chiamata |
| sipAccountId | L’account SIP da usare per effettuare la chiamata. Il numero di questo account apparirà sul display del destinatario come numero chiamante |
| ringTimeout | Il numero di secondi per cui il bot deve far squillare la destinazione prima di annullare la chiamata in uscita se nessuno risponde (predefinito: 30 s) |
| startTimeout | Il numero di secondi in cui il bot deve aspettare prima di iniziare a parlare per permettere al chiamato di parlare per primo quando risponde |
| state | Dati di stato che possono essere usati per alimentare webhooks/chiamate API al fine di recuperare dati del cliente, ad esempio un ID cliente, durante la chiamata |
La chiamata REST restituirà un callId che può essere utilizzato per webhooks che verranno attivati se la chiamata è riuscita o fallita, ecc.