Foretag ét opkald fra et af dit arbejdsområdes telefonnumre. Hver anmodning kræver en unik Idempotency-Key; sendes den samme nøgle igen, får du det samme opkald tilbage i stedet for at ringe to gange.
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 er påkrævet, når arbejdsområdet har mere end ét telefonnummer. variables udfylder pladsholdere som {{customer_name}} i agentens første besked og prompt.
Med voicemail_detection slået til (standard) lytter et udgående opkald efter, at den anden side taler, før agenten hilser; forbliver de tavse, hilser agenten efter to eller tre sekunder. Når agenten hører en telefonsvarer eller en teleoperatørs optagelse, venter den, til hilsenen og bippet er slut, efterlader voicemail_message eller lægger på, når der ikke er nogen. Sådanne opkald slutter med ended_reason voicemail, afregnes for den tid, de varede, og analyseres eller notificeres ikke.
I en kampagne ringes der igen til et nummer, der nåede en telefonsvarer, som til et, der ikke svarede, og beskeden efterlades kun ved sidste forsøg, så ingen får den samme besked to gange.
Hvert udgående opkald, fra en kampagne eller fra POST /api/v1/voice/calls, tjekker først arbejdsområdets spærreliste. Et nummer på listen ringes aldrig op: API'et svarer 409 med code do_not_call, og en kampagne markerer kontakten som canceled med outcome do_not_call og går videre til den næste.
Når personen i et opkald, agenten foretog, beder om ikke at blive ringet op igen, sætter agenten selv nummeret på listen, siger det til dem, og webhooken call.do_not_call sendes. Numre kan også tilføjes og fjernes under Kampagner → Spærreliste eller med API'et:
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" }'
Numre angives i internationalt format; op til 1.000 ad gangen. GET /api/v1/voice/do-not-call viser dem, nyeste først (search, limit, page), hver med sin source (call, dashboard eller api). DELETE /api/v1/voice/do-not-call/%2B14155550100 tager ét af listen igen; gør det kun, når personen har accepteret at blive ringet op.