Çalışma alanınızın telefon numaralarından birinden tek bir arama yapın. Her istek benzersiz bir Idempotency-Key gerektirir; aynı anahtarı yeniden göndermek iki kez aramak yerine aynı aramayı döndürür.
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" }
}'
Çalışma alanında birden fazla telefon numarası varsa from zorunludur. variables, ajanın ilk mesajındaki ve isteminde yer alan {{customer_name}} gibi yer tutucuları doldurur.
voicemail_detection açıkken (varsayılan) giden arama, ajan selam vermeden önce karşı tarafın konuşmasını bekler; sessiz kalırlarsa ajan iki üç saniye sonra selam verir. Ajan bir telesekreter ya da bir telefon şirketinin kaydını duyduğunda karşılamanın ve bip sesinin bitmesini bekler, voicemail_message mesajını bırakır, yoksa telefonu kapatır. Bu tür aramalar ended_reason değeri voicemail ile biter, sürdükleri süre kadar faturalanır ve analiz edilmez, bildirilmez.
Bir kampanyada telesekretere ulaşan bir numara, açmayan bir numara gibi yeniden aranır ve mesaj yalnızca son denemede bırakılır; böylece kimse aynı mesajı iki kez almaz.
Her giden arama, bir kampanyadan veya POST /api/v1/voice/calls ile yapılmış olsun, önce çalışma alanının aranmayacaklar listesine bakar. Listedeki bir numara asla aranmaz: API do_not_call code değeriyle 409 yanıtı verir ve kampanya kişiyi canceled olarak ve outcome do_not_call ile işaretler ve bir sonrakine geçer.
Ajanın yaptığı bir aramadaki kişi bir daha aranmak istemediğini söylediğinde ajan numarayı kendisi listeye ekler, bunu kişiye söyler ve call.do_not_call webhook'u gönderilir. Numaralar ayrıca Kampanyalar → Aranmayacaklar listesi altında veya API ile eklenip çıkarılabilir:
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" }'
Numaralar uluslararası biçimdedir; tek seferde en fazla 1.000. GET /api/v1/voice/do-not-call bunları en yenisi başta olacak şekilde listeler (search, limit, page), her biri source değeriyle (call, dashboard veya api). DELETE /api/v1/voice/do-not-call/%2B14155550100 birini yeniden listeden çıkarır; bunu yalnızca kişi aranmayı kabul ettiğinde yapın.