Click2Call

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

תיאור של אינטגרציית קליק2קול
  • צרו שיחות טלפון יזומות מכל נציג או איש מכירות זמין - באופן אוטומטי! (נהדר! מאיץ ביצועים, מותאם אישית באופן מלא לכל משך זמן).
  • להפעיל וליזום שיחה חוזרת אוטומטית לליד או לקוח שהשאיר פרטים בדף 'צור קשר', ברגע הם לוחצים על הלחצן 'החל/שלח'. דמיינו את ה-WOW שלהם ואת שיעורי ההמרה שלכם.
Click-To-Call API פועל באופן הבא:
כל שיחה שנוצרת באמצעות ה-API יוזמת ומחברת בין 2 "רגליים".
1. רגל 1(Leg 1) היא השיחה הראשונה שהנציג מקבל לעמדה שלו לאחר שיזם שיחה.
פעולה זו מוגדרת על ידי הפרמטר "Phone" שבו אתo מזינים את המזהה של השלוחה של הנציג.

2. רגל 2 (Leg 2) היא השיחה ליעד שנבחר (בעקבות תשובה לשיחת רגל 1), זה מוגדר על ידי הגדרת מספר הטלפון של הלקוח בפרמטר היעד.

 

הסבר כללי:

 

[
]

1
          

        
[
]

קישור שיש לפנות אליו

 

1
          
https://api.voicenter.com/forwardDialer/click2call.aspx
        
[
]

דוגמא לפנייה בפורמט GET

1
          
https://api.voicenter.com/ForwardDialer/click2call.aspx?phone=XXXXXXXX&target=057XXXXXXX&code=XXXXXXXXXXX&action=call
        

דוגמא לפנייה בפורמט POST-JSON

{
"code":"XXXXXXXXXXXX",
"phone":"XXXXXXXXXXXXXX",
"action":"call",
"target":"05XXXXXXXX"
}

1
          

        

קליק2קול מאפשר לכם לבצע את אחת משלושת סוגי השיחה הבאים:


1. שיחה יוצאת.
2. חיוג והשמעת הקלטה.
3. שיחת ועידה.


פורמט הבקשה:

1. POST - JSON
2. GET

 

פורמט תגובה:

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

1. XML - מוגדר כברירת מחדל.
2. JSON

 

 

[
]

1
          

        
[
]

1
          

        

פרמטרים עבור יצירת שיחה יוצאת:

פרמטר תיאור חובה/רשות
Phone"הרגל" הראשונה שבה שיחת הקליק2קול תחייג.
אפשר להטמיע מזהה של שלוחה (SIP, לדוגמא -API1API2) או מספר טלפון בפורמט E.164 אך ללא + (לדוגמא: 972521234567).
יש לרשום מספר טלפון ישראלי בצורה הבאה *********0.
במידה והחיוג אמור להתבצע לסיפ טראנק יש להגדיר: Phone=SIPTRUNK בבקשה שלכם.
במידה ושלוחת וויסנטר בבקשה שלכם תלויה בביצוע לוגין למען הוצאת שיחות על הבקשה שלהם להיראות כך:
יש לבצע שימוש בפרמטרים: phone=logincode & phonelogincode=[login code] - את הפרטים הללו ניתן להשיג מתוך ממשק הניהול.
חובה
target"הרגל" השנייה שבה השיחה תחייג - היעד אליו אתם מחייגים.
אפשר להטמיע מזהה של שלוחה (סיפ) או מספר טלפון בפורמט E.164 אך ללא +. יש לרשום מספר טלפון ישראלי בצורה הבאה *********0.
חובה
codeקוד ייחודי לחשבון.
(הקוד ימסר על ידי מחלקת התפעול שלנו).
חובה
actionCall (action=call).חובה
recordהאם להקליט את השיחה?
יש להעביר את אחד מהערכים הבאים: True/False.
רשות
phonecalleridמספר מזהה של "הרגל הראשונה" - השיחה הנכנסת לשלוחה/מספר טלפון בשדה Phone בבקשה שלכם.
* לא נתמך על ידי כלל הספקים החיצונים.
רשות
phonecallernameשם מתקשר של "הרגל הראשונה" - השיחה הנכנסת לשלוחה/מספר טלפון בשדה Phone בבקשה שלכם.
* לא נתמך על ידי כלל הספקים החיצונים.
רשות
targetcalleridמספר טלפון מזהה של "הרגל השנייה" - השיחה היוצאת ליעד שלכם בשדה Target בבקשה שלכם.
* לא נתמך על ידי כלל הספקים החיצונים.
רשות
targetcallernameשם מתקשר של "הרגל השנייה" - השיחה היוצאת ליעד שלכם בשדה Target בבקשה שלכם.
* לא נתמך על ידי כלל הספקים החיצונים.
רשות
phonemaxdialtimeזמן חיוג מקסימלי בשניות של "הרגל הראשונה" - השיחה הנכנסת לשלוחה/מספר טלפון בשדה Phone בבקשה שלכם.
ערך ברירת מחדל הוא 60 שניות.
רשות
targetmaxdialtimeמשך זמן חיוג מקסימלי של היעד "הרגל השנייה", מוצג בשניות.
אם לא הוזן, ברירת מחדל הינה 60 שניות.
רשות
maxdurationמשך השיחה מקסימלי בשניות.
אם לא הוזן, ברירת מחדל הינה 7200 שניות(שעתיים).
רשות
phoneautoanswerרק עבור שלוחות Voicenter, עם הערכים 1 או true למענה אוטומטי.
אם לא צוין מוגדר כ- False.
רשות
targetautoanswerרק עבור שלוחות Voicenter, עם הערכים 1 או true למענה אוטומטי ביעד השיחה.
אם לא צוין מוגדר כ- False.
רשות
checkphonedevicestateחסום את השיחה אם השלוחה לא מחוברת.רשות
checktargetdevicestateאימות לפני ביצוע שיחה.
וודא כי השלוחה אליה מתקשרים מחוברת.
רשות
formatפורמטים אפשריים לתגובת קליק2קול: XML / JSON שברצונכם לקבל.
ברירת המחדל היא XML.
רשות
var_*כל פרמטר מותאם אישית עם קידומת "var_" שברצונכם להעביר בבקשה שלכם.
לדוגמא var_customer=2342 זה פרמטר שברצונכם להוסיף לבקשה שלכם.
פרמטר זה יוצג בהתראות של תוסף הכרום שלנו.
מידע זה גם מועבר בלוג השיחות שנשלח בAPI שלנו.
המגבלה היא 10 פרמטרים.
רשות
[
]

1
          

        

פרמטרים עבור ניתוק שיחה:

פרמרטר תיאור רשות/חובה
Phoneמזהה שלוחה של חברת וויסנטר שעבורה תרצו לנתק את השיחה.חובה
codeקוד ייחודי לחשבון.
(הקוד ימסר על ידי מחלקת התפעול שלנו).
חובה
actionterminate (action=terminate).חובה
[
]

1
          

        

תגובה של השירות קליק2קול:

התשובה תגיע בפורמט XML (XML-RPC) או בפורמט JSON לבחירתכם.
ברירת המחדל היא XML-RPC.


התשובה של השירות תכלול 3 פרמטרים:
1. ERRORCODE - קוד השגיאה (פירוט של קודי השגיאה בטבלה המופיעה מטה).
2. (String)ERRORMESSAGE - תמצית הודעת השגיאה (כמפורט מטה).
3. (String)CALLID - מזהה שיחה ייחודי בעל 32 תווים (במידה והשיחה נכשלה השדה יהיה ריק).

 

ERRORCODE יכלול את אחד הקודים הבאים: 

קוד תיאור
0Ok
1Invalid request parameters.
2Application error.
3Extension representative offline.
4Extension blocked for Click2Call calls.

 

דוגמא לתשובה של השירות בפורמט JSON:

{
"ERRORCODE":0,
"ERRORMESSAGE":"OK",
"CALLID":"sdfsdfsdfsdfdsfsdfdsfsdfsdf0brp"
}

1
          

        
[
]

דוגמא לתשובה של השירות בפורמט XML-RPC:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
          
<methodResponse>
<params>
<param>
<value>
<struct>
<member>
<name>ERRORCODE</name>
<value><string>1</string></value>
</member>
<member>
<name>ERRORMESSAGE</name>
<value><string>Phone is missing</string></value>
</member>
<member>
<name>CALLID</name>
<value><string></string></value>
</member>
</struct>
</value>
</param>
</params>
</methodResponse>
        

Pop Up Screen

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

הסבר כללי:

 

איך השירות עובד?

1. מתבצעת שיחה נכנסת מלקוח מתקשר.
2. תוסף לדפדפן כרום של Voicenter שולח את פרטי השיחה אל שרת שלכם בעזרת בקשת Http (אינטגרציית הקפצת המסך ניתנת למימוש ללא התוסף לכרום באמצעות Real-Time API).
3. השרת שלכם מעבד את המידע ומחזיר תשובה לתוסף לכרום של Voicenter.
4. התוסף לכרום שלנו מציג ויזואלית במסך של הנציג את שם הלקוח, בלחיצה על הבועית הייעודית ניתן לפתוח את כרטיס הלקוח.

 

pop screen how it works

 

פורמט הבקשה:

1. GET
2. POST

 

פורמט תגובה:

1. JSON

 

דוגמא לפנייה (Request) של Voicenter לקישור שיסופק על ידיכם:

[
]

1
          

        
[
]

1. GET:

1
2
          
https://www.yourdomain.com/contact_search.asp?phone=0722776772&ivrid=202010111sdsd3684752bcb3d&extenU
ser=SIPSIPl&did=0722776773&statusCall=Ringing
        
[
]

2. POST- Application/X-WWW-Form-Urlencoded:



1
          
phone=0722776772&ivrid=202010111sdsd3684752bcb3d&extenUser=NaDzw5Ol&did=0722776773&status=Ringing
        
[
]

1
          

        

פירוט פרמטרים בשליחת בקשה (Request) מ-Voicenter:

שם שדה תיאור סוג שדה
phoneמספר טלפון של הלקוחמחרוזת
ivridמזהה שיחה ייחודימחרוזת
extenUserמזהה שלוחה ייחודי.
התוסף מעביר את המזהה של השלוחה שבה התרחש צלצול/מענה/ניתוק.
מחרוזת
didמספר טלפון שאליו הלקוח קצה התקשר.מחרוזת
statusCallמצב השיחה.
הערך יהיה "Ringing" עבור שיחות נכנסות כאשר הן מצלצלות.
עבור שיחות יוצאות שמחייגות ליעד סטטוס השיחה יהיה Dialing.
מחרוזת
[
]

1
          

        

אלו הם הפרמטרים שעליכם להעביר בתשובה שלכם: 

שם שדה תיאור סוג הפרמטר רשות/חובה
STATUSמקבל אך ורק ערך "OK", ערך אחר יעיד על בעיה בצד לקוח (מצד מערכת המידע שלכם).
שימו לב כי OK צריך להיות באותיות גדולות.
מחרוזתחובה
URLקישור לכרטיס הלקוח שאותר בתוך מערכת המידע שלכם.מחרוזתרשות
CLIENTNAMEשם הלקוח שאותר במערכת המידע שלכם.מחרוזתרשות
TOTALכמות הרשומות שאותרו שנמצאו במערכת המידע.מספר שלםרשות
COMPANYשם החברה של הלקוח המתקשר שאותרה במערכת המידע שלכם.מחרוזתרשות

דוגמא לתשובה שעליכם להעביר בפורמט JSON

