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

 

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

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

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

שם שדה תיאור סוג
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
}

תשובה לדוגמא עם 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"
}
}

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

שם שדה תיאור סוג הערות
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.

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

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

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

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

מתודה SAY

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

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

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

פרמטרים במתודה 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.

מתודה DIAL

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

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

 

פרמטרים במתודה 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"
}
}