Soita yksi puhelu jostakin työtilasi puhelinnumerosta. Jokainen pyyntö tarvitsee yksilöllisen Idempotency-Key-avaimen; saman avaimen lähettäminen uudelleen palauttaa saman puhelun sen sijaan, että soitettaisiin kahdesti.
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 vaaditaan, kun työtilassa on useampi kuin yksi puhelinnumero. variables täyttävät {{customer_name}}-tyyppiset paikkamerkit agentin ensimmäisessä viestissä ja kehotteessa.
Kun voicemail_detection on päällä (oletus), lähtevä puhelu kuuntelee, puhuuko toinen osapuoli, ennen kuin agentti tervehtii; jos he pysyvät hiljaa, agentti tervehtii kahden tai kolmen sekunnin kuluttua. Kun agentti kuulee vastaajan tai operaattorin äänitteen, se odottaa tervehdyksen ja äänimerkin päättymistä, jättää voicemail_message-viestin tai katkaisee, jos sellaista ei ole. Tällaiset puhelut päättyvät ended_reason-arvoon voicemail, ne laskutetaan keston mukaan, eikä niitä analysoida tai niistä ilmoiteta.
Kampanjassa vastaajaan päätynyt numero soitetaan uudelleen kuin numero, joka ei vastannut, ja viesti jätetään vain viimeisellä yrityksellä, jotta kukaan ei saa samaa viestiä kahdesti.
Jokainen lähtevä puhelu, kampanjasta tai komennolla POST /api/v1/voice/calls, tarkistaa ensin työtilan Älä soita -luettelon. Luettelossa olevaan numeroon ei soiteta koskaan: API vastaa 409 ja code on do_not_call, ja kampanja merkitsee yhteystiedon tilaan canceled ja outcome-arvoksi do_not_call ja siirtyy seuraavaan.
Kun agentin soittamassa puhelussa oleva henkilö pyytää, ettei hänelle soiteta enää, agentti lisää hänen numeronsa luetteloon itse, kertoo siitä hänelle, ja call.do_not_call-webhook lähetetään. Numeroita voi myös lisätä ja poistaa kohdassa Kampanjat → Älä soita -luettelo tai API:lla:
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" }'
Numerot annetaan kansainvälisessä muodossa; enintään 1 000 kerrallaan. GET /api/v1/voice/do-not-call listaa ne uusin ensin (search, limit, page), kunkin source-arvon kanssa (call, dashboard tai api). DELETE /api/v1/voice/do-not-call/%2B14155550100 poistaa yhden luettelosta; tee se vain, kun henkilö on suostunut siihen, että hänelle soitetaan.