{
"STATUS":"OK",
"URL":"https://www.yourdomain.com/contact_search.asp?user_phone=0722776772",
"CLIENTNAME":"John Doe",
"TOTAL":1,
"COMPANY":"Voicenter"
}

1
          

        

מידע חשוב:

1. ניתן להוריד את התוסף כרום כאן. לאחר הורדת התוסף, תתבקשו להזין את שם המשתמש והסיסמא הייחודיים לכל משתמש אותם ניתן למצוא בממשק Cpanel.

2. התוסף מותקן בעמדת המחשב המקומית של כל נציג, שליחת בקשות יבוצעו דרך כתובת ה-IP של הרשת ממנה הנציג מחובר לרשת.

3. במקרה בו שיחה תצלצל בו זמנית במספר שלוחות במקביל, כל תוסף לכרום ישלח בקשה נפרדת לשירות אינטרנט (Web-Service) בנקודת הקצה (End Point). לדוגמא, אם שיחה מצלצלת בעשר שלוחות במקביל, וכל אחד מהנציגים עושה שימוש בתוסף לכרום של Voicenter, עשרה בקשות HTTP ישלחו לשרת לקוח (Client Server) וכל אחד מהם ימתין לתגובה.

4. בהגדרות התוסף לכרום של Voicenter, תתבקשו לקבוע איזה סוג של שיחות יקפיצו את המסך (נכנסות/ יוצאות/ קליק2קול). במילים אחרות, באיזה סוג שיחה התוסף לכרום ישלח בקשה. לדוגמא, ניתן להגדיר שהתוסף יקפיץ מסך אך ורק בשיחות יוצאות (כלומר יתעלם משיחות יוצאות).

 

 

הגדרת תוסף לכרום

 

 

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

 

 

הגדרות תוסף לכרום

 

 

תוסף לכרום של Voicenter:

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

 

שימו לב: 

בעת התקנת התוסף מתקבלת התראה "This extension will have access to all browsing history and private data on all websites". מדובר בהתראת ברירת מחדל שמוצגת בכל תוסף שדורש הרשאת גישה של סקריפט תוכן לכל אתרי האינטרנט. הגישה הזו נדרשת לטובת זיוי מספרי טלפון לחיוג בקליק במקום שתחייגו באופן ידני.

 

[
]

1
          

        

CDR Notification System

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

תוכלו להנות מהיתרונות הבאים:

1. שמירת לוג שיחות בכרטיס הלקוח במערכת הארגונית שלכם.
2. צפייה קלה ומהירה אל היסטוריית שיחות של הלקוחות שלכם במערכת המידע הארגונית שלכם.
3. תוכלו להפעיל התראות למנהלי המוקד עבור שיחות שלא נענו/ננטשו/נכנסו מחוץ לשעות פעילות.
4. באפשרותכם לעבד את המידע ולקבץ סטטיסטיקות על פעילות המוקד שלכם ובהתאם לכך לנתח מתי הן שעות העומס שלכם? תקופות של נציגים.

תיאור של העברת פירוטי שיחות

הסבר כללי

לאחר סיום השיחה Voicenter מנתחת את נתוני השיחה מעבדת אותם ומייצרת פרטי שיחה שאותם אנו שולחים לשרת של מערכת המידע שלכם בבקשה (Request) HTTP פשוטה - עליכם להחזיר אלינו תגובה (Response) 200 על מנת שנדע שהמידע התקבל אצלכם בהצלחה.

CDR HOW ITS WORKS

 

מתוך המידע המתקבל תוכלו:


1. לשלוח התראה במייל/סמס/וואטצאפ למנהל המוקד על שיחה שננטשה.
2. לשלוח סמס/וואטצאפ ללקוח שנטש המתנה.
3. להציג במערכת המידע שלכם היסטורית שיחות של לקוח מסוים.
4. לתעד את ההקלטות במערכת המידע שלכם תחת אותה ישות.
5. לייצר דוחות לבחינה BI עסקי ולנתח עומס פעילות, תפוקות של נציגים בשיחות נכנסות או יוצאות.
6. לראות באילו יעדים ומדינות יש אחוזי מענה יותר גבוה לשיחות יוצאות שאתם מבצעים.
7. מגוון רב של פעולות אשר יאפשרו לכם לנטר את הפעילות העסקית שלכם ולשפר תהליכים עסקיים עקב זאת.

 

פורמט בקשה:

  1. JSON
  2. XML-RPC
  3. POST-Application/X-WWW-Form-Urlencoded

 

פורמט תגובה:

  1. JSON
  2. XML-RPC
  3. POST-Application/X-WWW-Form-Urlencoded

 

 

[
]

1
          

        
[
]

1
          

        

פרמטרים בבקשה

שדה תיאור דוגמא
callerמציג את מספר הטלפון של המתקשר.
מספר הטלפון שהיעד רואה בעת קבלת השיחה.
"caller":"0722776772"
targetמציג את יעד השיחה.
הפרמטר יכול להיות מספר טלפון או מזהה שלוחה.
נא שימו לב כי מספר טלפון יישלח עם קידומת בינלאומית.
"target":"SIPSIP" / "target":"972722776772"
timeמציג את מועד תחילת השיחה בזמן Epoch."time":1536855354
durationמציג את משך השיחה בשניות.
נתון זה אינו כולל את משך צלצול השיחה בשלוחה/ות אלא רק את משך השיחה עצמה.
"duration":33
ivruniqueidמציג מזהה שיחה ייחודי."ivruniqueid":"20200720095iMlilHJs"
typeמציג את סוג השיחה.
לדוגמא: האם מדובר על שיחה יוצאת? או שיחת מעגל?
יש מספר רב של סוגי שיחה, אנא התבוננו בטבלה מטה.
"type":"Incoming Call" / "type":"Extension Outgoing" / "type":"Click2Callleg1"
statusמציג את התוצאה של השיחה.
האם השיחה ננטשה? נענתה?
במידה ולשיחה יש שתי רגליים (כמו שיחות קליק2קול וחייגן) אז פרמטר זה יציג את התוצאה של הרגל 2 של השיחה.
לפירוט נוסף על תוצאות שיחה אפשריות יש לעיין בטבלה מטה.
"status":"ANSWER" / "status":"ABANDONE" / "status":"TE"
leg1DialStatusNameבמידה ולשיחה היו 2 רגליים (כגון שיחות קליק2קול וחייגן), שדה זה יציג את התוצאה של הרגל ראשונה."leg1DialStatusName": "ANSWER"/ "leg1DialStatusName": "ABANDONE" / "leg1DialStatusName":"TE"
targetextensionמציג את מזהה השלוחה שענתה לשיחה הנכנסת.
לעיתים הערך בפרמטר זה יהיה זהה לערך בפרמטר target שרשום מעלה.
ישנם מקרים שבהם שיחה נכנסת אינה מגיעה ישירות לשלוחה ולכן השדה target עשוי להכיל ערכים שונים.
"targetextension":"SIPSIP"
callerextensionמציג את מזהה השלוחה אשר ביצעה שיחה יוצאת.
שדה זה שונה משדה caller מאחר ושדה caller מציג את המספר המזהה של השלוחה המתקשרת.
"callerextension":"SIPSIP"
didמציג את מספר הטלפון שאליו התקשרו בשיחה נכנסת."did":"0722776772"
queueidבמידה והשיחה נותבה למעגל המתנה, שדה זה יציג את המזהה של המעגל.
השדה יציג 0 במידה והשיחה לא עברה במעגל המתנה.
"queueid":1234567
queuenameבמידה והשיחה נותבה למעגל המתנה, שדה זה יציג את שם המעגל."queuename":"Service Queue"
recordמציג את קישור להקלטת השיחה.https://cpanel.voicenter.co.il/CallsHistory/PlayRecord/202205181005020246363e832-aws-Rojxp5-972521112233.mp3
priceמציג את תמחור השיחה באגורות."price":7
dialtimeמציג את זמן צלצול/חיוג השיחה בשניות.
פרמטר זה אינו מציג את משך השיחה.
"dialtime":23
representative_nameמציג את שם המשתמש של השלוחה שמקושרת לשיחה.
במידה ויוזר לא ביצע לוגין בזמן השיחה, שדה זה יציג את שם המתשמש שמקושר לשלוחה/מספר של שיחה זו.
"representative_name": "Walter Melon"
representative_codeמציג את מזהה המשתמש אשר השיחה מקושרת אליו.
במידה והמשתמש לא ביצע לוגין, שדה זה יציג את מזהה המשתמש אשר מקושר לשלוחה או למספר טלפון אשר מקושרים לשיחה.
"representative_code":"9996"
targetextension_nameמציג שם שם השלוחה אשר ענתה לשיחה."targetextension_name": "Walter Melon"
callerextension_nameמציג את שם השלוחה אשר ביצעה את השיחה."callerextension_name": "Walter Melon"
target_countryמציג את שם המדינה שאליה בוצעה שיחה יוצאת."target_country":"Israel"
caller_countryמציג את שם המדינה שממנה התקבלה השיחה."caller_country":"Israel"
seconds_waiting_in_ queueשדה זה מכיל את משך ההמתנה של הלקוח בשיחה הרלוונטית במעגל המתנה.
שדה זה לא יישלח במידה והשיחה לא עברה במעגל המתנה.
"seconds_waiting_in_queue":5
OriginalIvrUniqueIDשדה זה יישלח אך ורק במידה והשיחה הזו הייתה מקושרת לשיחה אחרת.
לדוגמא במקרה של שיחות שהועברו שדה זה יכיל את מזהה השיחה של השיחה שהועברה.
"OriginalIvrUniqueID": "201809131730110122A1212"
DepartmentNameשדה זה מכיל את שם החשבון אשר השיחה מקושרת אליו."DepartmentName": "Voicenter Account"
DepartmentIDשדה זה מכיל את מזהה החשבון אשר השיחה מקושרת אליו."DepartmentId":123456
TopDepartmentNameשדה זה מכיל את שם החשבון הראשי אשר השיחה מקושרת אליו."DepartmentId":123456
TopDepartmentIDשדה זה מכיל את מזהה החשבון הראשי אשר השיחה מקושרת אליו."TopDepartmentID":7654321
IVRפרמטר מסוג מערך אשר מציג את השכבות בנתב שהשיחה עברה בהם. השדות הם:
שדה: Layer_id מציג את המזהה הייחודי של השכבה.
שדה Layer_name - מציג את שם השכבה כפי שמופיע בממשק הנתב.
שדה DTMF - מציג את הלחיצות של הלקוח בנתב.
במידה ולא הייתה לחיצה הערך יהיה 0.
שדה LayerNumber - יציג את מספר השכבה.
שדה dtmf_order - מציג את סדר מעבר השיחה בשכבות.
"IVR": "[{ \"layer_id\":1234567, \"layer_name\":\"LayerName\, \"layer_number\":6, \"Dtmf\":0, \"dtmf_order\":1 }]"
[
]

1
          

        

סוגי שיחות

להלן פירוט על סוגי השיחות השונים אשר יכולים להיווצר:

