Passez un appel depuis l’un des numéros de votre espace de travail. Chaque requête doit avoir un Idempotency-Key unique ; renvoyer la même clé renvoie le même appel au lieu de composer deux fois.
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 est obligatoire quand l’espace de travail a plus d’un numéro de téléphone. variables remplit les variables du type {{customer_name}} dans le premier message et le prompt de l’agent.
Avec voicemail_detection activé (par défaut), un appel sortant attend que l’autre partie parle avant que l’agent la salue ; si elle reste silencieuse, l’agent salue après deux ou trois secondes. Quand l’agent entend une messagerie ou un message d’opérateur, il attend la fin de l’annonce et du bip, laisse voicemail_message, ou raccroche s’il n’y en a pas. Ces appels se terminent avec ended_reason voicemail, sont facturés pour leur durée et ne sont ni analysés ni notifiés.
Dans une campagne, un numéro tombé sur une messagerie est rappelé comme un numéro qui n’a pas répondu, et le message n’est laissé qu’à sa dernière tentative, pour que personne ne reçoive deux fois le même message.
Chaque appel sortant, d’une campagne ou de POST /api/v1/voice/calls, vérifie d’abord la liste d’opposition de l’espace de travail. Un numéro listé n’est jamais composé : l’API répond 409 avec code do_not_call, et une campagne marque le contact canceled avec outcome do_not_call et passe au suivant.
Quand la personne d’un appel passé par l’agent demande à ne plus être appelée, l’agent ajoute lui-même son numéro à la liste, le lui dit, et le webhook call.do_not_call est envoyé. Les numéros peuvent aussi être ajoutés et retirés sous Campagnes → Liste d’opposition ou avec 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" }'
Les numéros sont au format international ; jusqu’à 1 000 à la fois. GET /api/v1/voice/do-not-call les liste, du plus récent au plus ancien (search, limit, page), chacun avec sa source (call, dashboard ou api). DELETE /api/v1/voice/do-not-call/%2B14155550100 en retire un ; ne le faites que si la personne a accepté d’être appelée.