חיבור המרכזייה ל-Callio

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

Webhook מהמרכזייה

המרכזייה שולחת קישור להקלטה בסוף כל שיחה. בלי פיתוח - רק כתובת שמוסרים לספק.

3CX

חיבור דרך תבנית ה-CRM של 3CX. השיחה, המספר ושם הנציג נקלטים לבד.

API למפתחים

מערכת CRM או חייגן שולחים הקלטה (קובץ או קישור) ומקבלים את תוצאות הניתוח.

העלאה מרוכזת

אין חיבור? מורידים הקלטות מהמרכזייה ומעלים עשרות שיחות יחד בממשק.

חיבור מרכזייה ב-Webhook

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

Callio עונה למרכזייה מיד ומעבדת את השיחה ברקע, כך שהמרכזייה לא מחכה ולא שולחת שוב בגלל השהיה. מרכזיות שבודקות את הכתובת לפני שמירה (challenge) מקבלות את התשובה שהן מצפות לה.

שדהמה זה
recording_urlחובה. קישור להקלטה. מתקבלים גם audio_url, file_url, RecordingUrl ושמות נפוצים נוספים.
call_idמומלץ. מזהה השיחה במרכזייה, שמונע קליטה כפולה כשהמרכזייה שולחת שוב.
from / toאופציונלי. המספרים בשיחה.
directionאופציונלי. נכנסת או יוצאת (מתקבל גם inbound, in, 1 ועוד).
agentאופציונלי. שם הנציג, כדי לשייך את השיחה אליו. שלוחה משייכת את השיחה לתחום פעילות.
duration, start_timeאופציונלי. משך ושעת השיחה.

חיבור 3CX

ב-3CX החיבור עובר דרך תבנית האינטגרציה עם CRM, שממלאת כתובת או גוף בקשה ממשתנים כמו מזהה השיחה, המספר ושם הנציג. Callio קוראת את המשתנים של 3CX כפי שהם, כולל שם הפרטי של הנציג, וקולטת גם משלוחים שמגיעים כבקשת GET עם כל הנתונים בכתובת. שם הנציג משייך את השיחה לנציג, ואם אותה מרכזייה משרתת כמה תחומים (למשל שירות ומכירות), השלוחה משייכת את השיחה לתחום הנכון.

API למפתחים

מערכת CRM, חייגן או כל מערכת פנימית יכולים לשלוח שיחה לנקודת הקצה /api/v1/calls עם מפתח API: קובץ הקלטה, או קישור אליו. בניגוד ל-Webhook, הבקשה מחכה לסיום הניתוח ומחזירה את התוצאה, כך שאפשר להציג אותה ישר ב-CRM.

מה מקבלים על כל שיחה

שאלות נפוצות

צריך מתכנת כדי לחבר את המרכזייה?

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

המרכזייה שלנו לא מופיעה כאן. זה יעבוד?

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

מה קורה אם המרכזייה שולחת את אותה שיחה פעמיים?

כשהמרכזייה שולחת מזהה שיחה (call_id), שיחה שכבר נקלטה לא נקלטת שוב.

איך רואים שהחיבור עובד?

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

אפשר להגביל כמה דקות נצרכות ביום?

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

פותחים חשבון עסקי ומחברים את המרכזייה

ההרשמה חינם. אחרי ההרשמה, הכתובת למרכזייה מחכה במסך מפתחות ה-API. שאלות על החיבור? כתבו לנו ונעזור מול ספק המרכזייה.