סוג שיחה תיאור
Incoming Callשיחה נכנסת רגילה.
לקוח קצה חייג אליכם למספר טלפון שלכם, השיחה נכנסה לנתב וצלצלה בשלוחה אחת או מספר שלוחות.
* השיחה לא עברה במעגל המתנה.
CCשיחה שבוצעה בעזרת שירות מספר גישה של חברת וויסנטר.
Extension Outgoingשיחה יוצאת רגילה משלוחה של וויסנטר.
* לא שיחת קליק2קול.
Queueשיחה נכנסת שהתקבלה אל מעגל המתנה.
Click2Call leg1שיחת קליק2קול (לא שיחת חייגן).
"רגל 1" של השיחה - השיחה בין השירות לשלוחה שאמורה לחייג ליעד ב"רגל 2" של השיחה.
Click2Call leg2שיחת קליק2קול (לא שיחת חייגן).
"רגל 2" של השיחה - השיחה בין השלוחה ליעד.
ברשומה זו תקבלו תיעוד על פרטי השיחה וקישור להקלטות השיחה.
VoiceMailשיחה אשר נענתה על ידי שירות התא קולי של וויסנטר.
Callferenceשיחה שבוצעה בעזרת שירו תחדר וועידה של חברת וויסנטר.
XferCDRשיחה אשר הוערה ידנית משלוחה של מספר/שלוחה אחרת.
ProductiveCallLeg1שיחת "רגל 1" של חייגן לנציג - השיחה אשר מחברת בין השירות לנציג.
ProductiveCallLeg2שיחת "רגל 2" של חייגן לנציג - השיחה אשר מחברת בין הנציג ליעד/לקוח/ליד שהזנתם בחייגן.
Scrubberשיחה שבוצעה דרך שירות הסקראבר של חברת וויסנטר.
Click 2 IVRשיחת "רגל 1" של חייגן חכם - השיחה הראשונית בין החייגן ליעד.
Click 2 IVR Incomingשיחת "רגל 2" של חייגן חכם - השיחה שמתרחשת לאחר חיבור מוצלח ומענה של היעד "ברגל ה1".
בסוג שיחה זה מתבצע חיוג מהיעד אל נתב השיחות שלכם.
סוג שיחה זה מסמן כי השיחה לא עברה למעגל המתנה אלא הועברה ישירות לנציג או השמעת הקלטה.
ברשומה זו תקבלו את סטטוס השיחה וקישור להקלטת השיחה.
Click 2 Queue Incomingשיחת "רגל 2" של חייגן חכם - השיחה שמתרחשת לאחר חיבור מוצלח ומענה של היעד "ברגל ה1".
בסוג שיחה זה מתבצע חיוג מהיעד אל נתב השיחות שלכם.
סוג שיחה זה מסמן כי השיחה עברה למעגל המתנה והיעד המתין עד למענה של נציג.
ברשומה זו תקבלו את סטטוס השיחה וקישור להקלטת השיחה.
FaxCdrשיחה אשר בוצעה דרך שירות הפקס הפנימי של וויסנטר.
*השירות לא פעיל עדיין.
Attended CDR leg1שיחה בהעברה עם התייעצות.
Attended CDR leg2שיחה בהעברה עם התייעצות.
רשומה זו תתקיים כאשר מתבצע תסריט שיחה הבא:
נציג א' עונה לשיחה נכנסת, הלקוח מבקש לדבר עם נציג ב'.
נציג א' מתקשר אל נציג ב'.
לאחר מכן נציג א' מעביר את השיחה והלקוח לנציג ב'.
סוג שיחה זה נותן מידע על השיחה של הלקוח עם נציג ב'.
Auto forwardשיחה שהועברה באופן אוטומטי משלוחה למספר טלפון - בדרך כלל מדובר על הגדרה דרך הטלפון IP.

הסבר על שיחות עם רגל 1 + רגל 2

 

יש מספר סוגי שיחות אשר מורכבות משתי שיחות בפועל:

  1. שיחות קליק2קול - מורכבות מרגל 1: השיחה הראשונה לשלוחה + רגל 2 - השיחה ליעד לאחר מענה ברגל 1.
  2. שיחות חייגן לנציג - מורכבות מרגל 1: השיחה הראשונה לשלוחה + רגל 2 - השיחה ליעד לאחר מענה ברגל 1.
  3. שיחות חייגן חכם - מורכבות מרגל 1: השיחה הראשונה ליעד (לקוח) + רגל 2 - השיחה ליעד (נציג/נתב) לאחר מענה ברגל 1.
[
]

1
          

        
[
]

1
          

        

סוגי סטטוס שיחות:

להלן פירוט על סטטוס שיחה (תוצאה של השיחה לאחר סיומה):

שם סטטוס תיאור
NOTDIALEDניתוק לפני ביצוע שיחה.
ANSWERמענה של שיחה לאחר חיוג/צלצול מוצלח.
השיחה הגיעה ליעדה.
מענה מתרחש כאשר וויסנטר מקבל איתות של מענה בשיחהכ מו כן גם הגעת השיחה לתא קולי.
BUSYכאשר מנסים לבצע חיוג ליעד מסוים אבל מספר הטלפון שולח בחזרה איתות של "עסוק".
NOANSWERאין מענה. השיחה הגיעה ליעד אך צלצלה למשך זמן מסוים עד לאי מענה.
CANCELביטול שיחה. מצב זה קורה כאשר מחייגים ליעד מסוים אבל מתבצע ניתוק לפני מענה ביעד.
ABANDONEשיחה שננטשה לאחר המתנה במעגל המתנה ומתרחש במצבים הבאים:
בוצע ניתוק של השיחה לפני מענה.
יציאה מהמעגל בעת המתנה.
לקוח המתין זמן המתנה מקסימלי.
VOENDניתוק של השיחה במעמד הנתב ללא צלצול בשלוחה כלשהי או מעגל המתנה.
במקרה זה לקוח התקשר הגיע לנתב השיחות וניתק.
TEמתרחש כאשר השיחה מגיעה לנתב השיחות ומשמיעה הקלטה ולאחר מכן מתנתקת.
NOTCALLEDסטטוס זה מציין כי הרגל השנייה של השיחה לא בוצעה מאחר והרגל ה1 של השיחה לא הייתה מוצלחה (השיחה לא התחברה לשלוחה).
VOICEMAILשיחה הגיעה לתא הקולי של וויסנטר.
CONGESTIONסטטוס זה מסמל לרוב חיוג ליעד לא מוכר.
CHANUNAVAILערוץ לא זמין או שלוחה לא מחוברת ורשומה.
INVALIDARGSשגיאה בעיבוד פקודת חיוג ליעד.
SSWPREAUTHביטול שיחה יוצאת לפני ביצוע חיוג.

דוגמאות לבקשה

שיחה יוצאת:

{
"caller":"0722776772",
"target":"0501234567",
"time":1595960350,
"duration":11,
"ivruniqueid":"2020072818dcDHFJcc804",
"type":"Extension Outgoing",
"status":"ANSWER",
"targetextension":"",
"callerextension":"SIPSIP",
"did":"",
"queueid":0,
"queuename":"",
"record":"https://cpanel.voicenter.co.il/CallsHistory/PlayRecord/2020072818dcDHFJcc804-aws.mp3",
"price":0,
"dialtime":2,
"representative_name":"User 1",
"representative_code":"12345678",
"targetextension_name":"",
"callerextension_name":"",
"target_country":"",
"caller_country":"",
"DepartmentID":12345678,
"DepartmentName":"Voicenter Sales Department",
"TopDepartmentID":87654321,
"TopDepartmentName":"Voicenter Account"
}

נציג "User 1" ביצע שיחה יוצאת מהשלוחה שלו (SIPSIP) אל היעד 0501234567, היעד קיבל שיחה ממספר: 0722776772.
השיחה נענתה לאחר חיוג של 2 שניות.
אורך השיחה היה 11 שניות.

1
          

        

נציג "User 1" ביצע שיחה יוצאת מהשלוחה שלו (SIPSIP) אל היעד 0501234567, היעד קיבל שיחה ממספר: 0722776772.
השיחה נענתה לאחר חיוג של 2 שניות.
אורך השיחה היה 11 שניות.

שיחה נכנסת:

{
"caller":"0501234567",
"target":"",
"time":1595333610,
"duration":20,
"ivruniqueid":"202007211213270124c",
"type":"Queue",
"status":"ANSWER",
"targetextension":"",
"callerextension":"",
"did":"0722776772",
"queueid":123456789,
"queuename":"Sales Queue",
"record":"https://cpanel.voicenter.co.il/CallsHistory/PlayRecord/202007211213270124c-aws.mp3",
"price":0,
"dialtime":0,
"representative_name":"Admin User",
"representative_code":"12345679",
"targetextension_name":"",
"callerextension_name":"",
"target_country":"",
"caller_country":"Israel",
"seconds_waiting_in_queue":20,
"IVR":[
{
"layer_id":1234,
"layer_name":"Main IVR",
"layer_number":0,
"Dtmf":2,
"dtmf_order":1
},
{
"layer_id":4321,
"layer_name":"Sales Department",
"layer_number":2,
"Dtmf":0,
"dtmf_order":2
}
]
}

בדוגמא זו ניתן לראות כי התקבלה שיחה נכנסת מהמספר 0501234567 אל המספר 0722776772.
השיחה עברה בשכבה Main IVR והלקוח המתקשר הקיש על ספרה 2 בשכבה זו ונותב לשכבה Sales Department לאחר מכן.
השיחה הגיעה למעגל המתנה Sales Queue ולאחר המתנה של 20 שניות השיחה נענתה.

1
          

        

בדוגמא זו ניתן לראות כי התקבלה שיחה נכנסת מהמספר 0501234567 אל המספר 0722776772.
השיחה עברה בשכבה Main IVR והלקוח המתקשר הקיש על ספרה 2 בשכבה זו ונותב לשכבה Sales Department לאחר מכן.
השיחה הגיעה למעגל המתנה Sales Queue ולאחר המתנה של 20 שניות השיחה נענתה.

[
]

1
          

        

פורמט תגובה:

  1. JSON
  2. XML-RPC
  3. POST-Application/X-WWW-Form-Urlencoded

 

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

שם סוג דוגמא תיאור
Errמספר שלם0קודי הודעה:
0 – OK 1 – Parse error 2 – Application error
ErrdescמחרוזתOKתיאור השגיאה.

דוגמה לתשובה:

{
"err":0,
"errdesc":"OK"
}

אתם מוזמנים להיכנס לממשק הניהול בכתובת: https://cpanel.voicenter.co.il/ApiManager/Index ולהטמיע את השירות באופן עצמאי.

1
          

        

אתם מוזמנים להיכנס לממשק הניהול בכתובת: https://cpanel.voicenter.co.il/ApiManager/Index ולהטמיע את השירות באופן עצמאי.

Call Log API

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

1. תוכלו במרחב של כל 10 דקות (לדוגמא) לשלוח בקשת HTTP רגילה ולקבל פרטי שיחות שבוצעו בזמן האחרון.
2. תוכלו למשוך פרטי שיחות בסוף יום העבודה, הנושא יהיה בשליטתכם לפי הצורך והלוגיקה העסקית שלכם.
3. תוכלו להחליט איזה פרמטרים תרצו לקבל מחברת Voicenter.
תיאור של משיכת פרטי שיחות

הסבר כללי

 

[
]

1
          

        
[
]

הקישור של השירות שעליכם לפנות אליו

1
          
https://api.voicenter.com/hub/cdr
        

פורמט בקשה

1. POST
2. GET

 

פורמט תגובה

1. JSON

 

אופי הפנייה שלכם

הפנייה שלכם בעצם צריכה להיות מורכבת משני חלקים:
1. הסינון שלפיו אנו נחזיר אליכם את פרטי השיחה - לדוגמא סינון לפי תאריך בפרמטרים: Fromdate + Todate.
כמו כן ישנם שדות נוספים שיאפשרו לכם לבצע סינון נוסף - מצוף בטבלה מטה.


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


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

 

[
]

