الوكلاء
SMS مع Twilio
ما يقدمه رقم Twilio المتصل للوكيل على جانب الرسائل النصية، وما يفعله إجراء إرسال رسالة نصية، وما يحدث للرسالة النصية المرسلة إلى الرقم.
رقم Twilio متصل بوكيل هو خط الهاتف الخاص بالوكيل، وهو أيضًا الرقم الذي يرسل منه إجراء إرسال رسالة نصية. ربط واحد يغطي الاثنين. هذه الصفحة تخص الجانب النصي: ما يفعله إرسال رسالة نصية، وما يحدث لرسالة نصية يرسلها أحد إلى الرقم، وكيف يُنشأ الربط. المكالمات على الرقم نفسه مشروحة في الصوت عبر Twilio.
ما يستطيع الوكيل فعله عبر الرسائل النصية
| الإمكانية | مدعوم |
|---|---|
| الصوت | نعم، على الربط نفسه. راجع الصوت عبر Twilio |
| النص | صادر فقط، عبر إجراء إرسال رسالة نصية |
| الوارد | الرسالة النصية المرسلة إلى الرقم لا يرد عليها الوكيل |
| الصادر | نعم. رسالة واحدة لكل استدعاء لـ إرسال رسالة نصية، ترسل من الرقم المتصل إلى أي رقم هاتف |
| التحويل | لا |
| الوسائط | لا. نص فقط |
المتطلبات على جانب المزوّد
- حساب Twilio، وAccount SID وAuth Token، وكلاهما يظهران في الصفحة الرئيسية لـ Twilio Console على twilio.com/console. الربط يسجّل الدخول إلى Twilio بهما.
- رقم هاتف يتبع حساب Twilio ذاك. الربط يبحث عن الرقم في الحساب، ويرفض رقمًا غير موجود فيه.
- يجب ألا يكون الرقم مربوطًا بالفعل في أي مكان في إيكونوڤا. رقم الهاتف يُربط مرة واحدة، بوكيل واحد.
مفتاح Auth Token يمنح تحكمًا كاملًا في حساب Twilio الخاص بك. الصقه فقط في حقل رمز المصادقة (Auth Token) في نافذة الربط. لا تضعه أبدًا في حقل الشخصية لدى الوكيل، أو في وصف أداة، أو في مستند معرفة، لأن الوكيل يقرأ ذلك في كل دور.
الربط
يستخدم Twilio نموذج ربط واحدًا للمكالمات والرسائل. ربط مرة واحدة يمنح الوكيل الاثنين.
الخطوة 1: افتح تبويب القنوات واختر Twilio
افتح الوكيل واختر القنوات. اضغط إضافة قناة. يدرج الكتالوج Twilio تحت الصوت والاتصالات مع السطر رسائل صوتية ونصية. اختره.

الخطوة 2: املأ تبويب الإعداد
تحمل النافذة عنوان ربط Twilio. يأخذ تبويب الإعداد خمسة حقول، كلها مطلوبة:
- الاسم: التسمية التي تظهر في قائمة القنوات، مثل
Support line. - بيانات الاعتماد: خيار واحد، مفتاح Twilio API. اتركه كما هو.
- رقم الهاتف: رقم Twilio مع رمز الدولة. النص الإرشادي هو
+15551234567. المسافات والشرطات مقبولة وتُحذف؛ ويُحفظ الرقم بصيغته الدولية المختصرة. - Account SID: من حساب Twilio الخاص بك.
- رمز المصادقة (Auth Token): من حساب Twilio الخاص بك. الحقل يخفي ما تكتبه.
يبقى زر ربط معطّلًا حتى يكون لكل من الاسم ورقم الهاتف وAccount SID ورمز المصادقة (Auth Token) قيمة.

