Click2Call API

Click2Call

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

צרו שיחות טלפון יזומות מכל נציג או איש מכירות זמין - באופן אוטומטי! (נהדר! מאיץ ביצועים, מותאם אישית באופן מלא לכל משך זמן).
להפעיל וליזום שיחה חוזרת אוטומטית לליד או לקוח שהשאיר פרטים בדף 'צור קשר', ברגע הם לוחצים על הלחצן 'החל/שלח'. דמיינו את ה-WOW שלהם ואת שיעורי ההמרה שלכם.

שלבו את click2call ב-CRM שלכם, אין ספק שזה ישפר את הביצועים שלךכם ויוודא שאתם מספקים באופן מלא את ה- SLA שלכם (http://en.wikipedia.org/wiki/Service-level_agreement) כפי שאושר.

Click-To-Call API פועל באופן הבא:

כל שיחה שנוצרת באמצעות ה-API יוזמת ומחברת בין 2 "רגליים".

1. רגל 1(Leg 1) היא השיחה הראשונה שהנציג מקבל לעמדה שלו לאחר שיזם שיחה.

פעולה זו מוגדרת על ידי הפרמטר "Phone" שבו אתo מזינים את המזהה של השלוחה של הנציג.

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

הסבר כללי:

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

            
https://api.voicenter.com/ForwardDialer/click2call.aspx

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

            
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"

}

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

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

פורמט הבקשה:

1. POST - JSON
2. GET

פורמט תגובה:

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

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

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

פרמטר	תיאור	חובה/רשות
"phone"	"\"הרגל\" הראשונה שבה שיחת הקליק2קול תחייג. אפשר להטמיע מזהה של שלוחה (SIP, לדוגמא -API1API2) או מספר טלפון בפורמט E.164 אך ללא + (לדוגמא: 972521234567). יש לרשום מספר טלפון ישראלי בצורה הבאה *********0. במידה והחיוג אמור להתבצע לסיפ טראנק יש להגדיר: Phone=SIPTRUNK בבקשה שלכם. במידה ושלוחת וויסנטר בבקשה שלכם תלויה בביצוע לוגין למען הוצאת שיחות על הבקשה שלהם להיראות כך: יש לבצע שימוש בפרמטרים: phone=logincode & phonelogincode=[login code] - את הפרטים הללו ניתן להשיג מתוך ממשק הניהול. "	"חובה"
"target"	"\"הרגל\" השנייה שבה השיחה תחייג - היעד אליו אתם מחייגים. אפשר להטמיע מזהה של שלוחה (סיפ) או מספר טלפון בפורמט E.164 אך ללא +. יש לרשום מספר טלפון ישראלי בצורה הבאה *********0. "	"חובה"
"code"	"קוד ייחודי לחשבון. (הקוד ימסר על ידי מחלקת התפעול שלנו)."	"חובה"
"action"	"Call (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 פרמטרים."	"רשות"
"ignoredncstatus"	"במידה ובחשבונכם מופעל שירות חסימת שיחות מהמאגר הממשלתי - \"אל תתקשר אלי\", יש באפשרותכם לאפשר שיחות ליעדים חסומים במאגר בשירות קליק2קול במידה ותעבירו שדה זה. להלן הערכים שניתן להעביר בשדה זה: 1 - מאפשר לחייג ליעדים חסומים תחת שדה phone. 2 - מאפשר לחייג ליעדים שחסומים תחת שדה target. 3 - מאפשר לחייג ליעדים חסומים גם ב phone וגם ב target."	"רשות"

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

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

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

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

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

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

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

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

{

"ERRORCODE": 0,

"ERRORMESSAGE": "OK",

"CALLID": "sdfsdfsdfsdfdsfsdfdsfsdfsdf0brp"

}

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

            
<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>