1
          

        
[
]

1
          

        

פרמטרים שאפשר להעביר בבקשה עבור סינון המידע

* סינון המידע מתייחס על פי איזה פרמטרים יועבר לכם המידע? למשל על פי אילו תאריכים? לפי איזה מספר טלפון? וכן הלאה, כמפורט מטה.

שדה תיאור סוג
codeמחרוזתקוד ייחודי לחשבון שלכם.
פרמטר חובה.
fromdateתאריך וזמן תחילת סינון בפורמט ISO 8601, הפרמטר הוא באזור זמן GMT 0.חובה.
todateתאריך וזמן סוף סינון בפורמט ISO 8601, הפרמטר הוא באזור זמן GMT 0.חובה.
phonesמערך של מחרוזות, כל מחרוזת היא ספר טלפון יחד עם קידומת מדינה.
מספר טלפון ישראלי ניתן לרשום ללא קידומת בינלאומית.
רשות.
extensionsמערך של מחרוזות, כל מחרוזת היא מזהה של שלוחה של Voicenter.רשות.
IdentityCriteriaחיפוש לפי רמת חשבון, ניתן להגדיר אחת מהאפשרויות הנ"ל:
חיפוש לפי כל החשבון - Account - תקף במידה ותרצו לקבל מידע על כלל החשבון לפי הקוד שהזנתם.
חיפוש לפי חשבון מסוים והחשבונות תחתיו - Hierarchical - מומלץ במידה ובתת חשבון מסויים יש מספר תתי חשבונות מתחתיו.
חיפוש רק לפי חשבון מסוים - Department - רלוונטי במידה ואתם רוצים תוצאה רק של חשבון מסוים
חיפוש של שיחות של משתמש מסוים בלבד - User - יש להעביר את הקוד של אותו משתמש בנוסף לפרמטר זה.
רשות.
CallIDמחרוזת, תוכלו לחפש שיחה ספציפית.רשות.
cdrTypesמערך של מספרים שלמים, נותן לכם את האפשרות לסנן תוצאות על פי סוגי שיחה מסוימים.רשות.
[
]

1
          

        

קביעת סדר הסינון

כמו כן, תוכלו לקבוע באיזה סדר הסינון יופיע והאם בסדר עולה או יורד.

שדה תיאור סוג תיאור
fieldשם של השדה שלפיו יתבצע המיון.מערך.רשות.
orderניתן לקבוע: asc/desc אשר יקבע את הסדר של המיון.מחרוזת.רשות.
[
]

1
          

        

פרמטרים בבקשה

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

שדה תיאור דוגמא
CallerNumberמציג את מספר הטלפון של המתקשר.
זהו מספר הטלפון אשר מי שמקבל את השיחה ייראה.
"CallerNumber":"0722776772"
TargetNumberמציג את מספר הטלפון של יעד השיחה.
הפרמטר יהיה מספר טלפון או מזהה שלוחה של וויסנטר.
מספרי טלפון יופיעו עם קידומת בינלאומית.
"TargetNumber":"AAPINFzL" / “TargetNumber":"972722776772"
Dateמציג את הזמן והתאריך שהשיחה בוצעה."Date":"2017-07-20 09:59:29"
DateEpochמציג את הזמן והתאריך שהשיחה בוצעה בפורמט Epoch."DateEpoch":1554027973
Durationמציג את משך השיחה בשניות.
משך השיחה אינו כולל את משך זמן צלצול השיחה אלא רק את השיחה בפועל.
"Duration":33
CallIDמציג מזהה שיחה ייחודי עבור כל שיחה. "CallID":"20200720095ilila137b2f69s"
Typeמציג את סוג השיחה.
לדוגמא: שיחה יוצאת/נכנסת/שיחה של מעגל המתנה.
בהמשך תוצג טבלה עם פירוט על כלל סוגי השיחות.
"Type":"Incoming Call" / "Type":"Extension Outgoing" / "Type":"Click2Callleg1"
CdrTypeמציג את סוג השיחה לפי מספר סידורי אשר שייך לסוג שיחה בטבלה מטה."CdrType": 4
DialStatusמציג את הסטטוס השיחה, האם נענתה? או לא?
במידה ומדובר על שיחות עם 2 רגליים (כגון: קליק2קול, שיחות חייגן) שדה זה יראה מידע רק עבור הרגל הראשונה של השיחה.
"DialStatus":"ANSWER" / "DialStatus":"ABANDONE" / "DialStatus":"TE"
Targetextensionמציג את המזהה של השלוחה אשר קיבלה שיחה נכנסת.
ישנם מקרים בהם הנתון בשדה זה עשוי להיות זהה לשדה "TargetNumber" באותה שיחה.
אך ישנם מקרים כאשר שיחה נכנסת אינה מפנה ישירות לשלוחה מסוימת ולכן השדה "TargetNumber" יציג נתון שונה.
"Targetextension":"AAPINFzL"
Callerextensionמציג את המזהה של השלוחה אשר ביצעה שיחה יוצאת.
המידע בשדה זה הוא שונה מהמידע בשדה "CallerField" מאחר ושדה "CallerField" מציג מספר מזהה של השלוחה בשיחה יוצאת.
"Callerextension":"AAPIUtdL"
DIDמספר הטלפון שהתקשרו אליו בשיחה נכנסת."DID":"0722776772"
QueueNameמציג את שם מעגל ההמתה אשר השיחה עברה בו."QueueName":"Service Queue"
RecordURLקישור להקלטת השיחה."RecordURL":"https://cpanel.voicenter.co.i l/CallsHistory/PlayRecord/123abc.mp3"
RecordExpectשדה בוליאני אשר מציג האם השיחה הוקלטה או לא."RecordExpect":true
RingTimeמציג משך זמן צלצול של השיחה."RingTime":23
Priceמציג באגורות את מחיר השיחה."Price":7
RepresentativeNameמציג את שם הנציג אשר היה מחובר וביצע/ענה לשיחה זו.
הנציג חייב להתחבר למערכת על מנת ששדה זה יוצג.
"RepresentativeName":"Walter Melon"
RepresentativeCodeמציג את קוד עובד של הנציג אשר היה מחובר וביצע/ענה לשיחה זו.
הנציג חייב להתחבר למערכת על מנת ששדה זה יוצג.
"RepresentativeCode":"19996"
UserNameבדומה לשדה "RepresentativeName" במידה והנציג היה מחובר לשלוחה בעת ביצוע/מענה לשיחה שדה זה יציג את אותו נתון.
במידה ונציג לא היה מחובר לשלוחה שדה זה יציג את שם המשתמש אשר מקושר לשיחה/למספר טלפון שקשור לשיחה זה.
"UserName":"Walter Melon"
DepartmentNameמציג את שם החשבון כפי שהוא רשום בוויסנטר ומקושר לשיחה זו."DepartmentName":"Voicenter Account"
DepartmentIdמציג את מספר החשבון כפי שהוא רשום בוויסנטר ומקושר לשיחה זו."DepartmentId":123456
TargetPrefixNameמציג את שם מדינת היעד בשיחה יוצאת."TargetPrefixName":"Israel"
DTMFDataשדה מסוג מערך JSON אשר מציג את מסלול שיחה נכנסת בנתב השיחות.
השדות שיופיעו הם:
שם השכבה - "LayerName"
הקשות הלקוח בנתב - "DTMF"
מספר שכבה - "LayerNumber"
"DTMFData":"[{LayerName: "Main Menu", DTMF: 2, LayerNumber: "0"}, {LayerName: "Sales", DTMF: 0, LayerNumber: "15"}]"
CustomDataשדה מסוג מערך JSON, מציג קוסטום דאטה אשר נשלח אלינו, בנוסף במידה ומדובר על שיחה שיש לה מזהה שיחה מקורי, אז גם נתון זה יופיע בשדה זה. "CustomData": {"OriginalIvrUniqueID":"2020072118102as sdsdas"}" / "CustomData": {"var_clientID":"2118102", {"var_clientAccountID":"123456"}"

בקשה לדוגמא בפורמט POST-JSON

{
"code":"xxxxxxxxxxxxxxxxxxxxxxxxxxx",
"fields":[
"CallerNumber",
"TargetNumber",
"Date",
"DateEpoch",
"Duration",
"CallID",
"CustomData",
"Type",
"CdrType",
"DialStatus",
"TargetExtension",
"CallerExtension",
"DID",
"QueueName",
"RecordURL",
"Price",
"RingTime",
"RepresentativeName",
"RepresentativeCode",
"DTMFData",
"DepartmentName",
"DepartmentId"
],
"search":{
"fromdate":"2021-10-02T08:09:40",
"todate":"2021-11-09T23:59:40",
"cdrTypes":[
1,
8,
9
],
"phones":[
"972501234567",
"0722776772"
],
"extensions":[
"SipSip"
],
"IdentityCriteria":"Account",
"CallID":"xxxxxxxxxxxxxxxxxxxxxx"
},
"sort":[
{
"order":"desc",
"field":"date"
},
{
"order":"asc",
"field":"Duration"
}
]
}

1
          

        
[
]

בקשה לדוגמא בפורמט GET

1
2
          
https://api.voicenter.com/hub/cdr/?code=xxxxxxxxxxxxxxxxxxxx&fromdate=2022-06-01T08:09:40&todate=2022-06-
01T23:59:40&phones=972501234567&extensions=SipSip&fields=Date&fields=Type&Fields=DID&Fields=CallerNumber
        
[
]

1
          

        

סוגי שיחות

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

סוג שיחה מספר מזהה תיאור
Incoming Call1שיחה נכנסת רגילה אשר התקבלה דרך מספר טלפון אשר ניתב ישירות לשלוחה מסוימת.
CC2שיחה שבוצעה בעזרת שירות מספר גישה של חברת וויסנטר.
Extension Outgoing4שיחה יוצאת רגילה משלוחה של וויסנטר.
* לא שיחת קליק2קול.
Queue8שיחה נכנסת שהתקבלה אל מעגל המתנה.
Click2Call leg19שיחת קליק2קול (לא שיחת חייגן).
"רגל 1" של השיחה - השיחה בין השירות לשלוחה שאמורה לחייג ליעד ב"רגל 2" של השיחה.
Click2Call leg210שיחת קליק2קול (לא שיחת חייגן).
"רגל 2" של השיחה - השיחה בין השלוחה ליעד.
ברשומה זו תקבלו תיעוד על פרטי השיחה וקישור להקלטות השיחה.
VoiceMail11שיחה אשר נענתה על ידי שירות התא קולי של וויסנטר.
Callference12שיחה שבוצעה בעזרת שירות חדר וועידה של חברת וויסנטר.
XferCDR13שיחה אשר הוערה ידנית משלוחה של מספר/שלוחה אחרת.
ProductiveCall Leg114שיחת "רגל 1" של חייגן לנציג - השיחה אשר מחברת בין השירות לנציג.
ProductiveCall Leg215שיחת "רגל 2" של חייגן לנציג - השיחה אשר מחברת בין הנציג ליעד/לקוח/ליד שהזנתם בחייגן.
Scrubber16שיחה שבוצעה דרך שירות הסקראבר של חברת וויסנטר.
Click 2 IVR17שיחת "רגל 1" של חייגן חכם - השיחה הראשונית בין החייגן ליעד.
Click 2 IVR Incoming18שיחת "רגל 2" של חייגן חכם - השיחה שמתרחשת לאחר חיבור מוצלח ומענה של היעד "ברגל ה1".
בסוג שיחה זה מתבצע חיוג מהיעד אל נתב השיחות שלכם.
סוג שיחה זה מסמן כי השיחה לא עברה למעגל המתנה אלא הועברה ישירות לנציג או השמעת הקלטה.
ברשומה זו תקבלו את סטטוס השיחה וקישור להקלטת השיחה.
Click 2 Queue Incoming19שיחת "רגל 2" של חייגן חכם - השיחה שמתרחשת לאחר חיבור מוצלח ומענה של היעד "ברגל ה1".
בסוג שיחה זה מתבצע חיוג מהיעד אל נתב השיחות שלכם.
סוג שיחה זה מסמן כי השיחה עברה למעגל המתנה והיעד המתין עד למענה של נציג.
ברשומה זו תקבלו את סטטוס השיחה וקישור להקלטת השיחה.
FaxCdr20שיחה אשר בוצעה דרך שירות הפקס הפנימי של וויסנטר.
*השירות לא פעיל עדיין.
Attended CDR leg121שיחה בהעברה עם התייעצות.
Attended CDR leg222שיחה בהעברה עם התייעצות.
רשומה זו תתקיים כאשר מתבצע תסריט שיחה הבא:
נציג א' עונה לשיחה נכנסת, הלקוח מבקש לדבר עם נציג ב'.
נציג א' מתקשר אל נציג ב'.
לאחר מכן נציג א' מעביר את השיחה והלקוח לנציג ב'.
סוג שיחה זה נותן מידע על השיחה של הלקוח עם נציג ב'.
Auto forward23שיחה שהועברה באופן אוטומטי משלוחה למספר טלפון - בדרך כלל מדובר על הגדרה דרך הטלפון IP.
[
]

