ثلاثة أشياء، في شاشتين. الثالث هو ما يتجاهله الناس، وتجاهله ينتج خطًّا هاتفيًّا يردّ إجابات مقنعة بينما لا يقوم بأيٍّ من عملك.
رقم
/phone-numbers ← Buy a number. تختار بلدًا، ثم تنتقي من Available numbers. هذا هو الطريق السريع ويكتمل في نحو دقيقة.
والبديل هو Bring your own Twilio number، أو اتصال كامل بمشغّل إذا كان لديك واحد أصلًا. تلك العملية من أربع خطوات — Carrier، Connection، Numbers، Verify — وتطلب تفاصيل SIP تحصل عليها من مشغّلك: SIP host، SIP port، Transport، SIP username، SIP password، Caller ID، وDial format مع بادئة ولاحقة اختياريتين.
أمران عن طريق المشغّل يستحقان المعرفة قبل أن تبدأه:
- يحتاج مالكًا أو مشرفًا. “Adding a carrier requires an owner or admin. Nothing was created.”
- الفشل لا يترك فوضى. إذا فشل الإعداد في منتصفه يصلك “Setup failed — nothing was left half-configured.” تبقى بياناتك مملوءة، فإعادة المحاولة لا تعني إعادة كتابة شيء.
صيغة الاتصال (Dial format) أهم مما تبدو. بعض المشغّلات تريد الصيغة الوطنية، وإرسال E.164 إلى واحدة تتوقع الصيغة الوطنية هو إعدادٌ يجتاز التحقق بسلاسة ثم يفشل وقت الاتصال الفعلي.
وكيل
/agents ← أنشئ واحدًا. يحتاج في حده الأدنى اسمًا وموجّه نظام — “Agent name and system prompt are required.” — وتحية، وهي First thing your agent says.
كل شيء آخر عن الوكيل (الصوت، الـpipeline، المعرفة) يمكن أن ينتظر. ما لا يمكن أن ينتظر هو وجود هذا الوكيل قبل أن تربط الرقم، لأن الربط هو الخطوة التالية.
الرابط بينهما
هذه هي الخطوة التي تُتَرك.
في /phone-numbers، يجب أن يقول الرقم ”… answers this channel” وفيه اسم وكيلك. وفي /agents، يجب أن يُظهر قسم Deployment عبارة Deployed to … لا Not deployed أو No voice channel.
إن قال أيٌّ منهما غير ذلك، فلديك رقم ووكيل بلا أي صلة بينهما.
لماذا يردّ الرقم غير المرتبط أيضًا
هنا الفخ. الرقم المتصل يردّ قبل أن تربط أي شيء. وكيل اختبار يرفع السماعة، وتبدو أقواله معقولة، وهو لا يعرف شيئًا عن عملك.
فكلمة «اتصلت به وأجابني أحدهم» ليست دليلًا على نجاح الإعداد. إنها دليل على أن الرقم متصل، وكانت تلك هي السهلة. الفحص الذي يعني شيئًا هو التحية: إن سمعت First thing your agent says فقد وصلت. وإن سمعت أي شيء آخر، فالربط ناقص.
يكلّف هذا الناس وقتًا أكثر مما تكلّفهم كل بنود هذه الصفحة مجتمعة، لأن عرض الخلل هو مكالمة هاتفية تعمل.
هاتف للتجربة
ليس المتصفح. توفّر /agents زر Start mic test — “WebRTC mic test. No phone needed — talk to the agent straight from this page” — وهو مفيد حقًّا لفحص ما يقوله الوكيل.
إنه لا يختبر المسار الهاتفي. الشاشة تقول ذلك بنفسها: “WebRTC works for browser testing. Phone routes need a number.” نجاح اختبار المايك يخبرك أن الوكيل يعمل؛ ولا يخبرك شيئًا عن وصول المكالمات إليه.
استخدم Call this number to test واتصل به من هاتف حقيقي.
منطقة زمنية
اضبط المنطقة الزمنية لمساحة العمل قبل أن يبدأ أي شيء في جدولة نفسه. إنها القيمة الافتراضية التي ستقرأها كل ميزة لاحقة، وتصحيحها لاحقًا لا يصلح بأثر رجعي أي شيء جرى على الخاطئة.