Open in
התחברות מ-Talkdesk
העבירו שיחות מ-Talkdesk לסוכן ThunderPhone באמצעות Connect to Autopilot Voice, והסלימו אותן בחזרה באמצעות מזהה ההעברה ב-UUI.
זרימת Talkdesk Studio שלכם שולחת את המתקשר לסוכן עם מזהה האינטראקציה ו-UUI. כאשר המתקשר זקוק לאדם, הסוכן מסלים את השיחה באמצעות SIP
REFER אל Talkdesk, ומזהה ההעברה מגיע למשתנה ב-Studio.
לפני שמתחילים
- סוכן ThunderPhone ומפתח API של הארגון.
- רישיון מתאם שיחות של Talkdesk, הכולל את הרכיב התחברות ל-Autopilot קולי במצב זרם קול חיצוני (המאמר של Talkdesk). Talkdesk מחייבת לפי דקה בזמן שהסוכן מחזיק את השיחה.
1. יצירת נקודת הקצה של SIP
Talkdesk מתעדת רק רשימת היתרים של כתובות IP, לכן צרו נקודת קצה שמקבלת שיחות לפי כתובת המקור:
curl -X POST https://api.thunderphone.com/v1/sip-endpoints \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"agent_id": 12,
"name": "Talkdesk",
"auth": "ip_allowlist",
"allowed_source_cidrs": ["TALKDESK_SIGNALLING_RANGE_1", "TALKDESK_SIGNALLING_RANGE_2"],
"srtp": "optional"
}'המאמר של Talkdesk מציין שהיא שולחת שמע דרך SRTP, ו-"srtp": "optional"
משיב באמצעות SRTP כאשר Talkdesk מציעה אותו. המאמר אינו מציין אם Talkdesk
מחייבת SRTP; אם Talkdesk מודיעה לכם שכן, הגדירו את srtp כ-required, אשר
דוחה שיחות בלעדיו.
קבלו את טווחי האיתות SIP של Talkdesk מ-Talkdesk. כל טווח חייב להיות טווח IPv4
ציבורי של /16 או מצומצם יותר (IPv6 של /48 או מצומצם יותר). ראו
פלטפורמות שמאמתות לפי כתובת IP של המקור.
Talkdesk שולחת SIP מרשת Twilio, שכתובותיה משותפות לכל לקוחות Twilio,
לכן כתובת נקודת הקצה היא שמונעת ממתקשרים אחרים להיכנס: אל תפרסמו אותה.
שמרו את sip_uri מהתגובה, לדוגמה
sip:agent-12-jhxmginwjx@sip.thunderphone.com.
2. שליחת שיחות עם הקשר
בזרימת Studio שלכם, הוסיפו את התחברות ל-Autopilot קולי במצב זרם קול
חיצוני והגדירו את היעד שלו כ-sip_uri של נקודת הקצה עם ;transport=tls נוסף, לדוגמה
sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls. נקודת הקצה
דוחה שיחות דרך UDP, שבו SIP של Twilio משתמש אלא אם מציינים אחרת.
Talkdesk שולחת:
X-Talkdesk-Interaction-Id, המאוחסן כ-external_call_idשל השיחה;User-to-User, מקודד בהקסדצימלי, כגוןbusiness_hours=open. הוא מגיע אל ההנחיה לאחר פענוח, כ-{{sip_uui}}.
גרסה 2.1 של הרכיב יכולה גם לשלוח כותרות מוגדרות. דף ההעדפות של Talkdesk מתאר אותן כ-JSON שנשלח דרך WebSocket, לכן ודאו מול Talkdesk אם הן מגיעות ככותרות SIP לפני שתסתמכו עליהן.
3. קבלו את השיחה בחזרה
הסוכן מסלים באמצעות REFER לכתובת ההסלמה של Talkdesk, עם מזהה ההעברה כ-UUI הקסדצימלי בתוך אותה כתובת, המקום היחיד שבו Talkdesk קוראת אותו.
הוסיפו את מספר ההעברה הזה (ראו
הוספת מספר ההעברה
ו-כותרות בתוך כתובת ההעברה):
{
"name": "Talkdesk escalation",
"number": "sip:escalation@talkdesk.com",
"headers": {"User-to-User": "autopilot_result={{handoff_id}}"},
"headers_in_uri": true,
"uui_encoding": "hex"
}הכתובת היא זו שמופיעה במאמר של Talkdesk. גרסה 2.1 של הרכיב
קוראת את autopilot_result=; גרסה 1.7 קוראת את escalate_to=, לכן השתמשו במפתח זה
בגרסה 1.7. ה-REFER נראה כך:
Refer-To: <sip:escalation@talkdesk.com?User-to-User=6175746F70696C6F745F726573756C743D...%3Bencoding%3Dhex>
Talkdesk מציבה את הערך במשתנה של Studio. כדי לקבל את הסיכום והכוונה, הוסיפו שלב ביצוע פעולה באינטגרציה מותאמת אישית שנבנתה באמצעות חיבורים:
- סוג אימות: מפתח API, שם הכותרת
Authorization, ערךBearer sk_live_…. - בקשה:
GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=ולאחריה המזהה מהמשתנה. תוכלו גם לאתר את השיחה לפיexternal_call_idבאמצעות מזהה האינטראקציה. - נווטו לפי
handoff.intent, והציגו אתhandoff.summaryלאדם שמקבל את השיחה.
ראו איתור שיחה שהועברה.
בדקו זאת
התחילו שיחה דרך זרימת Studio, בקשו מהסוכן נציג, ובדקו
שהזרימה ממשיכה מעבר לרכיב עם מזהה ההעברה במשתנה שלו. לאחר מכן פתחו את השיחה עם
GET /v1/calls/{call_id}:
external_call_id צריך להיות מזהה האינטראקציה של Talkdesk.
מגבלות
- Talkdesk קוראת לכל היותר 256 בתים של UUI ואינה מאפשרת ערכים המופרדים באמצעות
|או;, לכן שלחו ערך יחיד. מזהה ההעברה מתאים. - ממשקי ה-API של Talkdesk אינם יכולים לקרוא את תמליל הסוכן. השתמשו במקום זאת באיתור ההעברה או
ב-
GET /v1/calls/{call_id}.