Callback call API

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

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

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

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

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

דוגמת קוד:

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

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

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

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

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

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

שיחות עם התקשרות חוזרת ב-Salesforce

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

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

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

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

  1. בפורטל של CCAI Platform, לוחצים על הגדרות > ניהול פעולות. אם תפריט ההגדרות לא מופיע, לוחצים על תפריט.

  2. עוברים אל פרטים על יצירת רשומה ב-CRM > אפשרויות של רשומה סגורה כשמתחילים שיחה מתוזמנת ב-API.

  3. בוחרים באפשרות אל תבדוק את סטטוס הרשומה. תמיד צריך ליזום את הקריאה המתוזמנת ל-API.

  4. לוחצים על שמירה של הגדרות כלליות.

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

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

  • השיחה מתבצעת לפי התזמון.

  • הרשומה תיפתח מחדש.

  • התגובה הבאה מצורפת לרשומה ב-CRM: The record was reopened at the time of a scheduled call.

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

  1. בפורטל של CCAI Platform, לוחצים על הגדרות > ניהול פעולות. אם תפריט ההגדרות לא מופיע, לוחצים על תפריט.

  2. עוברים אל פרטים על יצירת רשומה ב-CRM > אפשרויות של רשומה סגורה כשמתחילים שיחה מתוזמנת ב-API.

  3. בוחרים באפשרות בדיקת סטטוס הרשומה. אם הרשומה סגורה > פותחים מחדש את הרשומה.

  4. לוחצים על שמירה של הגדרות כלליות.

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

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

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

  • התגובה הבאה מצורפת לרשומה ב-CRM: A scheduled call was canceled because the record is closed.

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

  1. בפורטל של CCAI Platform, לוחצים על הגדרות > ניהול פעולות. אם תפריט ההגדרות לא מופיע, לוחצים על תפריט.

  2. עוברים אל פרטים על יצירת רשומה ב-CRM > אפשרויות של רשומה סגורה כשמתחילים שיחה מתוזמנת ב-API.

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

  4. לוחצים על שמירה של הגדרות כלליות.