Indíts egy hívást a munkaterületed egyik telefonszámáról. Minden kéréshez egyedi Idempotency-Key kell; ugyanannak a kulcsnak az ismételt elküldése ugyanazt a hívást adja vissza ahelyett, hogy kétszer tárcsázna.
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" }
}'
A from kötelező, ha a munkaterületnek egynél több telefonszáma van. A variables kitölti a {{customer_name}}-szerű helyőrzőket az ügynök első üzenetében és promptjában.
Bekapcsolt voicemail_detection esetén (alapértelmezés) a kimenő hívás megvárja, hogy a másik fél megszólaljon, mielőtt az ügynök köszönne; ha hallgatnak, az ügynök két-három másodperc után köszön. Amikor az ügynök hangpostát vagy egy telefontársaság felvételét hallja, megvárja a köszöntés és a sípszó végét, otthagyja a voicemail_message üzenetet, vagy lerakja, ha nincs. Az ilyen hívások ended_reason értéke voicemail, a tényleges időtartamukra számláznak, és nem elemzik, illetve nem értesítik róluk.
Egy kampányban a hangpostára jutott számot úgy hívják újra, mint amelyik nem vette fel, és az üzenetet csak az utolsó próbálkozásnál hagyják, hogy senki se kapja kétszer ugyanazt az üzenetet.
Minden kimenő hívás, kampányból vagy a POST /api/v1/voice/calls hívásból, először a munkaterület hívástiltó listáját ellenőrzi. A listán szereplő számot soha nem tárcsázza: az API 409 választ ad do_not_call code értékkel, a kampány pedig a kapcsolatot canceled állapotúra és do_not_call outcome értékűre állítja, és megy tovább a következőre.
Amikor az ügynök által indított hívás személye azt kéri, hogy ne hívják újra, az ügynök maga felveszi a számát a listára, megmondja neki, és elküldi a call.do_not_call webhookot. A számok a Kampányok → Hívástiltó lista alatt vagy az API-val is hozzáadhatók és eltávolíthatók:
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" }'
A számok nemzetközi formátumban szerepelnek; egyszerre legfeljebb 1000. A GET /api/v1/voice/do-not-call listázza őket, a legújabbakkal kezdve (search, limit, page), mindegyiket a source értékével (call, dashboard vagy api). A DELETE /api/v1/voice/do-not-call/%2B14155550100 újra levesz egyet; ezt csak akkor tedd, ha a személy beleegyezett abba, hogy felhívják.