Зробіть один дзвінок з одного з телефонних номерів вашого робочого простору. Кожен запит потребує унікального Idempotency-Key; повторне надсилання того самого ключа повертає той самий дзвінок, а не набирає номер двічі.
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 обов'язковий, якщо в робочому просторі більше ніж один номер телефону. variables підставляються в заповнювачі на кшталт {{customer_name}} у першому повідомленні та промпті агента.
З увімкненим voicemail_detection (за замовчуванням) вихідний дзвінок чекає, поки інша сторона заговорить, перш ніж агент привітається; якщо вони мовчать, агент вітається за дві–три секунди. Коли агент чує автовідповідач або запис оператора зв'язку, він чекає на кінець привітання та сигналу, залишає voicemail_message або кладе слухавку, якщо повідомлення немає. Такі дзвінки завершуються з ended_reason voicemail, тарифікуються за фактичною тривалістю й не аналізуються та не розсилаються в сповіщеннях.
У кампанії номер, що потрапив на автовідповідач, набирається знову, як той, що не відповів, а повідомлення залишається лише під час останньої спроби, щоб ніхто не отримав те саме повідомлення двічі.
Кожен вихідний дзвінок — із кампанії чи через POST /api/v1/voice/calls — спершу перевіряє список «Не дзвонити» робочого простору. Номер зі списку ніколи не набирається: API відповідає 409 із code do_not_call, а кампанія позначає контакт як canceled з outcome do_not_call і переходить до наступного.
Коли людина в дзвінку, зробленому агентом, просить більше їй не телефонувати, агент сам вносить її номер до списку, повідомляє їй про це, і надсилається вебхук call.do_not_call. Номери можна також додавати й видаляти в Кампанії → Список «Не дзвонити» або через 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" }'
Номери вказуються в міжнародному форматі; до 1000 за раз. GET /api/v1/voice/do-not-call виводить їх, спершу нові (search, limit, page), у кожного є source (call, dashboard або api). DELETE /api/v1/voice/do-not-call/%2B14155550100 знову прибирає номер зі списку; робіть це, лише коли людина погодилася на дзвінки.