מדריך לחיבור והגדרת מרכזיה (PBX) במערכת אוריגמי


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

שלב 1: התקנת האפליקציה
 יש ליצור דף אפליקציה חדש ולבחור בהתקנת אפליקציית ה-PBX מבין האפשרויות- בדיוק כפי שמתקינים אפליקציות אחרות.

שלב 2: הגדרות טכניות (Configuration)
 לאחר ההתקנה, יש להגדיר את הפרמטרים הבאים בתוך האפליקציה:

Call Entry URL:
 כתובת URL של כניסת השיחה- זהו ה-Endpoint של אוריגמי שאליו נכנסים פרטי השיחה.

Take Call URL:
 כתובת URL של נטילת שיחה- זהו ה-Webhook של ספק המרכזייה. המערכת תשלח ללינק זה פרטים (כגון מספר טלפון או שלוחה) כדי להוציא שיחה. הלינק דינמי וניתן להטמיע בו שדות (כגון Extension או מספר טלפון).

Secret Key:
 מפתח אבטחה המשמש בקריאות API כדי להכניס נתונים מהמרכזייה לתוך אוריגמי.

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

שלב 3: זיהוי שיחה (Call ID Mapping)

 כדי שהמערכת תדע לזהות את המתקשר, יש להגדיר את מיפוי השדות:

בחירת ישות:
 בחרו את הישות שבה מופיעים אנשי הקשר (למשל “לידים” או “לקוחות”).

מיפוי שדות:
 הגדירו מהו שדה מספר הטלפון, השם הפרטי ושם המשפחה בישות שנבחרה.

התוצאה:
 כאשר נכנסת שיחה, המערכת תזהה אם מדובר בלקוח קיים (ותאפשר לפתוח את המופע שלו) או בלקוח חדש.

שלב 4: הגדרת ווידג’ט

כדי להציג את היסטוריית השיחות עם לקוח או ליד מסוים, נדרש להוסיף ווידג’ט ייעודי ביישות.

לצורך כך יש לגשת לשדות היישות ולהוסיף  Omni Widget:

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

לאחר ההגדרה, ברשומה יופיע הווידג’ט, ובהמשך יוצג בו התיעוד הרלוונטי של השיחות:

שלב 5: תפעול שיחות

  • שיחות נכנסות:
     עם כניסת שיחה, יופיע חיווי במערכת הכולל את שם המתקשר (אם זוהה). ניתן לעדכן סטטוסים של שיחה (למשל “Answered” או “Completed”) ישירות מהמרכזייה באמצעות ה-API.

  • הקלטות שיחה:
    ניתן להעביר מהמרכזייה לינק להקלטת השיחה (Record Link), שיופיע בלוג השיחות ויהיה ניתן להאזין לו בלחיצה.

  • הוצאת שיחה (Click to Call):
    לחיצה על כפתור הטלפון במערכת תשלח את המידע ל-Webhook של המרכזייה ותוציא את השיחה. במקרה שעובדים מהמובייל, הלחיצה תפעיל את החייגן של המכשיר.

שלב 6: ניהול ודוחות

נתוני השיחות נשמרים בתוך לוג השיחות של אפליקציית ה-PBX. ניתן להוסיף ווידג’ט בתוך ישות הלקוחות, שיציג את היסטוריית השיחות הרלוונטיות לאותו לקוח בלבד (באמצעות סינון לפי מספר הטלפון).

שיחות נכנסות והוצאת שיחות

שיחות נכנסות:

  1. יצירת שיחה / זיהוי שיחה נכנסת  (Incoming Call)
  • מטרה: להודיע למערכת על תחילת שיחה ולבצע זיהוי של המתקשר.
  • תיאור: המרכזייה שולחת קריאה ל-Endpoint של אוריגמי (Call URL) עם פרטים בסיסיים.
  • נתונים שנשלחים: מזהה שיחה (Call ID), מספר השלוחה, כיוון השיחה (נכנסת/יוצאת), והמספר המזוהה.
  • תוצאה באוריגמי: המערכת מקפיצה חיווי עם שם הליד/לקוח (אם זוהה במערכת) ומאפשרת לפתוח את המופע שלו ישירות מההתראה.
  • תיעוד קריאת API רלוונטית:

