ThunderPhone v3 כבר באוויר.בשירות עצמי, החל מ-2¢/דקה.קראו את הודעת ההשקה

Contact centers

התחברות מ-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}.