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

Callback call API

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

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

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

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

אם המופע שלכם משולב עם Salesforce, בדקו את ההגדרה Closed record options when initiating an API-scheduled call בקטע Settings > Operation Management > CRM Record Creation Details. בקשות לתזמון נדחות עם השגיאה 422 כשהאפשרות לא לבדוק את סטטוס הרשומה נבחרת. ההגדרה הזו לא חלה על Zendesk או ServiceNow.

כדי לתזמן שיחה, מתקשרים אל 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. מציינים את המזהה של השיחה שרוצים לבטל.

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

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

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

דוגמת קוד:

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

אם הבקשה מצליחה, מוחזרת תשובה עם כותרת תשובה שמכילה כתובת URL מסוג Location לבדיקת סטטוס הביטול.

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

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

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

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

רשומה פתוחה וכבר יש בה שיחה מתוזמנת פעילה: אם חיפוש מזהה הפנייה מציין שהרשומה פתוחה וכבר יש בה שיחה מתוזמנת פעילה, השיחה לא מתוזמנת. התגובה הבאה מצורפת לרשומת ה-CRM: ‏A scheduled call was not created because the record already has an active scheduled call.
לא ניתן להגיע ל-CRM: אם בדיקת מזהה הכרטיס מציינת שלא ניתן להגיע ל-CRM, השיחה מבוטלת. התגובה הבאה מצורפת לרשומת ה-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 כך שהיא לא תבדוק את סטטוס הרשומה לפני ביצוע שיחה מתוזמנת. כשהאפשרות הזו מסומנת, בקשות לתזמון שיחה באמצעות ה-API של שיחות חוזרות נדחות עם השגיאה 422.

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

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

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

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

השיחה מתבצעת לפי התזמון.
הרשומה נפתחת מחדש.
התגובה הבאה מצורפת לרשומת ה-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.
בוחרים באפשרות בדיקת סטטוס הרשומה. אם הרשומה סגורה > מבטלים את השיחה המתוזמנת.
לוחצים על שמירה של הגדרות כלליות.