Plaats één gesprek vanaf een van de telefoonnummers van je werkruimte. Elk verzoek heeft een unieke Idempotency-Key nodig; dezelfde sleutel opnieuw sturen geeft hetzelfde gesprek terug in plaats van twee keer te bellen.
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 is verplicht als de werkruimte meer dan één telefoonnummer heeft. variables vullen plaatshouders als {{customer_name}} in het eerste bericht en de prompt van de agent.
Met voicemail_detection aan (de standaard) wacht een uitgaand gesprek tot de andere kant praat voordat de agent begroet; blijven ze stil, dan begroet de agent na twee of drie seconden. Als de agent een voicemail of een opname van een telefoonmaatschappij hoort, wacht hij tot de begroeting en de piep voorbij zijn, laat voicemail_message achter, of hangt op als er geen is. Zulke gesprekken eindigen met ended_reason voicemail, worden gefactureerd voor de tijd die ze duurden en worden niet geanalyseerd of gemeld.
In een campagne wordt een nummer dat een voicemail bereikte opnieuw gebeld als een nummer dat niet opnam, en het bericht wordt alleen bij de laatste poging achtergelaten, zodat niemand hetzelfde bericht twee keer krijgt.
Elk uitgaand gesprek, uit een campagne of via POST /api/v1/voice/calls, controleert eerst de niet-bellen-lijst van de werkruimte. Een nummer op de lijst wordt nooit gebeld: de API antwoordt 409 met code do_not_call, en een campagne markeert het contact als canceled met outcome do_not_call en gaat door naar het volgende.
Als de persoon in een gesprek dat de agent plaatste vraagt niet meer gebeld te worden, zet de agent het nummer zelf op de lijst, zegt dat tegen hen, en wordt de call.do_not_call-webhook verstuurd. Nummers kunnen ook worden toegevoegd en verwijderd onder Campagnes → Niet-bellen-lijst of met de 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" }'
Nummers staan in internationaal formaat; tot 1.000 tegelijk. GET /api/v1/voice/do-not-call toont ze, nieuwste eerst (search, limit, page), elk met zijn source (call, dashboard of api). DELETE /api/v1/voice/do-not-call/%2B14155550100 haalt er weer een af; doe dat alleen als de persoon ermee akkoord is gegaan gebeld te worden.