اربط الرسائل النصية القصيرة عبر Twilio

ترتبط الرسائل النصية القصيرة (SMS) عبر حسابك الخاص على Twilio. فتصل الرسائل المُرسَلة إلى رقمك على Twilio إلى صندوق الوارد على هيئة محادثات، وتعود ردودك إلى العميل رسائلَ نصية من الرقم نفسه.

ما تحتاج إليه

• حساب على Twilio فيه رقم هاتف يدعم الرسائل النصية.
• إما خدمة مراسلة (Messaging Service) تضمّ الرقم ضمن مجموعة المرسِلين فيها (Sender Pool)، وهو الخيار الموصى به، وإما الرقم وحده.
• معرّف الحساب (Account SID) ورمز المصادقة (Auth Token). وتجدهما في الصفحة الرئيسية لـ Twilio Console ضمن قسم Account Info (معلومات الحساب).

المراسلة إلى أرقام أمريكية

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

الخطوات

1. افتح صندوق الوارد في إس تي إس كونكت وانتقل إلى الإعدادات ← قنوات التواصل ← إضافة قناة تواصل.
2. اختر SMS. ستجد تويليو (Twilio) محددًا مسبقًا في قائمة مزود API.
3. أدخل اسم صندوق الوارد لقناة التواصل، كالاسم الذي يعرفك به عملاؤك.
4. أدخل رقم الهاتف بالصيغة الدولية مبدوءًا بالرمز + (مثل +15551234567). ولاستخدام خدمة مراسلة بدلًا من الرقم، فعّل خيار استخدام خدمة مراسلة توليو، وأدخل SID خدمة المراسلة، وهو يبدأ بالحرفين MG.
5. أدخل معرّف الحساب (Account SID) ورمز المصادقة (Auth Token)، ثم اضغط إنشاء قناة Twilio.
6. أضف الموظفين الذين سيتولّون الرد.

رابط الرسائل الواردة يُضبَط تلقائيًا

عند إنشاء صندوق الوارد، تضبط إس تي إس كونكت رابط الرسائل الواردة في حسابك على Twilio تلقائيًا: في صفحة Integration (التكامل) الخاصة بخدمة المراسلة، أو في Messaging Configuration (إعدادات المراسلة) الخاصة بالرقم. فلا حاجة إلى نسخ أي شيء.

أمرٌ واحد لا تستطيع إس تي إس كونكت تفعيله نيابةً عنك: الدول التي يُسمح لحسابك على Twilio بمراسلتها، إذ لا تتيح Twilio تغييرها إلا من لوحة التحكم لأسباب أمنية. قبل مراسلة دولة جديدة، افتح Messaging → Settings → Geo permissions في Twilio، وحدّد تلك الدولة ثم احفظ.

للرجوع إليه، الرابط هو https://app.stsconnect.chat/twilio/callback. ولا تغيّره إلا إذا نقلت الإعداد لاحقًا في Twilio، كأن تنتقل إلى خدمة أخرى أو رقم آخر:

• خدمة المراسلة: Messaging → Services ← خدمتك ← Integration ← Send a webhook (إرسال Webhook)، مع وضع الرابط في حقل عنوان الطلب واختيار الطريقة POST.
• رقم الهاتف: Phone Numbers → Active numbers (الأرقام النشطة) ← رقمك ← Messaging Configuration ← A message comes in (عند وصول رسالة) ← Webhook، مع وضع الرابط في حقل العنوان واختيار HTTP POST.

جرّب القناة

أرسل رسالة نصية إلى رقمك على Twilio من هاتف محمول. ستظهر محادثةً جديدة في صندوق الوارد خلال ثوانٍ. ثم ردّ من صندوق الوارد وتأكد من وصول الرد إلى الهاتف.

حل المشكلات

• الخطأ 21612: بلد المستلم لا يقبل الرسائل من هذا النوع من المرسِلين؛ فمثلًا لا يستطيع رقم محلي أمريكي مراسلة الهواتف المحمولة في المملكة المتحدة. استخدم رقمًا من بلد المستلم.
• الخطأ 21408: الإرسال إلى هذا البلد معطّل في حسابك على Twilio. فعّله من Messaging → Settings → Geo permissions (أذونات المناطق الجغرافية).
• فشل الرسائل إلى الأرقام الأمريكية بالخطأ 30034: الرقم غير مسجّل بعد في حملة A2P 10DLC معتمدة. راجع قسم المراسلة إلى أرقام أمريكية أعلاه.
• الخطأ 21610: ردّ العميل بكلمة STOP، فتُحجب الرسائل إليه حتى يرسل START.
• لا تصل الرسائل الواردة إطلاقًا: تحقّق من الرابط الوارد في القسم السابق. ويجب أن يكون الرقم تابعًا لحساب Twilio نفسه الذي أدخلت معرّفه (Account SID)؛ وإلا تعذّر ضبط الرابط تلقائيًا.

الموافقة على تلقّي الرسائل

• لا تراسل إلا من وافقوا على تلقّي رسائلك.
• التزم بطلبات الإيقاف (STOP). يتولّى Twilio افتراضيًا معالجة الكلمتين STOP وSTART، فيتوقف وصول الرسائل إلى العميل الذي يطلب إلغاء الاشتراك.
• في كندا، تخضع الرسائل التجارية لقانون مكافحة الرسائل المزعجة الكندي (CASL).