رسائل RCS عبر Twilio

تصل رسائل RCS (Rich Communication Services) إلى تطبيق المراسلة المدمج في الهاتف على شكل محادثة من علامتك التجارية، مع شعارك وبطاقة أو دوّار أو وسائط أو أزرار بدلاً من النص العادي. يرسلها Pushwoosh عبر Twilio كجزء من قناة SMS.

ملاحظة

يستغرق الإعداد وقتاً: وفقاً لـ Twilio، يوافق مشغلو الاتصالات على مرسل RCS خلال 4–6 أسابيع أو أكثر لكل دولة، لذا ابدأ التسجيل مبكراً.

كيف يعمل

تنتقل رسالة RCS من قالب Twilio إلى الهاتف في ثلاث خطوات:

1. تنشئ الرسالة كقالب محتوى (content template) في Twilio.
2. تختار القالب في إعداد SMS مسبق. يمكن لكل لغة في الإعداد المسبق أن تحمل قالبها الخاص.
3. عند إرسال الإعداد المسبق، يحاول Twilio تسليم القالب عبر RCS. الهواتف التي لا تستطيع استقبال RCS تحصل على رسالة SMS بدلاً من ذلك، كما هو موضح في رسالة SMS البديلة.

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

رسالة SMS البديلة

رسالة SMS البديلة هي ما تستقبله الهواتف التي لا تدعم RCS بدلاً من رسالة RCS. إذا كان هاتف المستلم أو مشغل الاتصالات الخاص به لا يدعم RCS، يرسل Twilio رسالة SMS مبنية من النوع Text في القالب.

تأتي رسالة SMS البديلة من القالب، وليس من حقل الرسالة في الإعداد المسبق. إذا لم يحتوِ القالب على النوع Text، فلن تصل الرسالة إطلاقاً إلى الهواتف التي لا تدعم RCS.

ما تحتاجه لإرسال RCS

يعمل RCS فقط عبر حساب Twilio الخاص بك مع Messaging Service ومرسل RCS معتمد من مشغلي الاتصالات.

• Twilio كمزود SMS. اربطه باستخدام Account SID و Auth token الخاصين بحساب Twilio لديك. إذا كان Pushwoosh يوفر رقم Twilio وبيانات الاعتماد لمشروعك، فإن RCS غير متاح، ويتم رفض عمليات الإرسال هذه.
• Twilio Messaging Service. يحتوي مجمع المرسلين (sender pool) الخاص به على مرسل RCS ورقم SMS. يُدخل معرف SID الخاص به في Messaging Service SID في إعدادات منصة SMS. بدونه، يفشل إرسال الرسالة التي تحتوي على قالب.
• رقم From. اضبطه في إعدادات منصة SMS على رقم SMS من مجمع Messaging Service. لا يرسل Pushwoosh رسائل SMS عبر Twilio بدونه، حتى عند ضبط Messaging Service.
• مرسل RCS معتمد من مشغلي الاتصالات في الدول التي ترسل إليها. يتولى Twilio عملية التسجيل. وفقاً لـ Twilio، تستغرق 4–6 أسابيع أو أكثر لكل دولة.

إعداد RCS في Twilio

تُنفذ هذه الخطوات في Twilio Console. تتبع أسماء القوائم دليل إعداد RCS من Twilio وقد تختلف قليلاً في وحدة التحكم لديك.

إنشاء مرسل RCS

مرسل RCS هو ملف تعريف العلامة التجارية الذي يراه المستلمون في المحادثة: اسمك وشعارك وألوانك.

1. اذهب إلى Communications → Numbers & senders → Overview → RCS.

2. انقر على Create RCS Sender.

3. أدخل Sender display name.

4. وافق على الشروط وانقر على Continue.

5. في Public details، املأ جميع الحقول:

   • Display name و Description.
   • Logo image (224×224 بكسل، حتى 50 KB) و Banner image (1440×448 بكسل، حتى 200 KB)، كعناوين URL عامة لصور JPG أو PNG.
   • Accent color بنسبة تباين لا تقل عن 4.5:1 مقابل اللون الأبيض، على سبيل المثال #1A73E8.
   • رقم هاتف أو بريد إلكتروني للتواصل، و Privacy policy URL، و Terms of service URL.

6. انقر على Next.

إضافة هاتف اختبار

إلى أن يوافق مشغلو الاتصالات على المرسل، فإنه يسلّم الرسائل إلى هواتف الاختبار فقط.

1. في Try it out، انقر على Add device to test this sender.
2. أدخل رقم هاتف Android بالتنسيق الدولي وانقر على Invite.
3. على الهاتف، افتح الدعوة في Google Messages واضغط على Make me a tester.
4. في وحدة التحكم، تأكد من أن مالك الهاتف قد قبل الدعوة.
5. أرسل رسالة من Your message. يجب أن تصل كمحادثة من علامتك التجارية مع الشعار، وليس كرسالة SMS.

تسجيل المرسل لدى مشغلي الاتصالات

