Appels sortants
Avec VoiceBooker, il est également possible de passer des appels, c’est‑à‑dire d’appeler des clients, ce qui peut servir à plusieurs tâches telles que :
- les informer automatiquement des changements de rendez‑vous,
- planifier activement des rendez‑vous,
- les informer des changements de contrat, des upgrades, etc.,
- mener des enquêtes, etc.
Pour passer des appels, il suffit d’effectuer une requête REST POST à l’endpoint suivant :
https://voicebooker.de/app/api/v1/makeCall
avec les en‑têtes suivants :
Content-Type: application/json
Token: <token>et les données JSON suivantes dans le corps :
{
"dest": "+49-351-123456789",
"botId": "<id>",
"sipAccountId": "<id>",
"ringTimeout": 25,
"startTimeout": 10,
"state": {
"customerId": "xyz..."
...
}
}Paramètres
| Paramètre | Description |
|---|---|
| dest | Le numéro à appeler au format E.164 |
| botId | L’ID du bot qui doit être utilisé pour l’appel |
| sipAccountId | Le compte SIP à utiliser pour l’appel. Le numéro de ce compte apparaîtra sur l’écran du destinataire comme numéro appelant |
| ringTimeout | Le nombre de secondes pendant lesquelles le bot doit faire sonner le numéro avant d’annuler l’appel sortant si personne ne répond (par défaut : 30 s) |
| startTimeout | Le nombre de secondes pendant lesquelles le bot doit attendre avant de commencer à parler afin de laisser le destinataire parler en premier lorsqu’il décroche |
| state | Données d’état qui peuvent être utilisées pour alimenter ensuite des webhooks/appels d’API afin de récupérer des données client, par ex. un ID client, pendant l’appel |
L’appel REST renverra un callId qui peut être utilisé pour des webhooks qui seront déclenchés si l’appel a réussi ou échoué, etc.