Wykonaj jedno połączenie z jednego z numerów telefonów Twojej przestrzeni roboczej. Każde żądanie wymaga unikalnego Idempotency-Key; ponowne wysłanie tego samego klucza zwraca to samo połączenie zamiast wybierać numer dwa razy.
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 jest wymagane, gdy przestrzeń robocza ma więcej niż jeden numer telefonu. variables wypełniają symbole zastępcze w stylu {{customer_name}} w pierwszej wiadomości i prompcie agenta.
Przy włączonym voicemail_detection (domyślnie) połączenie wychodzące czeka, aż druga strona się odezwie, zanim agent się przywita; jeśli ta milczy, agent wita się po dwóch–trzech sekundach. Gdy agent usłyszy pocztę głosową lub nagranie operatora, czeka, aż powitanie i sygnał się skończą, zostawia voicemail_message albo się rozłącza, jeśli go nie ma. Takie połączenia kończą się z ended_reason voicemail, są rozliczane za czas, jaki trwały, i nie są analizowane ani zgłaszane w powiadomieniach.
W kampanii numer, który trafił na pocztę głosową, jest ponawiany jak ten, który nie odebrał, a wiadomość jest zostawiana dopiero przy ostatniej próbie, żeby nikt nie dostał tej samej wiadomości dwa razy.
Każde połączenie wychodzące, z kampanii lub z POST /api/v1/voice/calls, najpierw sprawdza listę „Nie dzwonić” przestrzeni roboczej. Numer z listy nigdy nie jest wybierany: API odpowiada 409 z code do_not_call, a kampania oznacza kontakt jako canceled z outcome do_not_call i przechodzi do następnego.
Gdy osoba w połączeniu wykonanym przez agenta prosi, by więcej do niej nie dzwonić, agent sam wpisuje jej numer na listę, mówi jej o tym i wysyłany jest webhook call.do_not_call. Numery można też dodawać i usuwać w Kampanie → Lista „Nie dzwonić” lub przez 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" }'
Numery podaje się w formacie międzynarodowym; do 1000 naraz. GET /api/v1/voice/do-not-call wyświetla je od najnowszych (search, limit, page), każdy z source (call, dashboard lub api). DELETE /api/v1/voice/do-not-call/%2B14155550100 ponownie zdejmuje numer z listy; rób to tylko wtedy, gdy osoba zgodziła się na telefony.