1
          

        

סטטוסים של שיחות

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

לפניכם טבלה אשר מרכזת את המידע עבור סטטוסים שונים אפשריים.

שם סטטוס תיאור
NOTDIALEDניתוק לפני ביצוע שיחה.
ANSWERמענה של שיחה לאחר חיוג/צלצול מוצלח.
השיחה הגיעה ליעדה.
מענה מתרחש כאשר וויסנטר מקבל איתות של מענה בשיחהכ מו כן גם הגעת השיחה לתא קולי.
BUSYכאשר מנסים לבצע חיוג ליעד מסוים אבל מספר הטלפון שולח בחזרה איתות של "עסוק".
NOANSWERאין מענה. השיחה הגיעה ליעד אך צלצלה למשך זמן מסוים עד לאי מענה.
CANCELביטול שיחה. מצב זה קורה כאשר מחייגים ליעד מסוים אבל מתבצע ניתוק לפני מענה ביעד.
ABANDONEשיחות שהגיעו למעגל המתנה והלקוח המתקשר ניתק לפני מענה מנציג.
TIMEOUTשיחת מעגל המתנה אשר המתינה זמן מקסימלי במעגל.
FULLשיחת אשר ניסתה להצטרף למעגל המתנה אך המעגל היה מלא בממתינים ולא היה ניתן לצרף ממתין נוסף.
EXITשיחת מעגל המתנה אשר לקוח החליט לצאת מהמתנה.
JOINEMPTYלקוח מתקשר ניסה להצטרף למעגל המתנה אך לא היו בו נציגים מחוברים.
VOENDניתוק של השיחה במעמד הנתב ללא צלצול בשלוחה כלשהי או מעגל המתנה.
במקרה זה לקוח התקשר הגיע לנתב השיחות וניתק.
TEמתרחש כאשר השיחה מגיעה לנתב השיחות ומשמיעה הקלטה ולאחר מכן מתנתקת.
NOTCALLEDסטטוס זה מציין כי הרגל השנייה של השיחה לא בוצעה מאחר והרגל ה1 של השיחה לא הייתה מוצלחה (השיחה לא התחברה לשלוחה).
VOICEMAILשיחה הגיעה לתא הקולי של וויסנטר.
CONGESTIONסטטוס זה מסמל לרוב חיוג ליעד לא מוכר.
CHANUNAVAILערוץ לא זמין או שלוחה לא מחוברת ורשומה.
INVALIDARGSשגיאה בעיבוד פקודת חיוג ליעד.
SSWPREAUTHביטול שיחה יוצאת לפני ביצוע חיוג.

דוגמא לתגובה בפורמט POST-JSON

{
"ERROR_NUMBER":0,
"ERROR_DESCRIPTION":"OK",
"STATUS_CODE":200,
"TOTAL_HITS":2,
"RETURN_HITS":2,
"CDR_LIST":[
{
"CallerNumber":"0722776772",
"TargetNumber":"972501234567",
"Date":"2021-10-10T09:04:58Z",
"Duration":2,
"CallID":"202110101204550233243ghff3189e5c",
"CustomData":{
},
"Type":"Extension Outgoing",
"CdrType":4,
"DialStatus":"ANSWER",
"TargetExtension":"",
"CallerExtension":"SipSip",
"DID":"",
"RecordURL":"https://cpanel.voicenter.co.il/CallsHistory/PlayRecord/2021101043950926.mp3",
"RingTime":10,
"RepresentativeName":"rep 1",
"RepresentativeCode":"87654321",
"DTMFData":[
],
"DepartmentName":"Test Account",
"DepartmentId":12345678
},
{
"CallerNumber":"0501234567",
"TargetNumber":"SipSip",
"Date":"2021-10-02T12:55:18Z",
"Duration":0,
"CallID":"202110021555160180fd3jhj455",
"CustomData":{
"OriginalIvrUniqueID":"20211002156fdf534hfgh453df34"
},
"Type":"Incoming Call",
"CdrType":1,
"DialStatus":"CHANUNAVAIL",
"TargetExtension":"SipSip",
"CallerExtension":"",
"DID":"0722776772",
"RecordURL":"",
"RingTime":2,
"RepresentativeName":"rep 1",
"RepresentativeCode":"87654321",
"DTMFData":[
{
"LayerName":"rep 1",
"DTMF":0,
"LayerNumber":"1"
}
],
"DepartmentName":"Test Account",
"DepartmentId":12345678,
"TargetPrefixName":""
}
]
}

1
          

        
[
]

1
          

        

פרמטרים בתגובה

שדה תיאור
ERROR_NUMBERמספר שלם.
מציג מספר שגיאה.
נא עיינו מטה לראות מספרי שגיאות אפשריים.
ERROR_DESCRIPTIONמחרוזת
תיאור מילולי של השגיאה.
STATUS_CODEמחרוזת.
קוד תגובה לבקשת HTTP.
TOTAL_HITSמספר שלם.
מציג את מספר השיחות על טווח הזמן שהגדרתם.
RETURN_HITSמספר שלם.
כמות השיחות שמופיעות בתגובה שקיבלתם.
CDR_LISTמערך של אובייקטים.
כל אובייקט הוא פירוט של שיחה.
[
]

1
          

        

שגיאות אפשריות

מספר שגיאה תיאור שגיאה קוד שגיאה תיאור מילולי
0OK200הבקשה נשלחה בהצלחה.
1Request limit exceeded.
Please try again later.
403יש הגבלה על כמות הבקשות שכל ארגון יכול לשלוח בטווח זמן מסוים.
מומלץ לשלוח בקשה אחת כל 5 דקות.
2Authorization failed.403הקוד בבקשה שלכם אינו תקין.
4IP address xx.xx.xx.xx is not trusted.403הבקשה נשלחה מכתובת IP לא מורשית.
5Out of range404הייתה בעיה עם חיפוש שיחות לפי התאריכים שהוזנו, טווח הזמנים אינו תקין.

דגשים

  • פירוטי השיחות מעודכנים בשירות זה מספר דקות לאחר סיומם.
  • ניתן לקבל עד 10,000 רשומות בבקשה אחת.
  • ניתן לשלוח עד 30 בקשות בדקה.
  • ניתן לשלוח בקשות רק מכתובת IP מורשית.

 

[
]

1
          

        

External Layer API

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

הסבר כללי

מטרת השירות

בעזרת שירות External Layer API תוכלו להרחיב את שירותי נתב השיחות של חברת Voicenter ולהחליט על ניתוב שיחה על פי הלוגיקה העסקית שלכם בעזרת מערכת המידע שלכם/ לפי המידע הקיים במסד הנתונים שלכם.

דוגמאות לשימושים שתוכלו לבצע:

  1. מספר טלפון של הלקוח המתקשר רשום במערכת המידע שלכם כליד אשר החל תהליך מכירה מול נציג מכירות שלכם.
    לפיכך תוכלו לנתב את השיחה ישירות לאותו לאותו נציג לצורך השלמת התהליך.
    ניתוב זה יימנע מהלקוח זמן המתנה ויקנה טיפול יותר ישיר למען השלמת תהליך המכירה.
  2. מספר טלפון של הלקוח המתקשר רשום כאיש קשר קיים/שייך לחשבון קיים אשר יאפשר לכם לנתב את השיחה לנציג
    אשר מטפל בטיקט/קייס פתוח של הלקוח המתקשר
  3. במידה ולפי מספר הטלפון של הלקוח המתקשר הנכם מזהים לקוח VIP תוכלו לבחור לנתב את השיחה למעגל המתנה VIP
    להמשך המשך המתנה מינימלי של הלקוח המתקשר.
  4. כמו כן תוכלו לבקש מהלקוח המתקשרים אליכם להקיש: מספר תעודת זהות, מספר רכב, מספר פוליסה או כל פרט אחר
    יעזור לכם לנתב את השיחה בצורה המיטבית.

 

אפשרויות נוספות

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

שכבות בנתב השיחות

נתב השיחות של Voicenter בנוי משכבות, כל שכבה מבצעת פעולה נוספת (כגון העברת שיחה לנציג/ מעגל המתנה ועוד).
כל שכבה בנתב ממוספרת, עליכם להעביר לחברת וויסנטר URL שלכם אשר ניתן להטמיע בכל שכבה תחת תפריט Layer Settings.
* ניתן לפנות למחלקת התמיכה שלנו על הסבר והדרכה על ניהול נתב השיחות.
ברגע ששיחה מגיעה לשכבה שבה הוגדר ה URL שלכם, חברת Voicenter תיזום אליו בקשת API בפורמט POST-JSON.

פורמט בקשה

1) POST-JSON.

פורמט תגובה

1) POST-JSON

 

[
]

1
          

        

בקשה לדוגמא של השירות

{
"METHOD":"IVR_LAYER_INPUT",
"DATA":{
"DID":"0722776772",
"CALLER_ID":"0501234567",
"IVR_UNIQUE_ID":"1bcd7954224861f85a2d70612f2",
"DTMF":"1234",
"LAYER_ID":5,
"PREVIOUS_LAYER_ID":5
}
}

1
          

        
[
]

1
          

        

פרמטרים בבקשה מהשירות

שם שדה תיאור סוג
METHODהערך תמיד יהיה: IVR_LAYER_INPUT.מחרוזת
DATAאובייקט אשר מכיל את פרטי השיחה.מחרוזת
DIDמספר הטלפון אשר קיבל את השיחה, אשר אליו התקשרו.מחרוזת
CALLER_IDמספר טלפון של הלקוח המתקשר.מחרוזת
IVR_UNIQUE_IDמזהה ייחודי של השיחה.מחרוזת
DTMFהקשות של הלקוח המתקשר בנתב - לדוגמא הקשה של תעודת זהות תשוקף בפרמטר זה.
במידה והלקוח המתקשר לא הקיש כלום, ערך ברירת המחדל יהיה 0.
מחרוזת
LAYER_IDמספר השכבה אשר ממנה נשלחת בקשת API על הURL שלכם.
רצוי לשים לב לפרמטר זה ומאחר ובמידה יש שכבות שונות שמהן תתבצע פנייה אליכם
מספר השכבה יכול לעזור לכם במעקב וביצוע לוגיקה שונה פר פנייה.
מספר שלם
PREVIOUS_LAYER_IDמספר שכבה קודם שבה השיחה עברה לפני ביצוע בקשת API לURL שלכם.מספר שלם

