איך מצרפים צד שלישי לשיחה

במאמר הזה מוסבר איך להשתמש בנקודת הקצה (endpoint) /calls/CALL_ID/dial של ה-API של האפליקציות כדי להתקשר לצד שלישי ולהוסיף אותו לשיחה פעילה. כששולחים בקשה לנקודת הקצה הזו, המערכת מחייגת אוטומטית למספר הטלפון של הצד השלישי, ובכלי הטלפון של הנציג מוצג המסך Calling. הוספת צדדים שלישיים לשיחות בדרך הזו פועלת גם אם כלי הטלפון פועל במחשב של הנציג, במערכת לניהול קשרי הלקוחות (CRM) או בפורטל של פלטפורמת CCAI. כדי שהנקודה הזו תפעל, הנציג צריך להיות בשיחה פעילה.

קריאה לנקודת הקצה (endpoint)

כדי להוסיף צד שלישי לשיחה, שולחים בקשת POST לנקודת הקצה הבאה:

https://YOUR_CCAAS_HOST/apps/api/v1/calls/CALL_ID/dial

מחליפים את CALL_ID במזהה השיחה.

גוף הבקשה

דוגמה לגוף בקשה:

{
  "agent_email": "AGENT_EMAIL",
  "phone_number": "PHONE_NUMBER"
}

מחליפים את מה שכתוב בשדות הבאים:

• ‫AGENT_EMAIL: כתובת האימייל של הנציג בשיחה.
• ‫PHONE_NUMBER: מספר הטלפון של הצד השלישי שרוצים להוסיף לשיחה.

תשובה

הפלט אמור להיראות כך:

תגובת הצלחה

{
    "message": "Third party dialing initiated",
    "participant": {
        "id": 54321,
        "type": "third_party",
        "status": "connecting"
    }
}

תגובות שגיאה

• ‫400 Bad Request – חסר ערך או שהערך ריק בשדה phone_number או agent_email. טקסט: {"message": "param is missing or the value is empty: <name>"}.
• 400 Bad Request – agent_email לא תואם למשתמש מוכר. גוף ההודעה: {"message": "Invalid agent_email"}.
• 401 Unauthorized – האימות נכשל. גוף ההודעה: {"message": "Not Authorized"}.
• ‫404 Not Found – לא קיימת שיחה עם ה-call_id שסופק. גוף ההודעה: {"message": "Not Found"}.
• ‫422 Unprocessable Entity – הסוכן שזוהה באמצעות agent_email לא מחובר לשיחה. גוף ההודעה: {"message": "Agent is not connected to the call"}.
• ‫422 Unprocessable Entity – לא ניתן היה להתחיל את החיוג. כולל כשלים בנרמול של מספר הטלפון ושגיאות בהתחלת החיוג של הספק. טקסט: {"message": "Error dialing third party"}.
• ‫500 Internal Server Error – שגיאה לא צפויה במהלך החיוג. גוף ההודעה: {"message": "Unexpected error dialing third party"}.