لماذا لا يعمل وكيلك الصوتي

مرتّبة بحسب التكرار، لا الخطورة. كل فحص أدناه يسمّي الشاشة التي تُنظر إليها، لأن «لا يعمل» هي في الغالب واحدة من أربع شاشات تناقض بعضها بعضًا.

1. الرقم يردّ، لكنه ليس وكيلك

أكثر بلاغ شيوعًا، والأصعب ملاحظة، لأن المكالمة تعمل. الرقم المتصل يردّ قبل أن يُربط به أي شيء — وكيل اختبار يرفع السماعة ويبدو بخير.

الفحص: اتصل بالرقم واستمع إلى First thing your agent says. سماع أي شيء آخر يعني أن الرقم غير مرتبط بوكيلك.

الإصلاح: في /phone-numbers يجب أن يقول الرقم ”… answers this channel” وفيه اسم وكيلك. وفي /agents يجب أن يقول قسم Deployment عبارة Deployed to … لا Not deployed أو No voice channel. أصلح ما يكون خطأ.

2. اختبار المايك يعمل والهاتف لا

هذان يختبران شيئين مختلفين، واجتياز الأول لا يثبت شيئًا عن الثاني. /agents تقول ذلك صراحة: “WebRTC works for browser testing. Phone routes need a number.”

Start mic test تختبر الوكيل. لا تختبر الرقم ولا الربط ولا المشغّل. إن كان اختبار المايك سليمًا والمكالمات لا، فالمشكلة في المسار الهاتفي، فعُد إلى الفحص 1.

3. الوكيل يردّ ولا يعرف شيئًا

ليس عطلًا. الوكيل بلا معرفة مرفقة يردّ صحًّا وبلا فائدة.

الفحص: /agents/knowledge. إن كان فارغًا، فذلك جوابك — “Create an agent first, then add knowledge to ground it.”

أضِف الساعات والأسعار والخدمات والموقع، ثم أعِد اختبار المايك. هذا هو الإصلاح الأعلى مردودًا في القائمة، وليس بلاغ عطل.

4. المكالمة تتصل ثم تفشل

انظر إلى /conversations وابحث عن المكالمة. النتيجة تخبرك أي نصف انكسر:

يعرض Call timeline المراحل — Connecting، Ringing، LIVE، Wrapping up — لترى إلى أين وصلت قبل أن تتوقف.

سلسلة Failed بعد تغيير مشغّل مباشرة تعني عادة أن المشغّل رفض المكالمة: “Carrier didn’t accept the call — please retry in a moment.” افحص Dial format في الرقم — مشغّل يتوقع الصيغة الوطنية يرفض E.164، وقد حُفظ الإعداد بسلاسة.

5. تعمل، لكن لا شيء يُسجَّل

تحدث المكالمات، وبعدها لا يوجد شيء منظّم للنظر إليه.

الفحص: /dialog-insights. الـInsight الذي يعرض Not attached لا يجري أبدًا — “A Dialog Insight only runs on conversations from an agent or campaign it is attached to.” الحفظ والإرفاق فعلان منفصلان.

افحص الحقل نفسه أيضًا: “A Dialog Insight with no fields never produces a result.”

6. تغيّر الصوت من تلقاء نفسه

لم يتغيّر وحده، لكن تغيير الـpipeline يفعل ذلك. خطوط الزمن الحقيقي تحمل أصواتها والقياسي يستخدم أصوات مزوّد التحويل من نص إلى كلام، فتغيير Pipeline يتركك في صمت تختار من قائمة لا تحتوي ما كان عندك. انظر خطوط معالجة الصوت.

7. توقف عن العمل بعد أن أوقفتَ شيئًا

إيقاف وكيل أو أرشفته يوقفه عن الردّ وعن الاتصال. إذا كانت حملة تستخدم ذلك الوكيل جارية، فارتفقت بكل مكالمة متبقّية تُتخطّى وتُوسم، بدل أن تُجرى نيابة عن وكيل تظنّه مطفأً.

إن لم يكن أيٌّ من هذه

اتصل بالرقم من هاتف لم يتصل به قطّ، وراقب /conversations وأنت تفعل. إن لم تظهر أي محادثة أصلًا، فلا شيء وصل إلينا والمشكلة قبل Octo — الرقم أو توجيهه أو المشغّل.