תשובה לדוגמא ללא Custom Data

{
"STATUS":0,
"ACTION":"GO_TO_LAYER",
"LAYER":12
}

1
          

        

תשובה לדוגמא עם Custom Data

{
"STATUS":0,
"ACTION":"GO_TO_LAYER",
"LAYER":22,
"CALLER_NAME":"Shlomi",
"CUSTOM_DATA":{
"CRM_cleint_ID":"12345",
"Last_ticket_ID":"222",
"Last_representative":"John Doe"
}
}

1
          

        
[
]

1
          

        

פרמטרים בתשובה לשירות

שם שדה תיאור סוג הערות
STATUSיש לשלוח את הערך 0 -במידה וקיבלתם את הבקשה בצורה תקינה
יש לשלוח את הערך 1 במידה ונתקלתם בבעיה כלשהי.
מספר שלם.חובה
ACTIONשדה זה מסמל את הפעולה שהשירות של חברת Voicenter יצטרך לבצע, יש 3 אפשרויות
אפשרות 1:GO_TO_LAYER - אתם מבקשים להפנות את השיחה למספר שכבה מסוימת.
אפשרות 2:SAY - אתם מבקשים להשמיע הקלטה מסוימת.
אפשרות 3: DIAL - אתם מבקשים לבצע חיוג לשלוחה/מספר טלפון חיצוני.
מספר שלם.חובה
LAYERמספר השכבה שאליה יש להעביר את השיחה.מספר שלם.חובה
CALLER_ NAMEתוכלו לקבוע את שם המתקשר אשר יוצג בשלוחה של הנציג שבה השיחה מחייגת.מחרוזתרשות
CUSTOM_ DATAמידע ייחודי שלכם שתוכלו לשלוח בבקשה שלכם, לאחר מכן חברת Voicenter תעביר אליכם את המידע הנ"ל בפירוט השיחות למערכת המידע שלכם.מחרוזת.רשות

דוגמא לשימוש בשירות

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

להן בקשת API שנשלחה מחברת Voicenter, לאחר שלקוח חייג לנתב השיחות שלכם והשיחה הגיעה לשכבה מספר 5 - ניתן לראות זאת לפי השדה LAYER_ID.
כמו כן, ניתן לראות בשדה CALLER_ID כי מספר הטלפון של הלקוח הוא 0501234567.
בנוסף, ניתן לראות בשדה DTMF כי הלקוח הקיש בנתב בשכבה 5 את הספרות: 12345678.

[
]

1
          

        
{
"METHOD":"IVR_LAYER_INPUT",
"DATA":{
"DID":"0722776772",
"CALLER_ID":"0501234567",
"IVR_UNIQUE_ID":"1bcd7954224861f85a2d70612f2",
"DTMF":"12345678",
"LAYER_ID":"5",
"PREVIOUS_LAYER_ID":"5"
}
}

1
          

        

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

[
]

1
          

        
{
"STATUS":0,
"ACTION":"GO_TO_LAYER",
"LAYER":12,
"CALLER_NAME":null,
"CUSTOM_DATA":null
}

ניתן לראות כי לפי הערך GO_TO_LAYER בשדה ACTION בחרתם לנתב את השיחה לשכבה מסוימת.
לפי הערך 12 בשדה LAYER השיחה תנותב לשכבה מספר 12.

1
          

        

ניתן לראות כי לפי הערך GO_TO_LAYER בשדה ACTION בחרתם לנתב את השיחה לשכבה מסוימת.
לפי הערך 12 בשדה LAYER השיחה תנותב לשכבה מספר 12.

מתודה SAY

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

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

להלן הפרמטרים אשר תצרטכו לבצע בהם שימוש בתגובה שלכם לשירות על מנת לבצע פעולה של השמעת הקלטה דינאמית:

[
]

1
          

        
[
]

1
          

        

פרמטרים במתודה SAY

שם שדה תיאור סוג הערות
STATUSיש לשלוח את הערך 0 -במידה וקיבלתם את הבקשה בצורה תקינה
יש לשלוח את הערך 1 במידה ונתקלתם בבעיה כלשהי.
מספר שלם.חובה
ACTIONSAY_DIGITSמחרוזת.חובה
NEXT_LAYERמספר השכבה שאליה השיחה תנותב לאחר סיום השמעת ההקלטות.מספר שלםחובה
LANGUAGEהשפה שבה שהלקוח ישמע את ההקלטות שהגדרתם להשמיע, ניתן להגדיר את השפות הבאות: עברית, אנגלית, ערבית ורוסית.בצורה כזו: HE, EN, AR וRU.מחרוזת.רשות
DATAמערך אשר מכיל את המידע שברצונכם להשמיע.
סוגי המידע שניתן להשמיע:
ספרות - Digits, משתנה מסוג מספר שלם, הנתב יקריא ספרה ספרה, לדוגמא מספר טלפון.
מספר - Number, משתנה מסוג מספר שלם, הנתב יקריא מספר לדוגמא יתרת כרטיס נטען.
תאריך - Date, משתנה מסוג מחרוזת, הנתב יקריא את התאריך בפורמן ISO 8601, לדוגמא: 2022-06-12.
תאריך וזמן - DateTime, משתנה מסוג מחרוזת אשר יקריא תאריך וזמן בפורמט ISO 8601, לדוגמא: 2022-06-12T10:12:59 עבור השמעה של נתון זה.
הקלטה - Recording, משתנה מסוג מחרוזת עם מזהה ההקלטה.
מחרוזת.חובה

דוגמא לשימוש בתשובה עם מתודה SAY

{
"STATUS":0,
"ACTION":"SAY_DIGITS",
"NEXT_LAYER":2,
"NEXT_LAYER_IF_FAILED":1,
"LANGUAGE":"EN",
"DATA":[
{
"RecordType":"Recording",
"Content":"9899115_20849570029.mp3"
},
{
"RecordType":"Digits",
"Content":"0501234567"
},
{
"RecordType":"Number",
"Content":"112"
},
{
"RecordType":"Date",
"Content":"2022-06-12"
},
{
"RecordType":"DateTime",
"Content":"2022-12-06T10:12:59"
},
{
"RecordType":"Recording",
"Content":"98972915_209570029.mp3"
}
]
}

מה בעצם יתרחש בעקבות תשובה זו?

סדר פעולות יתרחשו כך:

  1. נתב השיחות ינגן את ההקלטה: 9899115_20849570029.mp3
  2. לאחר מכן, הנתב ישמיע את הספרות: אפס, חמש, אפס, אחד, שתיים, שלוש, ארבע, חמש, שש, שבע.
  3. ההקלטה הבאה, הלקוח המתקשר ישמע: "מאה ושתיים עשרה".
  4. יושמע התאריך שתיים עשרה ליוני אלפיים עשרים ושתיים.
  5.  יושמע התאריך שתיים עשרה ליוני אלפיים עשרים ושתיים בעשר ושתיים עשרה דקות וארבעה עשר שניות.
  6. בסופו של התהליך, הלקוח ישמע את ההקלטה: 98972915_20897670025.mp3.

לאחר מכן, השיחה תנותב לשכבה מספר 2.

1
          

        

מה בעצם יתרחש בעקבות תשובה זו?

סדר פעולות יתרחשו כך:

  1. נתב השיחות ינגן את ההקלטה: 9899115_20849570029.mp3
  2. לאחר מכן, הנתב ישמיע את הספרות: אפס, חמש, אפס, אחד, שתיים, שלוש, ארבע, חמש, שש, שבע.
  3. ההקלטה הבאה, הלקוח המתקשר ישמע: "מאה ושתיים עשרה".
  4. יושמע התאריך שתיים עשרה ליוני אלפיים עשרים ושתיים.
  5.  יושמע התאריך שתיים עשרה ליוני אלפיים עשרים ושתיים בעשר ושתיים עשרה דקות וארבעה עשר שניות.
  6. בסופו של התהליך, הלקוח ישמע את ההקלטה: 98972915_20897670025.mp3.

לאחר מכן, השיחה תנותב לשכבה מספר 2.

מתודה DIAL

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

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

 

[
]

1
          

        
[
]

1
          

        

פרמטרים במתודה DIAL

שם שדה תיאור סוג משתנה הערות
STATUSיש לשלוח את הערך 0 -במידה וקיבלתם את הבקשה בצורה תקינה
יש לשלוח את הערך 1 במידה ונתקלתם בבעיה כלשהי.
מספר שלם.חובה
ACTIONDIALמחרוזת.חובה
CALLER_IDמספר טלפון אשר ישמש כמזהה השיחה, מספר הטלפון אשר היעד יראה כאשר יקבל את השיחה.
לדוגמא: “0722776772”.
מחרוזת.חובה
CALLER_NAMEבמידה והיעד הוא שלוחה של וויסנטר, ניתן להגדיר שם מזהה אשר היעד יראה בעת קבלת השיחה.מחרוזת.רשות
MAX_CALL_ DURATIONמשך שיחה מקסימלי אשר תגדירו (משך זמן השיחה לא כולל את משך זמן חיוג ליעד).מספר שלם.חובה
MAX_DIAL_ DURATIONמשך חיוג מקסימלי אשר תגדירו.מספר שלם.מחרוזת
NEXT_VO_IDמספר השכבה אליה השיחה תנותב במידה והיעד אינו זמין עקב תקלה טכנית ביעד.מספר שלם.חובה
RECORDINGהאם להקליט את השיחה? ניתן להשתמש בערכים "yes" או "no", ברירת המחדל היא לא להקליט את השיחה.מחרוזת.חובה
TARGETSמערך אשר יכלול את היעד לשיחה:
סוג היעד - TYPE, ניתן להגדיר "PHONE" או "EXTENSION" (עבור שלוחה של וויסנטר).
היעד - TARGET - ניתן להגדיר מספר טלפון או מזהה של שלוחה של וויסנטר (סיפ).
מספרי טלפון בינלאומיים יש להגדיר עם קידומת בינלאומית.
מחרוזת.חובה
CUSTOM_ DATAמידע פנימי של מערכת המידע שלכם אשר תוכלו לצרף לתשובה שלכם לשירות, המידע יעבור בהקפצת מסך ובשירות של העברת פירוטי שיחות לאחר סיום השיחה.מחרוזת.רשות

דוגמא לשימוש בתשובה עם מתודה DIAL

{
"STATUS":0,
"ACTION":"DIAL",
"CALLER_ID":"0722776772",
"CALLER_NAME":"Voicenter",
"MAX_CALL_DURATION":1800,
"MAX_DIAL_DURATION":60,
"NEXT_VO_ID":15,
"RECORDING":"yes",
"TARGETS":[
{
"TYPE":"PHONE",
"TARGET":"0501234567"
}
],
"CUSTOM_DATA":{
"CRM_cleint_ID":"12345",
"Last_ticket_ID":"222",
"Last_representative":"John Doe"
}
}

1
          

        

Blacklist API

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

הסבר כללי

מטרת השירות

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

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

 

AddBlackList

URI

 

 

[
]

1
          

        
[
]

1
          
https://api.voicenter.com/Blacklist/AddBlackList
        

פורמט בקשה

1. POST-JSON
2. GET

 