الخطوة 3: اقرأ تبويبي المشغلات والأدوات
يحتوي تبويب المشغلات على بطاقة واحدة هي المكالمات الواردة، مع السطر تصل المكالمات إلى هذا الرقم إلى الوكيل المرتبط. أما تبويب الأدوات فعنوانه الإجراءات المتاحة عبر تكامل Twilio.، ويحتوي على بطاقة واحدة هي إرسال رسالة نصية، مع السطر أرسل رسالة نصية إلى أي رقم هاتف من رقمك المرتبط.
الخطوة 4: اضغط ربط
يسجّل الربط الدخول إلى Twilio، ويتحقق من أن الرقم موجود في الحساب، ثم يوجّه الرقم نحو إيكونوڤا بضبط عنوانَي الصوت والرسائل عنه نيابة عنك. لا شيء تلصقه في لوحة Twilio.
الربط يستبدل ما كانت تشير إليه عناوين الصوت والرسائل للرقم من قبل. إذا كان الرقم يخدم تطبيقًا آخر، يتوقف ذلك التطبيق عن استقبال مكالمات الرقم ورسائله النصية.
عند النجاح تظهر رسالة تم توصيل القناة، ويظهر الصف تحت الصوت والاتصالات مع الاسم الذي اخترته، والرقم تحت رقم الهاتف، والعبارة Twilio تحت التوجيه، والشارة نشط.
إرسال رسالة نصية
إرسال رسالة نصية إجراء ضمن أدوات التكامل: إجراء جاهز يأتي من الربط، ويرسل من الرقم المتصل. وصفه، أي النص الذي يقرؤه الوكيل ليقرر متى يستخدمه، هو Send an SMS text message from the connected Twilio number. يأخذ قيمتين، وكلتاهما مطلوبتان:
| المعامل | ما يملؤه الوكيل |
|---|---|
to |
رقم هاتف المستلم بصيغة E.164 (مثل +15551234567). |
body |
نص الرسالة المراد إرسالها. |
ترسل الرسالة من الرقم المتصل إلى to. عندما ترفض Twilio الرسالة، يُبلَّغ الوكيل بفشل الإرسال ويجيب على ذلك.
لا يوجد في البوابة اليوم عنصر تحكم يضيف إرسال رسالة نصية إلى الوكيل؛ يصف تبويب الأدوات في نافذة الربط الإجراء.
إرسال الرسالة لا يكلّف رصيدًا بذاته. الدور الذي استدعى الأداة يُحتسب كأي دور آخر؛ راجع ما الذي يكلفه الدور. أما التكلفة التي تفرضها Twilio على الرسالة فتفوترها Twilio على حسابك لديها.
الرسائل الواردة
الرسالة النصية المرسلة إلى الرقم المتصل تستقبلها Twilio ولا يرد عليها الوكيل، ولا تظهر في المحادثات. للحصول على محادثة نصية ثنائية مع الوكيل، اربط قناة نصية: WhatsApp أو Messenger أو Instagram أو Slack أو نظام دعم.
حدود المزوّد التي تؤثر فيك
| الحد | القيمة | الأثر |
|---|---|---|
| الاتصالات لكل رقم هاتف | 1 | الرقم المربوط بالفعل، في أي مساحة عمل في إيكونوڤا، يُرفض برسالة Phone number "..." is already connected، ويظهر الرقم مكان النقاط |
| صيغة الرسالة | نص عادي | إرسال رسالة نصية يأخذ نص رسالة ولا شيء غيره |
قطع الاتصال
افتح قائمة إجراءات الصف واختر قطع الاتصال. تسمّي النافذة قطع اتصال القناة؟ الربط، وتقول: سيؤدي هذا إلى حذف Support line وبيانات اعتماده المحفوظة نهائيًا. ستبدأ إعادة الاتصال لاحقًا اتصالًا جديدًا تمامًا. عند الفصل تعود إعدادات المكالمات والرسائل للرقم كما كانت. وتظهر رسالة تم قطع اتصال القناة.
تُزال Account SID وAuth Token من إيكونوڤا، وتعيد إيكونوڤا عناوين الصوت والرسائل للرقم إلى ما كانت عليه قبل الربط؛ والرقم الذي لم يكن له عنوان يبقى بلا عنوان. كل عنوان يُفحص على حدة: العنوان الذي وجّهته إلى مكان آخر في لوحة Twilio يُترك كما هو.
إذا تعذّر الوصول إلى Twilio لحظة الفصل، تُزال القناة مع ذلك. تحقّق من عناوين الرقم في لوحة Twilio بعد ذلك.
حل المشكلات
كل خطأ في الربط يظهر في رسالة خطأ تحمل السبب.
Invalid Twilio credentials
رفضت Twilio زوج Account SID وAuth Token. انسخ الاثنين مرة أخرى من حساب Twilio نفسه، ثم أعد المحاولة.
That number isn't in this Twilio account
الرقم لا يملكه الحساب الذي أدخلت بياناته، أو كُتب بصيغة تختلف عن الصيغة التي تعرضها Twilio. تحقّق من رمز الدولة.
Phone number "..." is already connected
الرسالة تحمل الرقم مكان النقاط. الرقم مربوط بالفعل، في مساحة العمل هذه أو في غيرها. افصله هناك أولًا. لنقله بين وكيلين تملكهما، استخدم تعيين لوكيل آخر على الصف الموجود بدلًا من إعادة الربط.
Could not reach Twilio
لم تجب Twilio؛ تحمل الرسالة السبب بعد النقطتين. أعد المحاولة بعد لحظة.
Failed to configure Twilio webhooks
رفضت Twilio التغيير على الرقم. تحمل الرسالة سبب Twilio نفسه عندما تذكره. تحقّق من أن بيانات الاعتماد تخص الحساب الذي يملك الرقم، ثم أعد المحاولة.
الأسئلة الشائعة
هل يرد الوكيل عندما يرسل أحد رسالة إلى الرقم؟
لا. راجع قسم الرسائل الواردة أعلاه للقنوات التي تحمل محادثة نصية ثنائية.
هل يستطيع الوكيل إرسال رسالة نصية إلى متصل أثناء مكالمة؟
هذا ما يخدمه إرسال رسالة نصية: يرسل الوكيل رسالة من الرقم المتصل إلى أي رقم هاتف يُعطاه. راجع قسم إرسال رسالة نصية أعلاه لما تقدمه البوابة لذلك اليوم.
هل يمكنني ربط رقم Twilio واحد بوكيلين؟
لا. الرقم مربوط بوكيل واحد. لنقله، افتح قائمة إجراءات الصف واختر تعيين لوكيل آخر.
هل أحتاج إلى ربط منفصل للرسائل النصية والمكالمات؟
لا. نافذة ربط Twilio نفسها تغطي الاثنين، وصف واحد في قائمة القنوات يحمل الاثنين.
كم تكلّف Twilio؟
تفوترك Twilio على حسابها لديها عن المكالمات والرسائل على الرقم. إيكونوڤا تحتسب المحادثة بحسب الدور، وإجراء إرسال رسالة نصية لا يضيف رسومًا خاصة به.
صفحات ذات صلة
- الصوت عبر Twilio: الجانب الصوتي من الربط نفسه
- نظرة عامة على القنوات: كل القنوات جنبًا إلى جنب، وأيها تشغّل أولًا
- نظرة عامة على الأدوات: ما هو تكامل الأدوات، وكيف يقرر الوكيل استدعاء أداة
- ما الذي يكلفه الدور: ما يُحتسب على دور يستدعي أداة
- الأسرار: مكان بيانات الاعتماد عندما تحتاجها أداة خاصة بك
- حالة الوكيل: ما الذي تفعله الإيقاف المؤقت وما لا تفعله برقم متصل