מדריכיםפתרון תקלות בשיחות

פתרון תקלות בשיחות

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

מתודולוגיית אבחון

בודקים שכבה אחת בכל פעם ושומרים call ID, שעה וגרסה. מתחילים במספר ובאירוע הספק, ממשיכים ל-gateway, backend, אודיו וכלים.

  • שחזור קצר
  • לוג סביב זמן האירוע
  • שינוי אחד בכל ניסיון
  • חזרה לגרסה ידועה

הסוכן שקט

בדקו שקיים audio stream, שה-codec וה-sample rate נתמכים, שה-VAD מזהה תור ושמודל הקול החזיר אודיו.

  • mute ו-device
  • codec
  • CPU
  • network jitter
  • TTS error

שיחות אינן מופיעות בלוג

אמתו שהמספר משויך לפריסה הנכונה, שה-webhook של ספק הטלפוניה מגיע ושאין clock skew שמוציא את האירוע מטווח החיפוש.

  • number mapping
  • provider event
  • tenant
  • timezone
  • permissions

Playbook אינו נטען

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

  • UTF-8
  • path פעיל
  • reload או restart
  • אין override סותר

אין שיחות נכנסות

בדקו DNS/route של המספר, סטטוס פריסה, מצב Private ומספר Owner. אל תעברו ל-Public רק כדי לעקוף בעיית תצורה.

  • מספר פעיל
  • inbound webhook
  • mode
  • allowlist
  • gateway health

שיחות יוצאות נכשלות

בדקו E.164, הרשאת מדינה, caller ID, יתרה או מגבלה, והאם הבקשה נכשלה לפני החיוג או אצל הספק.

  • +972 ללא 0 מקומי
  • country permission
  • rate limit
  • suppression
  • provider reason

השירות אינו עולה

קראו את השגיאה הראשונה, לא את שרשרת השגיאות שאחריה. בדקו syntax, port תפוס, secret חסר וגרסת runtime.

  • config validation
  • environment
  • port
  • filesystem permissions
  • dependency version

עברית אינה טבעית

ודאו he-IL, קול מתאים, Playbook בעברית וסימני פיסוק שמכוונים הפסקות. בדקו שמות, שעות ומילים מעורבות עם דובר ילידי.

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

בדיקת בטיחות

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