פורמט תשובה

1. POST-JSON

[
]

1
          

        
[
]

1
          

        


פרמטרים בבקשה

שם שדה תיאור סוג הערות
Codeקוד ייחודי לחשבונכם, ניתן לפנות למחלקת התפעול לקבל את הקוד.מחרוזתחובה
Phonesמערך של JSON, אשר יכיל את מספרי הטלפון אשר ברצונכם להוסיף לשירות ה Blacklist על מנת למנוע אליהם חיוג.מערךחובה
Phoneמספר טלפון לחסימה לחיוג, נמצא בתוך המערך תחת Phonesמחרוזתחובה
Nameשם של היעד שנחסם לחיוג.
נתמך רק בבקשות בפורמט POST-JSON
מחרוזתרשות
[
]

בקשה לדוגמא בפורמט GET

1
          
https://api.voicenter.com/Blacklist/AddBlackList?code=xxxxxxxxxxxxxxxxxxxx&phones=0501234567&phones=031234567
        

בקשה לדוגמא בפורמט POST-JSON

{
"Code":"XXXXXXXXXXXXXXXXXXXX",
"Phones":[
{
"Phone":"0501234567",
"Name":"John doe"
},
{
"Phone":"031234567",
"Name":"Walter Melon"
}
]
}

1
          

        
[
]

1
          

        

פרמטרים בתשובה

שם שדה תיאור סוג
ErrorCodeמציין סטטוס כללי לבקשה שלכם:
סטטוס "0" - אין שגיאה.
סטטוס "1" - הפרמטר קוד אינו תקין או הפורמט של הבקשה אינו תקין.
סטטוס "2" - השדה Phone חסר או מכיל מידע לא תקין.
מספר שלם.
ErrorMessageתיאור מילולי כללי של התגובה:
תיאור "OK" - אין שגיאות והכל תקין.
תיאור "Authorization failed" - ערך הקוד או פורמט הבקשה אינו תקין.
תיאור "The Phone field is missing or invalid" - השדה "Phones" חסר.
מחרוזת
Phonesמערך של JSON, עבור כל מספר טלפון שהתווסף ל Blacklist API יתקבל חיווי האם המספר נוסף בהצלחה.מערך
ErrorCodeסטטוס בתשובה של Blacklist API עבור כל מספר טלפון שהתווסף לשירות:
סטטוס "0" - אין שגיאות.
סטטוס "1" - מספרי הטלפון שנרשמו בבקשה אינם בפורמט תקין.
מספרי טלפון יש לרשום בפורמט E.164 בבקשה שלכם.
סטטוס "2" - הייתה שגיאה פנימית בעת ניסיון להוסיף את מספר הטלפון, נא צרו קשר עם מחלקת התמיכה.
מספר שלם
ErrorMessageתיאור בתשובה של Blacklist API עבור כל מספר טלפון שהתווסף לשירות:
תיאור "OK" - אין שגיאות.
תיאור "Please make sure the phone destination is in a valid format" - מספרי הטלפון שנרשמו בבקשה אינם בפורמט תקין של E.164, יש לרשום את מספרי הטלפון בפורמט זה.
תיאור "Internal Error" - הייתה שגיאה פנימית בעת ניסיון להוסיף את מספר הטלפון, נא צרו קשר עם מחלקת התמיכה.
מחרוזת

תשובה לדוגמא של השירות

{
"ErrorCode":0,
"ErrorMessage":"OK",
"Phones":[
{
"ErrorCode":0,
"ErrorMessage":"OK",
"Phone":"972501234567"
},
{
"ErrorCode":0,
"ErrorMessage":"OK",
"Phone":"97231234567"
}
]
}

1
          

        

RemoveBulkFromBlacklist

URI

[
]

1
          

        
[
]

1
          
https://api.voicenter.com/Blacklist/RemoveBulkFromBlacklist
        

פורמט בקשה

1. POST-JSON

2. GET

פורמט תשובה

1. POST-JSON

[
]

1
          

        
[
]

1
          

        

פרמטרים בבקשה

 

שם שדה תיאור סוג הערות
Codeמזהה ייחודי לחשבונכם, ניתן לקבל ממחלקת התפעול.מחרוזתחובה
Phonesמערך של JSON אשר מציין את מספרי הטלפון שיש להסיר משירות Blacklist APIמערךחובה
Phoneמספרי הטלפון אשר יוסרו משירות Blacklist.מחרוזתחובה
[
]

בקשה לדוגמא בפורמט GET

1
          
https://api.voicenter.com/Blacklist/RemoveBulkFromBlacklist?code=xxxxxxxxxxxxxxxxxxxx&phones=0501234567&phones=031234567
        

בקשה לדוגמא בפורמט POST-JSON

{
"Code":"XXXXXXXXXXXXXXXXXXXX",
"Phones":[
{
"Phone":"0501234567"
},
{
"Phone":"031234567"
}
]
}

1
          

        
[
]

1
          

        

פרמטרים בתשובה

שם שדה תיאור סוג
ErrorCodeמציין סטטוס כללי לבקשה שלכם:
סטטוס "0" - אין שגיאה.
סטטוס "1" - הפרמטר קוד אינו תקין או הפורמט של הבקשה אינו תקין.
סטטוס "2" - השדה Phone חסר או מכיל מידע לא תקין.
מספר שלם
ErrorMessageתיאור מילולי כללי של התגובה:
תיאור "OK" - אין שגיאות והכל תקין.
תיאור "Authorization failed" - ערך הקוד או פורמט הבקשה אינו תקין.
תיאור "The Phone field is missing or invalid" - השדה "Phones" חסר.
מחרוזת
Phonesמערך של JSON, עבור כל מספר טלפון שהתווסף ל Blacklist API יתקבל חיווי האם המספר הוסר מהרשימה בהצלחה.מערך
ErrorCodeסטטוס בתשובה של Blacklist API עבור כל מספר טלפון שהתווסף לשירות:
סטטוס "0" - אין שגיאות.
סטטוס "1" - מספרי הטלפון שנרשמו בבקשה אינם בפורמט תקין.
מספרי טלפון יש לרשום בפורמט E.164 בבקשה שלכם.
סטטוס "2" - הייתה שגיאה פנימית בעת ניסיון להוסיף את מספר הטלפון, נא צרו קשר עם מחלקת התמיכה.
מספר שלם
ErrorMessageתיאור בתשובה של Blacklist API עבור כל מספר טלפון שהוסר מהשירות:
תיאור "OK" - אין שגיאות.
תיאור "Please make sure the phone destination is in a valid format" - מספרי הטלפון שנרשמו בבקשה אינם בפורמט תקין של E.164, יש לרשום את מספרי הטלפון בפורמט זה.
תיאור "Internal Error" - הייתה שגיאה פנימית בעת ניסיון להסיר את מספר הטלפון, נא צרו קשר עם מחלקת התמיכה של חברת Voicenter.
מחרוזת

Mute Call Recording API

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

הסבר כללי

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

Mute by extension

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

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

מקרה שימושי

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

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

URI

 

[
]

1
          

        
[
]

1
          
https://monapisec.voicenter.co.il/Comet/API/MuteUnmuteCalls
        
[
]

1
          

        

פרמטרים בבקשה

שם שדה תיאור סוג
extensionמזהה שלוחה שעבורה תרצו לבצע את הפעולה.מחרוזת
state0 - להשתיק הקלטה, 1 - לבטל השתקת הקלטה.מחרוזת
[
]

פורמט בקשה

1. POST - JSON

2. GET

בקשה לדוגמא בפורמט GET

 

1
          
https://monapisec.voicenter.co.il/Comet/API/MuteUnmuteCalls?extension=XXXXXXXX&state=1
        

בקשה לדוגמא בפורמט POST-JSON

{
"extension":"APIAPI",
"state":"1"
}

1
          

        
[
]

1
          

        

פרמטרים בתשובה

שם שדה תיאור סוג
ErrorCodeקוד הפעולה, במידה והבקשה הייתה תקינה קוד הפעולה יהיה 200.מחרוזת
Messageהודעה אשר תתריע על פעולה מוצלחת או לא.
במידה והבקשה שנשלחה היא תקינה תוצג הודעה Success.
מחרוזת
ActionIDמזהה סידורי של הפעולה שביקשתם לבצע.מחרוזת

דוגמא לתשובה תקינה

{
"ErrorCode":"200",
"Message":"Success",
"ActionID":"14d3b31988b247be8ff5818d1cadc3d3"
}

1
          

        

דוגמא לתשובה עם שגיאה

{
"ErrorCode":400,
"Message":"Extension not found"
}

1
          

        

Mute by a specific call (IVR-ID)

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

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

את מזהה השיחה ניתן לקבל דרך שימוש אחד משני הAPIים הבאים:

  1. Real Time API
  2. Active Calls API

URI

https://monapisec.voicenter.co.il/Comet/API/MuteUnmuteCalls

פורמט בקשה

  1. POST-JSON
  2. GET

פורמט תשובה

  1. JSON

 

בקשה לדוגמא בפורמט GET

https://monapisec.voicenter.co.il/Comet/API/MuteUnmuteCalls

 

בקשה לדוגמא בפורמט POST-JSON

[
]

1
          

        
{
"extension":"APIAPI",
"state":"1"
}

1
          

        
[
]

1
          

        

פרמטרים בתשובה

שם שדה תיאור סוג
ErrorCodeקוד הפעולה, במידה והבקשה הייתה תקינה קוד הפעולה יהיה 200.מחרוזת
Messageהודעה אשר תתריע על פעולה מוצלחת או לא.
במידה והבקשה שנשלחה היא תקינה תוצג הודעה Success.
מחרוזת
ActionIDמזהה סידורי של הפעולה שביקשתם לבצע. מחרוזת

דוגמא לתשובה תקינה

{
"ErrorCode":"200",
"Message":"Success",
"ActionID":"14d3b31988b247be8ff5818d1cadc3d3"
}

1
          

        

דוגמא לתשובה לא תקינה

{
"ErrorCode":400,
"Message":"UniqueIvrID not found"
}

1
          

        
{
"ErrorCode":400,
"Message":"Parameters are not valid, should be "ivrid" and "mute" "
}

1
          

        

Organizational Extension List

API זה נועד על מנת להציג את שלוחות הטלפוניה בארגונכם והמידע שלהם.
תוכלו לראות את החיוג המהיר של כל שלוחה, את המזהה שלוחה (סיפ) ועוד שלל פרטים נוספים.
API זה נותן מענה נהדר בשילוב עם Login/Logout API, כאשר נציג ירצה לבצע חיבור לשלוחה שלו דרך המערכת המידע Organizational Extension List API ייתן אפשרות לנציג לבחור את השלוחה הרלוונטית עבורו מתוך כלל השלוחות במחלקה/בארגון שלכם.
 תיאור של אינטגרציית הצגת שלוחות טלפוניות
[
]

 

 

הסבר כללי

URI

 

1
          
https://monitor.voicenter.co.il/Comet/api/GetExtensions
        

 

 

פורמט בקשה

1. POST

2. GET

פורמט תשובה

JSON

 

[
]

1
          

        
[
]

1
          

        

פרמטרים בבקשה

שם שדה תיאור סוג הערות
codeמזהה אישי, מסופק על ידי מחלקת התפעול של Voicenter.מחרוזתחובה
showAllמאפשר לכם לקבוע כי לפי איזו היררכיה בחשבון הAPI יחזיר לכם מידע השלוחות.
תוכלו לקבוע האם לקבל מידע עבור כלל השלוחות של כלל הארגון או של תת חשבון ספציפי.
כדי לקבל מידע עבור תת חשבון ספציפי יש להעביר את הקוד של אותו תת חשבון ולהגדיר "False" או "0".
כדי לקבל מידע עבור כלל הארגון יש להגדיר "True" או "1" .
בוליאנירשות
[
]

