נקודות קצה של זמני המתנה

‫Contact Center AI Platform‏ (CCAI Platform) מספקת את נקודת הקצה Wait time כדי לקבל את זמני ההמתנה הנוכחיים לתורים של סוגי ערוצים שונים.

זמן המתנה

פרמטר חובה סוג הנתונים הגדרה
lang TRUE String קוד השפה של התור. (למשל, 'en')
menu_id לא נכון מספר שלם התשובה תסנן את כל התפריטים בעץ המשנה של התפריט הזה, כולל התפריט עצמו.
menu_type לא נכון String מחזירה תפריטים מסוגים ספציפיים. ערכים אפשריים: ivr_menu, mobile_menu, web_menu).
channel_type לא נכון String מחזירה את התפריטים של ערוץ ספציפי. ערכים אפשריים: voice_call, chat).
wait[from] לא נכון מספר שלם הפונקציה מחזירה רשומות אם זמן ההמתנה שלהן גדול מהערך.
wait[to] לא נכון מספר שלם הפונקציה מחזירה רשומות אם זמן ההמתנה שלהן קטן מהערך.

נקודת קצה (endpoint):

Method: GET
Type: 
URL: https://{{subdomain}}.{{domain}}/apps/api/v1/wait_times

כותרות:

מפתח ערך תיאור
סוג התוכן application/json

דוגמה לבקשה ולתשובות

בקטעים הבאים מופיעות דוגמאות לבקשות לנקודת הקצה.

זמני המתנה בתורים לנייד

בדוגמה הזו מוסבר איך לאחזר את זמני ההמתנה לתורים בנייד.

בקשה

כותרות:

מפתח ערך תיאור
סוג התוכן application/json

שאילתה:

מפתח ערך תיאור
lang iw
menu_type mobile_menu

Body: None

תשובה: זמני המתנה לתורים לנייד
[
    {
        "menu_id": 29,
        "menu_type": "mobile_menu",
        "chat": 10,
        "voice_call": 10,
        "materialized_path": "Laptop",
        "logged_in_agents": 3,
        "available_agents": 2,
        "breakthrough_agents": 1
    },
    {
        "menu_id": 42,
        "menu_type": "mobile_menu",
        "chat": 10,
        "voice_call": 10,
        "materialized_path": "Desktop",
        "logged_in_agents": 3,
        "available_agents": 2,
        "breakthrough_agents": 1
    },
    {
        "menu_id": 43,
        "menu_type": "mobile_menu",
        "chat": 10,
        "voice_call": 10,
        "materialized_path": "Smart Phone",
        "logged_in_agents": 3,
        "available_agents": 2,
        "breakthrough_agents": 1
    }
]

קוד הסטטוס: 200

זמני המתנה בין wait[from] לבין wait[to]

בדוגמה הזו מוצגות שיחות עם זמני המתנה בין הערכים wait from ו-wait to.

בקשה

כותרות:

מפתח ערך תיאור
סוג התוכן application/json

שאילתה:

מפתח ערך תיאור
lang iw
wait[from] 5
wait[to] 15

Body: None

תגובה: זמני המתנה בין wait[from] ל-wait[to]
[
    {
        "menu_id": 3,
        "menu_type": "web_menu",
        "chat": 10,
        "voice_call": 10,
        "materialized_path": "Web App",
        "logged_in_agents": 3,
        "available_agents": 2,
        "breakthrough_agents": 1
    },
    {
        "menu_id": 29,
        "menu_type": "mobile_menu",
        "chat": 10,
        "voice_call": 10,
        "materialized_path": "Laptop",
        "logged_in_agents": 3,
        "available_agents": 2,
        "breakthrough_agents": 1
    },
    {
        "menu_id": 42,
        "menu_type": "mobile_menu",
        "chat": 10,
        "voice_call": 10,
        "materialized_path": "Desktop",
        "logged_in_agents": 3,
        "available_agents": 2,
        "breakthrough_agents": 1
    },
    {
        "menu_id": 44,
        "menu_type": "web_menu",
        "chat": 10,
        "voice_call": 10,
        "materialized_path": "Mobile App",
        "logged_in_agents": 3,
        "available_agents": 2,
        "breakthrough_agents": 1
    },
    {
        "menu_id": 43,
        "menu_type": "mobile_menu",
        "chat": 10,
        "voice_call": 10,
        "materialized_path": "Smart Phone",
        "logged_in_agents": 3,
        "available_agents": 2,
        "breakthrough_agents": 1
    }
]

קוד הסטטוס: 200

זמני המתנה לשיחות קוליות בתורים לנייד גדולים מ-5 שניות

בדוגמה הזו מוסבר איך לאחזר את השיחות הקוליות בנייד עם זמן המתנה של יותר מ-5 שניות.

בקשה

כותרות:

מפתח ערך תיאור
סוג התוכן application/json

שאילתה:

מפתח ערך תיאור
lang iw
menu_type mobile_menu
channel_type voice_call
wait[from] 5

Body: None

תגובה: זמני המתנה לשיחות קוליות בתורים לנייד גדולים מ-5 שניות
[
    {
        "menu_id": 29,
        "menu_type": "mobile_menu",
        "voice_call": 10,
        "materialized_path": "Laptop",
        "logged_in_agents": 3,
        "available_agents": 2,
        "breakthrough_agents": 1
    },
    {
        "menu_id": 42,
        "menu_type": "mobile_menu",
        "voice_call": 10,
        "materialized_path": "Desktop",
        "logged_in_agents": 3,
        "available_agents": 2,
        "breakthrough_agents": 1
    },
    {
        "menu_id": 43,
        "menu_type": "mobile_menu",
        "voice_call": 10,
        "materialized_path": "Smart Phone",
        "logged_in_agents": 3,
        "available_agents": 2,
        "breakthrough_agents": 1
    }
]

