Chamadas de saída
Com a VoiceBooker também é possível realizar chamadas, ou seja, ligar para clientes, o que pode ser usado para várias tarefas, como:
- informá-los automaticamente sobre mudanças de agendamento,
- agendar compromissos ativamente,
- informá-los sobre mudanças contratuais, upgrades etc.,
- realizar pesquisas, etc.
Para realizar chamadas, basta fazer uma requisição REST POST para o seguinte endpoint:
https://voicebooker.de/app/api/v1/makeCall
com os seguintes headers:
Content-Type: application/json
Token: <token>e os seguintes dados JSON no corpo:
{
"dest": "+49-351-123456789",
"botId": "<id>",
"sipAccountId": "<id>",
"ringTimeout": 25,
"startTimeout": 10,
"state": {
"customerId": "xyz..."
...
}
}Parâmetros
| Parâmetro | Descrição |
|---|---|
| dest | O número que deve ser chamado no formato E.164 |
| botId | O id do bot que deve ser usado na chamada |
| sipAccountId | A conta SIP que deve ser usada para realizar a chamada. O número desta conta aparecerá no display do chamado como número de origem |
| ringTimeout | O número de segundos que o bot deve tocar no destino antes de cancelar a chamada de saída se ninguém atender (padrão: 30 s) |
| startTimeout | O número de segundos que o bot deve esperar antes de começar a falar para permitir que o chamado fale primeiro quando atender |
| state | Dados de estado que podem ser usados para alimentar webhooks/chamadas de API a fim de recuperar dados do cliente, como um ID do cliente, durante a chamada |
A chamada REST retornará um callId que pode ser usado para webhooks que serão acionados se a chamada tiver êxito ou falhar, etc.