בקשה לדוגמה בפורמט GET

1
          
https://monitor.voicenter.co.il/Comet/api/GetExtensions?code=XXXXXXXXXXXXXXX&showAll=0
        

בקשה בפורמט POST-JSON

{
"code":"XXXXXXXXXXXXXXX",
"showAll":0
}

1
          

        
[
]

1
          

        

פרמטרים בתגובה

שם שדה תיאור סוג
ERRסטטוס התשובה:
סטטוס "0" מסמן שאין שגיאות.
סטטוס "1" מסמן שנשלח קוד בפורמט לא תקין.
במידה ונשלח קוד שאינו מתאים לשום חשבון התשובה תהיה מערך ריק.
מספר שלם
DESCתיאור סטטוס התגובה:
במידה והבקשה הייתה תקינה יוחזר הערך "OK" בפרמטר זה.
במידה והקוד שנשלח בבקשה אינו תקין או בפורמט אינו תקין תוצג ההודעה "Unauthorized".
מחרוזת
EXTENSIONSרשימה של כלל השלוחות המבוקשות.מערך
SIPמזהה ייחודי של השלוחה בפרוטוקול טלפוניה SIP.מחרוזת
Nameשם של השלוחה כפי שהיא מופיעה בממשק הניהול (Cpanel).מחרוזת
SpeedDialחיוג מהיר של השלוחה אשר מאפשר לשלוחה לקבל שיחות פנים ארגוניות.מחרוזת
AccountIDמזהה החשבון שהשלוחה מוגדרת בו.מספר שלם
AccountNameשם החשבון שהשלוחה מוגדרת בו.מחרוזת
UserNameשם המשתמש שבו מוגדרת השלוחה.מחרוזת
UserEmailכתובת הדואר האלטקרוני שמוגדרת בממשק הניהול (Cpanel) למשתמש של השלוחה.מחרוזת

דוגמא לתשובה

{
"ERR":0,
"DESC":"OK",
"EXTENSIONS":[
{
"SIP":"SIPSIP1",
"Name":"Extension 1",
"SpeedDial":"11",
"AccountID":12345678,
"AccountName":"Voicenter Account",
"UserName":"John Doe",
"UserEmail":"[email protected]"
},
{
"SIP":"SIPSIP2",
"Name":"Extension 2",
"SpeedDial":"12",
"AccountID":12345679,
"AccountName":"Sales Department",
"UserName":"Walter Melon",
"UserEmail":"[email protected]"
}
]
}

1
          

        

Dialer API

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

 

הסבר כללי

 

סוגי חייגן

 

כאשר הנכם מקימים חייגן אוטומטי תוכלו לפתוח מספר קמפיינים כאשר כל קמפיין משרת מטרה מסוימת (חיוג ללידים חמים/קרים/לידים שהשאירו פרטים מדף נחיתה ועוד).

הקמפיין יכול להיות מסוג מסוים:

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

 

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

  1. תוכלו לבחון אילו קמפיינים פעילים כרגע בארגונכם.
  2. תוכלו להוסיף/להסיר יעדים לחיוג.
  3. תוכלו להפסיק קמפיין מסוים או להפעיל קמפיין כבוי.
  4. תהיה לכם אפשרות להוסיף/להסיר נציגים מקמפיין.

כל מה שתצטרכו לבצע הוא בקשת HTTP פשוטה למתודות המפורטות מטה:

 

[
]

1
          

        
[
]

 

GetCampaignList

 

הסבר כללי

 

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

 

פורמט בקשה

  1. POST-JSON
  2. GET

 

פורמט תשובה

  1. POST-JSON

 

קישור

 

1
          
https://api.voicenter.com/ForwardDialer/Dialer/GetCampaignList
        
[
]

1
          

        

פרמטרים בבקשה

 

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

שם שדה תיאור סוג שדה הערות
Codeמזהה חשבון ייחודי - ניתן לקבל ממחלקת התפעול של וויסנטרמחרוזתחובה
[
]

 

בקשה לדוגמא בפורמט GET

 

1
          
https://api.voicenter.com/ForwardDialer/Dialer/GetCampaignList?Code=XXXXXXXXXXXXX
        

בקשה לדוגמא בפורמט POST-JSON

 

{
"Code":"XXXXXXXXXXXXX"
}

1
          

        
[
]

1
          

        

 

פרמטרים בתגובה

 

שם שדה תיאור סוג
ErrorCodeססטוס התגובה.
במידה ומתקבל "0" סימן שאין שגיאות.
מספר שלם
Descriptionתיאור סטטוס התגובה.
במידה ומתקבל "OK" סימן שאין שגיאה ותיאור שלה.
מחרוזת
Dataמשתמנה מסוג מערך JSON אשר יכיל את הקמפיינים בחשבונכם.מערך
Nameשם הקמפייןמחרוזת
StatusNameמציג את סטטוס הקמפיין, יש שתי אפשרויות:
אפשרות ראשונה: "Enabled" - קמפיין פעיל.
אפשרות שנייה: "Disabled" - קמפיין לא פעיל/
מחרוזת
TotalPendingCallsסכום היעדים אשר ממתינים לחיוג.מספר שלם
MaxPriorityמשתנה אשר מחזיר את עדיפות המקסימלית אשר הוגדרה לכל יעד.מספר שלם
MinPriorityמשתנה אשר מחזיר את עדיפות המינימלית אשר הוגדרה לכל יעד.מספר שלם
TotalAwaitingCallsשדה זה רלוונטי רק עבור קמפיין מסוג חייגן חכם.
שדה זה מציג את סכום היעדים לחיוג קמפיין.
שדה זה יותר מומלץ לשימוש מאשר שדה "TotalPendingCalls" עבור קמפיין מסוג חייגן חכם.
במידה ומדובר על קמפיין מסוג חייגן לנציג שדה זה יציג "null".
מספר שלם
Codeמזהה ייחודי של כל קמפיין, יש צורך בו עבור שימוש בשאר המתודות כמפורט בהמשך.מחרוזת

 

דוגמא לתשובה

 

{
"Data":[
{
"Name":"Campaign1",
"StatusName":"Enabled",
"TotalPendingCalls":23,
"MaxPriority":1,
"MinPriority":1,
"TotalAwaitingCalls":23,
"Code":"XXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
},
{
"Name":"Campaign2",
"StatusName":"Enabled",
"TotalPendingCalls":19,
"MaxPriority":52,
"MinPriority":1,
"TotalAwaitingCalls":null,
"Code":"XXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
}
],
"ErrorCode":0,
"Description":"OK"
}

1
          

        
[
]

 

AddCall

 

הסבר כללי

 

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

 

קישור

1
          
https://api.voicenter.com/ForwardDialer/Dialer/AddCall
        
[
]

1
          

        

פורמט בקשה

  1. POST-JSON
  2. GET

 

פורמט תגובה

  1. POST-JSON

 

פרמטרים בבקשה

 

שם שדה תיאור סוג משתנה הערות
Campaignמזהה ייחודי של הקמפיין, ניתן להשגה על ידי שימוש במתודה GetCampaignList כמתואר מעלה.מחרוזתחובה
Targetמספר טלפון של היעד אליו תרצו לחייג.
עליכם להוסיף קידומת בינלאומית למספר טלפון - לא חובה עבור מספרים ישראלים.
מחרוזתחובה
CustomerNameשם הלקוח של היעד אליו מחייגים.מחרוזתרשות
CallerIDמספר טלפון אשר יוצג כמזהה לנציג אשר מקבל את השיחה ליעד זה.מחרוזתרשות
Priorityעדיפות חיוג על היעד שהוספתם, העדיפות ניתנת לערך שיותר גבוה.מספר שלםרשות
CustomDataיש באפשרותכם להעביר מידע ייחודי שלכם ליעד שהוספתם בעזרת Custom Data יחד עם ערכים שתרצו לוודא שיישלחו אליכם לאחר סיום השיחה.
מידע זה גם יופיע בהקפצת מסך.
מערךרשות
OriginateTimeבמידה ותרצו לקבוע חיוג בתאריך עתידי בזמן Epoch, תוכלו לבצע שימוש במשתנה זה.
במידה ולא נקבע ערך במשתנה זה, החיוג אל היעד יתבצע במועד הכי מוקדם שמתאפשר.
במידה וכן החלטתם לבצע שימוש במשתנה זה עליכם גם לכלול את המשתנה IsDateLocal בבקשה שלכם.
מספר שלםרשות
IsDateLocalמשתנה זה קובע האם שיחות עתידיות יתבצעו בזמן מקומי לפי ההגדרה של חשבונכם בממשק הניהול.
במידה ואתם קובעים ערך "false" לשדה זה החיוג ליעד שהוספתם יתבצע לפי אזור זמן GMT - 0 בינלאומי.
ההמלצה שלנו היא להשתמש בערך "true".
בוליאנירשות
[
]

 

דוגמא לבקשה בפורמט POST - JSON

 

 

דוגמא לבקשה בפורמט GET

 

1
          
https://api.voicenter.com/ForwardDialer/Dialer/AddCallCampaign=XXXXXXXXXXXXXXXXXXXXX&Target=0501234567&CustomerName=John Doe&Priority=42&var_leadID=1234567
        

 

דוגמא לבקשה בפורמט POST - JSON

 

{
"Campaign":"XXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"Target":"0501234567",
"CustomerName":"John Doe",
"CallerID":"0722776772",
"Priority":42,
"OriginateTime":1602750000,
"IsDateLocal":"true",
"CustomData":{
"var_LeadID":1234567,
"var_LeadCampaign":"Facebook"
}
}

1
          

        
[
]

1
          

        

 

פרמטרים בתגובה

 

שם שדה תיאור סוג
ErrorCodeסטטוס התגובה:
סטטוס "0" יעיד על חוסר שגיאות ותקינות הבקשה.
ססטוס "1" יעיד על בקשה שלכם עם קמפיין קוד לא תקין.
סטטוס "2" יעיד על העדרות של ערך בשדה Target בבקשה שלכם.
סטטוס "2-" יעיד על מספר טלפון לא תקין בשדה Target.
מספר שלם
Descriptionתיאור מילולי של השגיאה:
תיאור סטטוס "OK" יעיד על חוסר שגיאה.
תיאור "Invalid campaign code" יעיד על קמפיין קוד לא תקין.
תיאור סטטוס "Campaign code missing" יעיד על חוסר של קוד קמפיין.
תיאור סטטוס "Target missing" יעיד על העדרות של השדה הנ"ל.
תיאור סטטוס "Number is invalid" יעיד על מספר טלפון לא תקין בשדה Target.
מחרוזת

 

דוגמא לתשובה

 

{
"ErrorCode":0,
"Description":"OK"
}

1
          

        
[
]

 

AddCallsBulk

הסבר כללי

 

מתודה זו תיתן לכם מענה על הצורך של הוספת יעדים לחייגן (כאשר רוצים להוסיף יותר מיעד אחד).
במידה ואתם רוצים להוסיף יעד בודד - יש לבצע שימוש במתודה AddCall - המפורטת מעלה.

 

פורמט בקשה

 

  1. POST-JSON

 

פורמט תשובה

 

  1. POST-JSON

 

קישור

 

1
          
https://api.voicenter.com/ForwardDialer/Dialer/AddCallsBulk