פתרון תקלות בשיחות
בדקו שכבה אחת בכל פעם: מספר, ספק טלפוניה, שער קול, חיבור לסוכן, מודל וכלים.
מתודולוגיית אבחון
בודקים שכבה אחת בכל פעם ושומרים 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 אישי בסביבה לא מאובטחת.