קוד הסטטוס: 200

זמני המתנה לתפריט ספציפי

בדוגמה הזו מוסבר איך לאחזר את זמני ההמתנה למזהה תפריט ספציפי.

בקשה

כותרות:

מפתח ערך תיאור
סוג התוכן application/json

שאילתה:

מפתח ערך תיאור
lang iw
menu_id 9

Body: None

תשובה: זמני המתנה לתפריט ספציפי
[
    {
        "menu_id": 9,
        "menu_type": "ivr_menu",
        "voice_call": 10,
        "materialized_path": "Death Star",
        "logged_in_agents": 3,
        "available_agents": 2,
        "breakthrough_agents": 1
    }
]

קוד הסטטוס: 200

זמני המתנה לכל השיחות ב-Voice

בדוגמה הזו מוסבר איך לאחזר את זמני ההמתנה של כל השיחות הקוליות הנוכחיות.

בקשה

כותרות:

מפתח ערך תיאור
סוג התוכן application/json

שאילתה:

מפתח ערך תיאור
lang iw
channel_type voice_call

Body: None

תגובה: זמני המתנה לכל שיחות הקול
[
    {
        "menu_id": 3,
        "menu_type": "web_menu",
        "voice_call": 10,
        "materialized_path": "Web App",
        "logged_in_agents": 3,
        "available_agents": 2,
        "breakthrough_agents": 1
    },
    {
        "menu_id": 9,
        "menu_type": "ivr_menu",
        "voice_call": 10,
        "materialized_path": "Death Star",
        "logged_in_agents": 3,
        "available_agents": 2,
        "breakthrough_agents": 1
    },
    {
        "menu_id": 29,
        "menu_type": "mobile_menu",
        "voice_call": 10,
        "materialized_path": "Laptop",
        "logged_in_agents": 3,
        "available_agents": 2,
        "breakthrough_agents": 1
    },
    {
        "menu_id": 41,
        "menu_type": "ivr_menu",
        "voice_call": 10,
        "materialized_path": "Lock Star",
        "logged_in_agents": 3,
        "available_agents": 2,
        "breakthrough_agents": 1
    },
    {
        "menu_id": 42,
        "menu_type": "mobile_menu",
        "voice_call": 10,
        "materialized_path": "Desktop",
        "logged_in_agents": 3,
        "available_agents": 2,
        "breakthrough_agents": 1
    },
    {
        "menu_id": 44,
        "menu_type": "web_menu",
        "voice_call": 10,
        "materialized_path": "Mobile App",
        "logged_in_agents": 3,
        "available_agents": 2,
        "breakthrough_agents": 1
    },
    {
        "menu_id": 43,
        "menu_type": "mobile_menu",
        "voice_call": 10,
        "materialized_path": "Smart Phone",
        "logged_in_agents": 3,
        "available_agents": 2,
        "breakthrough_agents": 1
    }
]

קוד הסטטוס: 200

זמני המתנה בתורים באנגלית

בדוגמה הזו מוסבר איך לאחזר את כל זמני ההמתנה בתורים שבהם השפה היא אנגלית.

בקשה

כותרות:

מפתח ערך תיאור
סוג התוכן application/json

שאילתה:

מפתח ערך תיאור
lang iw

Body: None

תשובה: זמני המתנה בתורים באנגלית
[
    {
        "menu_id": 3,
        "menu_type": "web_menu",
        "chat": 10,
        "voice_call": 10,
        "materialized_path": "Web App",
        "logged_in_agents": 3,
        "available_agents": 2,
        "breakthrough_agents": 1
    },
    {
        "menu_id": 9,
        "menu_type": "ivr_menu",
        "voice_call": 10,
        "materialized_path": "Death Star",
        "logged_in_agents": 3,
        "available_agents": 2,
        "breakthrough_agents": 1
    },
    {
        "menu_id": 29,
        "menu_type": "mobile_menu",
        "chat": 10,
        "voice_call": 10,
        "materialized_path": "Laptop",
        "logged_in_agents": 3,
        "available_agents": 2,
        "breakthrough_agents": 1
    },
    {
        "menu_id": 41,
        "menu_type": "ivr_menu",
        "voice_call": 10,
        "materialized_path": "Lock Star",
        "logged_in_agents": 3,
        "available_agents": 2,
        "breakthrough_agents": 1
    },
    {
        "menu_id": 42,
        "menu_type": "mobile_menu",
        "chat": 10,
        "voice_call": 10,
        "materialized_path": "Desktop",
        "logged_in_agents": 3,
        "available_agents": 2,
        "breakthrough_agents": 1
    },
    {
        "menu_id": 44,
        "menu_type": "web_menu",
        "chat": 10,
        "voice_call": 10,
        "materialized_path": "Mobile App",
        "logged_in_agents": 3,
        "available_agents": 2,
        "breakthrough_agents": 1
    },
    {
        "menu_id": 43,
        "menu_type": "mobile_menu",
        "chat": 10,
        "voice_call": 10,
        "materialized_path": "Smart Phone",
        "logged_in_agents": 3,
        "available_agents": 2,
        "breakthrough_agents": 1
    }
]

קוד הסטטוס: 200