פירוט שיחות ממרכזייה: PayCall, חיבור API ותמלול AI

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

מה מקבלים:

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

משתמשים ב-Voicenter? יש לה מדריך משלה: חיבור Voicenter. היסטוריית השיחות והתמלול (סעיפים 5-8 כאן) עובדים גם עם Voicenter.

1. איזה חיבור מתאים לכם

במסך חיבורים למערכות (הגדרות → חיבורים למערכות) יש קבוצה בשם מרכזייה, עם שלושה כרטיסים:

כרטיס	למי
ווייסנטר	מרכזיית Voicenter. ראו המדריך שלה.
פייקול	מרכזיית PayCall. TASKEY כבר מכיר את הפורמט שלהם. מוסרים להם כתובת אחת, וזהו.
פירוט שיחות API	כל מרכזייה אחרת שיודעת לשלוח את פרטי השיחה לכתובת Webhook בסוף כל שיחה.

כרטיס עם פעיל וירוק = החיבור פועל בחשבון שלכם.

2. לפני שמתחילים

• את החיבור מפעיל צוות TASKEY. פנו לתמיכה ובקשו להפעיל פירוט שיחות עם PayCall או עם פירוט שיחות API. בחיבור הזה אתם לא תמצאו מתגי הפעלה במסך ההגדרות. המתגים האלה בידי צוות TASKEY, והכרטיס הגדרות חיבור במסך ה-API נראה אצלכם ריק.
• את שאר ההגדרות (הכרטיסים בסעיפים 3-4) עושה מנהל החשבון.
• המרכזייה צריכה לשלוח את פרטי השיחה בסוף כל שיחה. את זה מגדיר אצלה ספק המרכזייה, לפי מה שתמסרו לו.

3. מה למסור לספק המרכזייה

PayCall

1. פתחו הגדרות → חיבורים למערכות ולחצו על הכרטיס פייקול.
2. העתיקו את הכתובת מהכרטיס Webhook URL ושלחו אותה ל-PayCall. בקשו מהם לשלוח אליה את פרטי השיחה בסוף כל שיחה.

כתובת ה-Webhook אישית לחשבון שלכם:

https://<שם-החשבון>.taskey.co.il/webapi/CallLogPaycall.php

כל מרכזייה אחרת (פירוט שיחות API)

1. פתחו הגדרות → חיבורים למערכות ולחצו על הכרטיס פירוט שיחות API.
2. העתיקו את הכתובת מהכרטיס Webhook URL:

https://<שם-החשבון>.taskey.co.il/webapi/CallLogAPI.php

3. שלחו לספק המרכזייה את הכתובת ואת רשימת הפרמטרים מהכרטיס תיעוד API שבתחתית אותו מסך:

שיטת השליחה: POST (x-www-form-urlencoded), שליחה אחת בסוף כל שיחה.

פרמטר	חובה	מה זה
callid	כן	מזהה ייחודי של השיחה במרכזייה.
call_direction	כן	INBOUND לשיחה נכנסת, OUTBOUND לשיחה יוצאת.
phone	כן	המספר של הלקוח (בשיחה נכנסת - מי שהתקשר, ביוצאת - למי התקשרו). לפיו השיחה מתחברת לליד.
TargetNumber	לא	הקו של העסק בצד השני של השיחה.
extension	לא	השלוחה של הנציג.
Duration	לא	משך השיחה בשניות.
start_date	לא	תאריך ושעת השיחה. בלי זה נרשמת שעת הקליטה.
RecordURL	לא	קישור מלא להקלטה. בלי הקלטה אין נגן ואין תמלול (סעיף 7).
summary	לא	טקסט חופשי: סיכום או הערה על השיחה. מוצג בעמודה סיכום.

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

איך בודקים שזה עובד? עשו שיחת ניסיון אחרי שהספק סיים להגדיר, ופתחו את היסטוריית שיחות (סעיף 5). השיחה אמורה להופיע בראש הרשימה.

4. ליד חדש משיחה נכנסת ותיעוד בכרטיס

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

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

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

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

5. היסטוריית השיחות

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

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

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