لا يضيف Twilio مرسل RCS إلى Messaging Service إلا بعد موافقة مشغل اتصالات واحد على الأقل عليه، لذا ابدأ التسجيل قبل إنشاء Messaging Service.

1. في مرسل RCS، افتح Compliance registration.
2. انقر على Add countries.
3. اختر الدول التي ترسل إليها وانقر على Save countries.
4. انقر على Start.
5. املأ النموذج وانقر على Submit registration. بالنسبة للولايات المتحدة، لدى Twilio نموذج منفصل هو US registration.

تظهر حالة التسجيل على أنها Pending Review إلى أن يوافق عليها مشغلو الاتصالات.

إنشاء Messaging Service

تجمع Messaging Service بين مرسل RCS ورقم SMS، حتى يتمكن Twilio من اختيار RCS أو SMS لكل هاتف.

1. اذهب إلى Messaging → Services.
2. أنشئ خدمة.
3. في Sender Pool، أضف رقم Twilio يدعم SMS. بدونه، لن تصل أي رسالة إلى الهواتف التي لا تدعم RCS.
4. بمجرد أن تظهر دولة واحدة على الأقل بحالة Approved في Compliance registration، أضف مرسل RCS إلى Sender Pool.
5. انسخ معرف SID الخاص بالخدمة. يبدأ بـ MG.

إنشاء قالب محتوى

يحدد قالب المحتوى رسالة RCS ورسالة SMS البديلة الخاصة بها.

1. اذهب إلى Messaging → Content Template Builder.
2. انقر على Create new.
3. اختر نوعاً يدعم RCS: Card أو Carousel أو Quick reply أو Call to action أو Media.
4. املأ المحتوى. للقيمة التي تتغير حسب المستلم، استخدم متغيراً مرقماً، على سبيل المثال {{1}} للاسم الأول في عنوان البطاقة.
5. لتفريع الرحلة بناءً على الرد، أضف أزرار رد سريع (quick reply) وامنح كل زر معرفاً (ID). لا تستخدم default أو معرفاً يبدأ بـ output: لا يحصل مثل هذا الزر على فرع في الرحلة.
6. أضف النوع Text إلى القالب نفسه. يبني Twilio رسالة SMS البديلة منه.
7. احفظ القالب.

ربط Twilio في Pushwoosh

يرسل Pushwoosh رسائل RCS باستخدام بيانات اعتماد Twilio و Messaging Service التي تدخلها في إعدادات منصة SMS.

1. اذهب إلى الإعدادات ← تهيئة المنصات.

2. افتح SMS.

3. اضبط مزود SMS على Twilio.

4. املأ الحقول:

   • From number: رقم SMS من مجمع Messaging Service.
   • Account SID و Auth token: بيانات اعتماد حساب Twilio الذي يملك مرسل RCS والقوالب.
   • Messaging Service SID (optional): معرف SID الذي يبدأ بـ MG الخاص بـ Messaging Service. الحقل اختياري لرسائل SMS، لكن RCS يحتاج إليه.

5. انقر على تطبيق.

لبقية إعدادات SMS، راجع تكوين منصة الرسائل القصيرة (SMS). لا تحتاج حالات تسليم رسائل RCS إلى إعداد webhook، لأن Pushwoosh يرسل عنوان URL الخاص بـ status callback إلى Twilio مع كل رسالة.

استقبال الردود

تصل الردود على رسائل RCS إلى Pushwoosh فقط عبر webhook تضبطه على مرسل RCS.

1. في Twilio Console، افتح مرسل RCS وانتقل إلى Configuration.
2. اضبط Webhook URL for incoming messages على عنوان URL للرسائل القصيرة الواردة من خطافات الويب لمزود خدمة الرسائل القصيرة (SMS)، مع الطريقة POST.
3. انقر على Save configuration.

يتعامل Pushwoosh مع رد RCS بالطريقة نفسها التي يتعامل بها مع رد SMS. فهو يطلق الحدث PW_SMSReceived لرقم هاتف المرسل، ويضبط الرد STOP وسم الموافقة التسويقية للمشترك على false. راجع الموافقة التسويقية على SMS وViber.

إرسال رسالة RCS

تُرسل رسالة RCS أينما ترسل إعداد SMS مسبقاً يحتوي على قالب.

1. افتح إعداد SMS مسبقاً أو أنشئ واحداً.
2. اختر قالب Twilio لكل لغة في كتلة RCS، كما هو موضح في الإرسال عبر RCS.
3. أرسل الإعداد المسبق في حملة SMS أو في Customer Journey.

في الرحلة، يحصل عنصر SMS الذي يحتوي على قالب رد سريع على فرع لكل زر، وينتظر نقرة لمدة تصل إلى 24 ساعة. راجع التفرع حسب أزرار الرد في RCS.

التحقق من إحصائيات RCS

لمعرفة عدد عمليات التسليم المؤكدة عبر RCS، وعدد ما وصل منها كرسائل SMS، ونسبة مستلمي RCS الذين قرأوا الرسالة، افتح Message stats الخاصة بهذا الإرسال.