בצעו שיחה אחת מאחד ממספרי הטלפון של מרחב העבודה שלכם. כל בקשה זקוקה ל-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 וממשיך לבא.
כשהאדם בשיחה שהסוכן ביצע מבקש שלא יתקשרו אליו שוב, הסוכן מוסיף את המספר שלו לרשימה בעצמו, אומר לו זאת, וה-Webhook בשם 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" }'
המספרים בפורמט בין-לאומי; עד 1,000 בכל פעם. GET /api/v1/voice/do-not-call מציג אותם, החדשים ראשונים (search, limit, page), כל אחד עם source שלו (call, dashboard או api). DELETE /api/v1/voice/do-not-call/%2B14155550100 מסיר אחד מהרשימה; עשו זאת רק כשהאדם הסכים שיתקשרו אליו.