‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

Callback call API

שיחות חוזרות הן שיחות שמשתמשי קצה מבקשים. באמצעות ה-API של שיחות חוזרות, אתם יכולים לתזמן שיחות חוזרות ולבטל שיחות מתוזמנות באופן פרוגרמטי. בעזרת היכולות האלה, אתם יכולים ליצור אפליקציות שמאפשרות למשתמשי קצה לבקש שיחות חוזרות מתור שאתם מציינים. משתמשי קצה יכולים גם לבטל שיחות שהם קבעו בעבר. למידע על אימות באמצעות ה-API של שיחת ה-callback, ראו אימות בסיסי.

שימוש ב-API של שיחות חוזרות

אתם יכולים להשתמש ב-API של שיחות חוזרות כדי לתזמן שיחות חוזרות ולבטל שיחות מתוזמנות.

תיאום שעה לשיחה

כדי לקבוע שיחה, צריך להתקשר אל POST https://<subdomain>.<domain>/apps/api/v1/calls ולכלול גוף בקשה שדומה לדוגמה הבאה:

{
    "call_type": "ScheduledCall",
    "menu_id": 12345,
    "end_user_number": "+18005550100",
    "scheduled_at": "2025-09-02T14:30:00Z"
}

אם הבקשה תצליח, יוחזר אובייקט שיחה, כולל מזהה השיחה.

ביטול שיחה מתוזמנת

כדי לבטל שיחה שנקבעה, צריך להתקשר למספר PATCH https://<subdomain>.<domain>/apps/api/v1/calls/scheduled/{id}/cancel. מציינים את המזהה של השיחה שרוצים לבטל.

אם הבקשה תצליח, יוחזר קוד 200 OK עם אובייקט השיחה המעודכן. הערך של status באובייקט השיחה הוא cancelled כשהשיחה ממתינה למועד שנקבע לה או כשהיא נכנסת לתור או ממתינה בו, והערך הוא completed כשמבטלים שיחה חוזרת פעילה של נציג וירטואלי שכבר ביצע את ניסיון החיוג הראשון. אם השיחה כבר בוטלה, הבקשה מחזירה את הערך 204 No Content עם גוף ריק. בקשה לשיחה שכבר נכשלה מסיבה אחרת, או שהיא במצב שלא ניתן לבטל, מחזירה את הערך 400.

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

כדי לבטל כמה שיחות מתוזמנות, צריך להתקשר למספר PATCH https://<subdomain>.<domain>/apps/api/v1/calls/scheduled/cancel. מוסיפים גוף בקשה שמכיל מערך call_ids של מזהי השיחות שרוצים לבטל.

דוגמת קוד:

{
    "call_ids": [123, 456, 789]
}

בקשה מוצלחת מחזירה את הערך 202 Accepted עם כותרת תגובה Location שמפנה למשאב של משימה שאפשר לדגום כדי לבדוק אם היא הושלמה. התגובה 202 Accepted לא אומרת שכל השיחות בוטלו. צריך לעקוב אחרי הכותרת Location כדי לוודא שהפעולה הושלמה ולבדוק אם היו כשלים חלקיים.

שימוש בשיחות חוזרות עם מערכות CRM

אתם יכולים להשתמש ב-API של שיחות חוזרות עם שילובים של מערכות CRM של Salesforce,‏ Zendesk ו-ServiceNow.

התנהגות כללית של קריאה חוזרת (callback)

אם אתם משתמשים במערכת CRM נתמכת (Salesforce,‏ Zendesk או ServiceNow), התנאים הבאים משפיעים על ההתנהגות של בקשות חוזרות מתוזמנות:

רשומה פתוחה וכבר יש בה שיחה מתוזמנת פעילה: אם חיפוש מזהה הפנייה מציין שהרשומה פתוחה וכבר יש בה שיחה מתוזמנת פעילה, השיחה לא מתוזמנת. התגובה הבאה מצורפת לרשומת ה-CRM: ‏A scheduled call was not created because the record already has an active scheduled call.
אין גישה למערכת לניהול קשרי לקוחות: אם חיפוש של מזהה פנייה מצביע על כך שאין גישה למערכת לניהול קשרי לקוחות, השיחה מבוטלת. התגובה הבאה מצורפת לרשומת ה-CRM: ‏A scheduled call was canceled because the CRM was unreachable.

התנהגות של שיחה חוזרת עם רשומות סגורות

האופן שבו המערכת מטפלת בשיחות חוזרות ברשומות סגורות משתנה בהתאם למערכת ה-CRM שבה אתם משתמשים:

