Effettua una chiamata da uno dei numeri di telefono del tuo spazio di lavoro. Ogni richiesta richiede un Idempotency-Key univoco; inviare di nuovo la stessa chiave restituisce la stessa chiamata invece di comporre due volte.
curl https://evasay.com/api/v1/voice/calls \
-X POST \
-H "Authorization: Bearer sk-your-key" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"agent_id": "AGENT_ID",
"to": "+14155550100",
"variables": { "customer_name": "Alex", "order_id": "1234" }
}'
from è obbligatorio quando lo spazio di lavoro ha più di un numero di telefono. variables riempiono segnaposto del tipo {{customer_name}} nel primo messaggio e nel prompt dell'agente.
Con voicemail_detection attivo (il predefinito), una chiamata in uscita aspetta che l'altra parte parli prima che l'agente saluti; se restano in silenzio, l'agente saluta dopo due o tre secondi. Quando l'agente sente una segreteria o una registrazione dell'operatore telefonico, aspetta che il saluto e il segnale acustico finiscano, lascia voicemail_message, oppure riaggancia se non ce n'è uno. Queste chiamate terminano con ended_reason voicemail, sono addebitate per il tempo che sono durate e non vengono analizzate né notificate.
In una campagna, un numero che ha raggiunto una segreteria viene richiamato come uno che non ha risposto, e il messaggio viene lasciato solo all'ultimo tentativo, così nessuno riceve due volte lo stesso messaggio.
Ogni chiamata in uscita, da una campagna o da POST /api/v1/voice/calls, controlla prima l'elenco da non chiamare dello spazio di lavoro. Un numero in elenco non viene mai composto: l'API risponde 409 con code do_not_call, e una campagna segna il contatto come canceled con outcome do_not_call e passa al successivo.
Quando la persona di una chiamata fatta dall'agente chiede di non essere richiamata, l'agente inserisce da solo il suo numero nell'elenco, glielo dice, e viene inviato il webhook call.do_not_call. I numeri si possono anche aggiungere e rimuovere in Campagne → Elenco da non chiamare o con l'API:
curl https://evasay.com/api/v1/voice/do-not-call \
-X POST \
-H "Authorization: Bearer sk-your-key" \
-H "Content-Type: application/json" \
-d '{ "phones": ["+14155550100"], "note": "Asked by email" }'
I numeri sono in formato internazionale; fino a 1.000 alla volta. GET /api/v1/voice/do-not-call li elenca, i più recenti per primi (search, limit, page), ciascuno con la sua source (call, dashboard o api). DELETE /api/v1/voice/do-not-call/%2B14155550100 ne toglie uno; fallo solo quando la persona ha accettato di essere chiamata.