{
  “secret_key”: “a3d0491a4da10879fea05ed0c44db704a031706171”,
“call_id”: “442385”,
“extension”: “7777”,
“call_status”: “calling”,
  “call_sub_status”: “”,
“sending_type”: “incoming”,
“from”: “972523668571”,
“to”: “5678”
 }

  1.  עדכון סטטוס למענה  (Answered)
  • מטרה: לעדכן שיחה קיימת שהשיחה נענתה.
  • תיאור: כאשר הנציג עונה לשיחה, המרכזייה שולחת קריאת עדכון נוספת.
  • נתונים שנשלחים: הסטטוס המעודכן (״Answered״, ״Rejected״ או ״Busy״) המשויך לאותו Call ID.
  • תוצאה באוריגמי: סטטוס השיחה בלוג משתנה ל “ongoing”  , בביצוע, ומתועד זמן תחילת השיחה (Start Time).
  • תיעוד קריאת API רלוונטית:

{
“secret_key”: “a3d0491a4da10879fea05ed0c44db704a031706171”,
“call_id”: “442385”,
“extension”: “7777”,
“call_status”: “answered”,
“call_sub_status”: “”,
“sending_type”: “incoming”,
“from”: “972523668571”,
“to”: “5678”,
“call_start_time”: “1765360918”
}


 סיום שיחה וסיכום נתונים  (Completed)

  • מטרה: לסגור את רישום השיחה ולתעד את פרטי השיחה וההקלטה.
  • תיאור: עם ניתוק השיחה, המרכזייה תשלח קריאה סופית המכילה את נתוני הסיכום מהמרכזייה על בסיס הפורמט.
  • נתונים שנשלחים:
    • סטטוס סופי: Completed.
    • משך השיחה (Duration).
    • לינק להקלטה (Record Link): קישור לקובץ השמע שנשמר בשרתי המרכזייה.
  • תוצאה באוריגמי: השיחה בלוג נסגרת כשיחה שהושלמה, ומופיע לינק המאפשר להאזין להקלטה ישירות מתוך אוריגמי.
  • תיעוד קריאת API רלוונטית:

{
“secret_key”: “a3d0491a4da10879fea05ed0c44db704a031706171”,
“call_id”: “442385”,
“extension”: “7777”,
“call_status”: “answered”,
“call_sub_status”: “call_completed”,
“sending_type”: “incoming”,
“from”: “972523668571”,
“to”: “5678”,
“call_end_time”: “1765360921”,
“call_duration”: “00:00:03”,
“call_recording_link”: “https://www.google.com”
}


הוצאת שיחה (Click to Call):

  • מטרה: ליזום שיחה מהמערכת למרכזייה.
  • תיאור: בלחיצה על כפתור הטלפון באוריגמי, המערכת פונה ל-Take Call URL (ה-Webhook של המרכזייה).
    אך נתוני השיחה אינם נרשמים אוטומטית, המרכזייה צריכה לשלוח חזרה את נתוני השיחה שיצאה.
  • נתונים שנשלחים: מספר הטלפון לחיוג ומזהה השלוחה (Extension) של הנציג.
  • תוצאה באוריגמי: השיחה היוצאת נוספת ללוג, יחד עם הפרטים הרלוונטיים.
  • תיעוד קריאת API רלוונטית:

{
“secret_key”: “a3d0491a4da10879fea05ed0c44db704a031706171”,
“call_id”: “442385”,
“extension”: “7777”,
“call_status”: “calling”,
“call_sub_status”: “”,
“sending_type”: “outgoing”,
“from”: “5678”,
“to”: “972523668571”
}

הערה: בקריאה של שיחה יוצאת, המספר של הלקוח הוא מספר הנמען ״to”, בעוד שמספר המתקשר הוא ה-״from”.

מידע טכני נוסף:

  • נכון לעכשיו, החיבור הוא גנרי\כללי שמתאים לכל מרכזיה שתומכת ב API ו Webhooks.
  • המבנים של קריאות ה API הרלוונטיות, ופרמטרים נוספים (כמו Status, Call ID ו Duration) מפורסמים כאן במדריך ובתיעוד ה-Postman של אוריגמי.