משתמשי Zendesk ו-ServiceNow: אם חיפוש של מזהה פנייה מציין שהרשומה סגורה, השיחה לא נקבעת. התגובה הבאה מצורפת לרשומת ה-CRM: ‏A scheduled call was not created because the record is closed.
משתמשי Salesforce: במאמר Callback calls with Salesforce מוסבר איך להגדיר את המכונה כך שתטפל בשיחות מתוזמנות לרשומות סגורות.

שיחות חוזרות עם Salesforce

אם שילבתם את פלטפורמת CCAI עם Salesforce, אתם יכולים להגדיר איך המכונה תטפל בשיחות מתוזמנות לרשומות סגורות. אלה אפשרויות ההגדרה של שילובים עם Salesforce:

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

לא לבדוק את סטטוס הרשומה

אתם יכולים להגדיר את פלטפורמת CCAI כך שהיא לא תבדוק את סטטוס הרשומה לפני ביצוע שיחה מתוזמנת. בהגדרה הזו, השיחה מתבצעת לפי התזמון, גם אם הרשומה פתוחה וגם אם היא סגורה.

כדי להגדיר את פלטפורמת CCAI כך שלא תבדוק את סטטוס הרשומה, פועלים לפי השלבים הבאים:

בפורטל של CCAI Platform, לוחצים על Settings > Operation Management. אם תפריט ההגדרות לא מופיע, לוחצים על תפריט.
עוברים אל פרטי יצירת רשומת CRM > אפשרויות של רשומות סגורות כשמתחילים שיחה שתוזמנה באמצעות API.
בוחרים באפשרות לא לבדוק את סטטוס הרשומה. תמיד צריך להפעיל את הקריאה המתוזמנת ל-API.
לוחצים על שמירת ההגדרות הכלליות.

לבדוק את סטטוס הרשומה ולפתוח מחדש רשומות סגורות

אתם יכולים להגדיר את פלטפורמת CCAI כך שתבדוק את סטטוס הרשומה לפני ביצוע שיחה מתוזמנת, ותפתח מחדש רשומות סגורות. בהגדרה הזו, אם סטטוס הרשומה הוא closed, מתבצעות הפעולות הבאות:

השיחה מתבצעת לפי התזמון.
הרשומה נפתחת מחדש.
התגובה הבאה מצורפת לרשומת ה-CRM: ‏The record was reopened at the time of a scheduled call.

כדי להגדיר את פלטפורמת CCAI לבדוק את סטטוס הרשומה ולפתוח מחדש רשומות סגורות, פועלים לפי השלבים הבאים:

בפורטל של CCAI Platform, לוחצים על Settings > Operation Management. אם תפריט ההגדרות לא מופיע, לוחצים על תפריט.
עוברים אל פרטי יצירת רשומת CRM > אפשרויות של רשומות סגורות כשמתחילים שיחה שתוזמנה באמצעות API.
בוחרים באפשרות בדיקת סטטוס הרשומה. אם הרשומה סגורה > פותחים מחדש את הרשומה.
לוחצים על שמירת ההגדרות הכלליות.

בדיקת הסטטוס של הרשומה וביטול שיחות מתוזמנות ברשומות סגורות

אתם יכולים להגדיר את פלטפורמת CCAI כך שתבדוק את סטטוס הרשומה לפני ביצוע שיחה מתוזמנת, ותבטל שיחות מתוזמנות לרשומות שנסגרו. בהגדרה הזו, אם סטטוס הרשומה הוא closed, מתבצעות הפעולות הבאות:

השיחה שנקבעה מבוטלת.
התגובה הבאה מצורפת לרשומת ה-CRM: ‏A scheduled call was canceled because the record is closed.

כדי להגדיר את פלטפורמת CCAI כך שתבדוק את סטטוס הרשומה ותבטל שיחות מתוזמנות לרשומות סגורות, מבצעים את השלבים הבאים:

בפורטל של CCAI Platform, לוחצים על Settings > Operation Management. אם תפריט ההגדרות לא מופיע, לוחצים על תפריט.
עוברים אל פרטי יצירת רשומת CRM > אפשרויות של רשומות סגורות כשמתחילים שיחה שתוזמנה באמצעות API.
בוחרים באפשרות בדיקת סטטוס הרשומה. אם הרשומה סגורה > מבטלים את השיחה המתוזמנת.
לוחצים על שמירת ההגדרות הכלליות.