עמודה	מה רואים
סוג	נכנסת, יוצאת, לא נענתה או יוצאת - לא נענתה (באדום).
מתי	מועד השיחה.
איש קשר	הליד. לחיצה פותחת את כרטיס הליד. אין ליד? מופיע שייך ליד.
טלפון	המספר של הלקוח, ומתחתיו מזהה השיחה במרכזייה.
מסלול שיחה	מי חייג למי. הקו של העסק מוצג כהקו שלכם (סעיף 4).
שלוחה	השלוחה של הנציג.
משך	דקות:שניות.
סיכום	הסיכום שנשלח מהמרכזייה, או סיכום ה-AI (סעיף 6).
הקלטה	נגן פותח את ההקלטה בחלון חדש. בלי קישור להקלטה מופיע קו.
נתונים	JSON - הנתונים כפי שהמרכזייה שלחה. שימושי לבדיקה מול הספק.

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

מי רואה את השיחות:

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

6. השיחות בכרטיס הליד

בכרטיס הליד לחצו על הלשונית שיחות:

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

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

7. תמלול וסיכום שיחות AI

כשהתמלול פעיל, כל שיחה מוקלטת עוברת תמלול בעברית וסיכום חכם, בלי שתצטרכו ללחוץ על כלום.

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

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

• סיכום קצר של השיחה, בשתי שורות.
• תגיות: הסנטימנט של הלקוח (חיובי, נייטרלי או שלילי), ציון שביעות רצון מתוך 10 ומספר המשימות שעלו בשיחה.
• פרטים - פותח את הנושאים של השיחה, את משימות להמשך ואת הקישור תמלול מלא. סגור מקפל בחזרה.

אם תיעוד השיחה בכרטיס הליד פועל (סעיף 4), הסיכום, הנושאים והמשימות נרשמים גם בתגובות של הליד, תחת סיכום שיחה (AI). כל מי שרואה את השיחות (סעיף 5) רואה גם את התמלול.

מצבי התמלול שמופיעים מתחת לסיכום:

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

8. פתרון תקלות

מה רואים	למה זה קורה	מה עושים
שיחות לא מגיעות להיסטוריה	הספק עוד לא הגדיר את ה-Webhook, הגדיר כתובת אחרת, או שהחיבור לא הופעל	שלחו לספק שוב את הכתובת מהכרטיס Webhook URL, בדיוק כמו שהיא. ודאו מול התמיכה שהחיבור הופעל.
אין הכפתור שיחות בסרגל העליון	החיבור עוד לא הופעל, או (ב-PayCall) פירוט שיחות עם הרשאות פועל ולתפקיד אין יומן שיחות	פנו לתמיכה, או תנו לתפקיד את ההרשאה יומן שיחות.
שיחה מופיעה עם שייך ליד	אין ליד פעיל עם המספר הזה בשדה טלפון או טלפון נוסף	לחצו שייך ליד, או הוסיפו ליד עם המספר ולחצו שוב.
שיחה עם ליד שגוי, או בלי ליד למרות שיש ליד	הספק שולח ב-phone את המספר של העסק במקום את המספר של הלקוח	בקשו מהספק לשלוח ב-phone את המספר של הצד החיצוני. בדקו מה נשלח בכפתור JSON.
בעמודה סוג מופיע שיחה (או הערך שהספק שלח) במקום נכנסת / יוצאת, ולא נפתח ליד לשיחה נכנסת	הספק לא שולח call_direction, או שולח ערך אחר	בקשו מהספק לשלוח INBOUND או OUTBOUND. עד אז התיעוד בכרטיס הליד יירשם כשיחה יוצאת.
אותה שיחה מופיעה פעמיים	המרכזייה שלחה אותה פעמיים	בקשו מהספק לשלוח כל שיחה פעם אחת (סעיף 3).
אין נגן ואין תמלול	המרכזייה לא שולחת RecordURL	בקשו מהספק לשלוח קישור מלא להקלטה.
שיחה עם הקלטה, ועוד אין סיכום	התמלול רץ בסבבים, ולוקח זמן עד שמגיע תור השיחה	חכו. אם עברו כמה שעות, פנו לתמיכה.
שגיאת תמלול	ההקלטה לא נגישה מהקישור, או שהקובץ פגום	לחצו נגן ובדקו שההקלטה נפתחת. אחרי שהבעיה תוקנה, פנו לתמיכה כדי לתמלל שוב.
לא נפתח ליד לשיחה נכנסת ממספר חדש	המתג יצירת ליד משיחה נכנסת כבוי, או שהשיחה לא נשלחה כנכנסת (INBOUND)	הפעילו את המתג (סעיף 4) ובדקו את call_direction.

שאלות נפוצות

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

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

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

ש: מי רואה את התמלולים? ת: כל מי שרואה את השיחות. ב-PayCall אפשר להגביל את זה בעזרת פירוט שיחות עם הרשאות (סעיף 5).