Delivyr SMS

Delivyr شريك SMS للرسائل إلى أرقام الولايات المتحدة وكندا. ترسل القوالب التي اعتمدتها Delivyr فقط - لا توجد رسائل SMS بنص حر عبر Delivyr. تشغّل Delivyr خدمتها وتحفظ بيانات الرسائل في الولايات المتحدة.

لمن هذا

للشركات التي ترسل SMS إلى مستلمين في الولايات المتحدة أو كندا، ولديها حساب لدى Delivyr أو تفتح حسابًا. يمكن أن تُستضاف مساحة عملك في Joryio في الاتحاد الأوروبي أو في الولايات المتحدة؛ المهم أن تكون أرقام المستلمين من الولايات المتحدة أو كندا (+1).

ربط حساب Delivyr الخاص بك

تستخدم حساب Delivyr الخاص بك وتربطه بنفسك، من بطاقة Delivyr في التكاملات. تحتاج إلى معلومتين من بوابة Delivyr، كلتاهما ضمن Settings > General:

• Account ID الخاص بك لدى Delivyr
• مفتاح API من Delivyr

1. افتح التكاملات واختر Delivyr (ضمن الرسائل).
2. أدخل Account ID ومفتاح API. إذا منحت Delivyr حسابك رقم إرسال، يمكنك إدخاله أيضًا. تختار Delivyr الرقم الذي ترسل منه، لذا يعرضه Joryio كمرسل فقط؛ ومن دونه يظهر المرسل باسم "Delivyr".
3. انقر اختبار الاتصال للتحقق من التفاصيل مع Delivyr، ثم ربط Delivyr. يتحقق Joryio منها مجددًا، ويربط الحساب بمساحة العمل هذه، ويقرأ قوالبك لأول مرة.

بعد الربط، تعرض البطاقة Account ID والمرسل وموعد آخر مزامنة للقوالب وعددها، مع اختبار الاتصال وتحديث القوالب واستبدال مفتاح API وفصل. هذا المرسل هو ما تختاره في خطوة SMS في حملة أو رحلة.

• من يمكنه الربط. يمكن لمسؤولي مساحة العمل فقط - صلاحية الإعدادات: كتابة - الربط أو استبدال المفتاح أو الفصل. يرى الأعضاء الآخرون البطاقة لكن لا يمكنهم تغييرها.
• مفتاح API. يُحفظ مشفرًا ولا يُعرض مرة أخرى. لتغييره استخدم استبدال مفتاح API؛ يُختبر المفتاح الجديد مع Delivyr قبل حفظه.
• عدة حسابات لكل مساحة عمل، ومساحة عمل واحدة لكل حساب. يمكن لمساحة العمل ربط عدة حسابات Delivyr - مثلًا حساب لكل علامة تجارية - ويظهر كل منها على البطاقة باسمه الخاص. لا يمكن ربط حساب Delivyr إلا بمساحة عمل واحدة في Joryio: يحتفظ Delivyr بالقوالب وقائمة STOP لكل حساب، لذا فإن حسابًا مشتركًا بين مساحتي عمل سيشارك قائمة STOP واحدة.
• مساحات العرض التجريبي. في العرض التجريبي، لا يعمل الربط إلا إذا فتح Joryio العرض للاتصالات الخارجية.
• الفوترة. كما في أي حساب SMS تجلبه، تدفع لـ Delivyr مقابل الرسائل وفق اتفاقك معها، ويضيف Joryio رسوم المنصة لكل رسالة.

إذا فشل اختبار الاتصال، توضح البطاقة السبب - مثلًا أن Delivyr لم تقبل Account ID ومفتاح API، أو لم ترد. الاتصال جديد، فإذا فشل فحص بطريقة تبدو خاطئة، تواصل معنا وسنراجعه معك. تواصل معنا أيضًا إذا لم يكن لديك حساب Delivyr بعد.

عدة حسابات Delivyr

يمكن لمساحة العمل الإرسال عبر أكثر من حساب Delivyr، مثلًا حساب لكل علامة تجارية. لإضافة حساب، انقر ربط حساب Delivyr آخر أسفل الحسابات المربوطة وأدخل Account ID ومفتاح API الخاصين به كما سبق. امنحه اسمًا - العلامة التجارية مثلًا - لتتمكن من التمييز بين الحسابات: يظهر الاسم على البطاقة وعند اختيار مرسل الرسائل النصية وفي صفحة قوالب الرسائل النصية. بدون اسم، يُسمى الحساب الأول "Delivyr" والحسابات التالية "Delivyr" مع Account ID الخاص بها. يمكنك إعادة تسمية الحساب لاحقًا بالقلم بجوار اسمه.

كل حساب منفصل:

• بطاقة خاصة به. لكل حساب مرسله وقوالبه واختبار الاتصال وتحديث القوالب واستبدال مفتاح API والفصل الخاصة به. فصل حساب واحد يترك الحسابات الأخرى مربوطة.
• قوالب خاصة به. يعرض محرر الرسائل النصية قوالب الحساب الذي ينتمي إليه الرقم المختار، ويذكر اسم ذلك الحساب. ينتمي القالب إلى حساب واحد ولا يُرسل إلا عبره: إذا غيّرت الرقم إلى حساب آخر، فاختر أحد قوالب ذلك الحساب. تعرض صفحة قوالب الرسائل النصية الحساب الذي ينتمي إليه كل قالب، وتسأل لأي حساب القالب الجديد.
• رابط webhook وقائمة STOP خاصان به. لكل حساب رابط تقارير التسليم الخاص به، وطلب STOP الذي يبلّغ عنه حساب واحد يلغي اشتراك جهة الاتصال من رقم ذلك الحساب فقط.

الفصل

يطلب فصل التأكيد أولًا. ويُرفض ما دامت حملة أو رحلة نشطة أو مجدولة أو متوقفة مؤقتًا أو بانتظار الموافقة ترسل عبر Delivyr؛ تعرضها البطاقة لتتمكن من إيقافها أو نقلها إلى رقم SMS آخر أولًا. لا تمنع المسودات الفصل - تشير إليها مراجعة الإطلاق بعد فصل Delivyr. يزيل الفصل من مساحة العمل هذه المفتاح المحفوظ ومرسل Delivyr والقوالب المتزامنة. لا يتغير شيء في حساب Delivyr الخاص بك.

القوالب

كل رسالة عبر Delivyr هي قالب. توجد قوالبك في صفحة SMS Templates في Brand Studio، التي تظهر بمجرد ربط Delivyr بمساحة العمل.

• أُنشئت في بوابة Delivyr. تُزامَن القوالب التي تنشئها وتُعتمد في بوابة Delivyr مع Joryio كل 30 دقيقة، أو فورًا عند النقر على تحديث من Delivyr.
• أُنشئت في Joryio. يرسل قالب جديد القالب إلى Delivyr للمراجعة. يظهر قيد المراجعة حتى تعتمده Delivyr أو ترفضه.
• قوالب نظام Delivyr. تظهر أيضًا قوالب Delivyr الجاهزة، ويمكن إرسالها دون مراجعة.

لا يمكن تعديل النص المعتمد. لتغيير الصياغة، أنشئ قالبًا جديدًا. التفاصيل والحالات ونصائح الكتابة في قوالب SMS (Delivyr).

الإرسال في الحملات والرحلات

عندما ينتمي الرقم الذي ترسل منه إلى حساب Delivyr، يعرض محرر SMS منتقي قوالب بدلًا من مربع الرسالة - في الحملات وفي خطوة SMS في الرحلة.

1. اختر قالبًا معتمدًا. لا تظهر القوالب التي ما زالت قيد المراجعة.
2. املأ كل {{variable}} في القالب. اكتب نصًا أو استخدم تخصيص Liquid مثل {{ user.first_name }}؛ تحصل كل جهة اتصال على قيمها الخاصة عند الإرسال.
3. ضع عنوان الوجهة في {{link}}. يرسله Joryio كرابط قصير متتبَّع خاص به، فتُحتسب النقرات كما في أي رابط SMS آخر.
4. اطّلع على المعاينة واستخدم إرسال اختبار لإرسال القالب إلى رقم اختبار.

تُنبّه مراجعة الإطلاق إلى رسالة SMS على حساب Delivyr بلا قالب، أو بقالب غير معتمد، أو بمتغير فارغ. يعتمد إيقاف الإطلاق بسبب هذه الملاحظات على إعداد مراجعة الإطلاق في مساحة عملك، لكن Delivyr نفسها لا ترسل مثل هذه الرسالة أبدًا، لذا أصلحها قبل الإطلاق. المزيد عن المحرر: حسابات Delivyr: القوالب المعتمدة.

الموافقة وإلغاء الاشتراك

• تتولى Delivyr أمر STOP. عندما يرد مستلم بـ STOP، تتوقف Delivyr عن الإرسال إلى ذلك الرقم من حسابك. وتظل عمليات إلغاء الاشتراك وقواعد الموافقة الخاصة بـ Joryio سارية قبل أي إرسال.
• التأكيد المزدوج (double opt-in). إذا كان التأكيد المزدوج مفعّلًا في حساب Delivyr الخاص بك، فلا ترسل Delivyr القوالب العادية إلى رقم إلا بعد أن يؤكد المستلم. لدى Joryio حالة مطابقة لجهة الاتصال، بانتظار التأكيد - راجع إدارة الاشتراكات.

بعد إعداد تقارير التسليم، تُنسخ إلغاءات الاشتراك من Delivyr إلى جهة الاتصال في Joryio: يلغي STOP اشتراكها في SMS، ويعيد رد YES أو UNSTOP اشتراكها (ويؤكد جهة اتصال في حالة بانتظار التأكيد). دون تقارير التسليم، تبقى ردود STOP والتأكيدات لدى Delivyr فقط. وعندما تحتفظ Delivyr بإلغاء اشتراك جهة اتصال في SMS، تذكر صفحة جهة الاتصال ذلك: لا يزال بإمكانك إعادة اشتراكها في Joryio، لكن Delivyr تواصل حظر SMS حتى ترسل START.

التأكيد المزدوج لاشتراك SMS. لدى Delivyr تأكيد مزدوج خاص بها، لذا عندما يكون رقم SMS لمساحة العمل على حساب Delivyr، لا يرسل التأكيد المزدوج لاشتراك SMS في Joryio تأكيدا ثانيا: تُسجل اشتراكات SMS الجديدة كالمعتاد وتحجز Delivyr الرسائل إلى الأرقام غير المؤكدة ("Not confirmed yet") حتى ترد جهة الاتصال بـ YES على Delivyr.

تقارير التسليم وإلغاء الاشتراك والردود

لا ترسل Delivyr تقارير التسليم وإلغاءات الاشتراك والردود إلا إلى webhook تضيفه في بوابة Delivyr، وأنت من يكتب المحتوى الذي ترسله لكل حدث. يمنحك Joryio الأمرين: عنوان webhook واحدًا وحمولة جاهزة لكل حدث. حتى تضيفهما، لا يعود شيء - يعرف Joryio أن الرسالة سُلّمت إلى Delivyr، لكن لا يعرف إن كانت قد وصلت، ولا تُنسخ ردود STOP إلى جهة الاتصال في Joryio.

الإعداد

1. افتح التكاملات > Delivyr، وفي قسم تقارير التسليم انقر إعداد تقارير التسليم. لا يرى العنوان إلا مسؤولو مساحة العمل - الإعدادات: كتابة.
2. في بوابة Delivyr، افتح Settings > Webhooks وأنشئ webhook باستخدام عنوان webhook الذي يعرضه Joryio. يُستخدم العنوان نفسه لكل الأحداث.
3. اشترك بالـ webhook في كل حدث في الجدول أدناه. والصق لكل حدث حمولة Joryio (JSONata) - في البطاقة زر نسخ لكل منها، وهي مدرجة أدناه أيضًا.
4. احفظ. تعرض البطاقة وقت وصول آخر تقرير.

حدث Delivyr	ما يفعله Joryio به
delivery_receipt	يضع على الرسالة تم التسليم، أو فشلت مع السبب (تعذّر التسليم، انتهت الصلاحية، رفضها المشغّل)، في تحليلات الحملات والرحلات.
rejected_message	يضع على الرسالة فشلت مع سبب Delivyr. والرمز 1 (ألغى الاشتراك) يلغي أيضًا اشتراك جهة الاتصال في SMS.
opt_out	يلغي STOP اشتراك جهة الاتصال في SMS لرقم Delivyr الخاص بك. ويعيد YES أو UNSTOP اشتراكها - فقط عندما يكون Joryio نفسه قد تلقّى هذا الرد من جهة الاتصال على رقم Delivyr الخاص بك خلال آخر 24 ساعة، ولرقم Delivyr فقط: يبقى إلغاء الاشتراك في SMS من أرقامك الأخرى قائمًا.
incoming_messages	يحفظ الرد على جهة الاتصال؛ ويمكنه بدء رحلة أو تقدّمها، ويقرؤه {{ reply.text }}. والرد الذي يكون كلمة إلغاء اشتراك (STOP وUNSUBSCRIBE وCANCEL وEND وQUIT وREVOKE وOPT OUT وبقية قائمة إلغاء الاشتراك في Joryio) يلغي أيضًا اشتراك جهة الاتصال في SMS - مرة واحدة، حتى عندما يصل تقرير opt_out من Delivyr عن الـ STOP نفسه. ولا يعيد رد START أو YES اشتراكها: تقرير opt_out من Delivyr وحده يفعل ذلك.
message_log	يؤكد أن Delivyr قبلت الرسالة.
event_log	يحتسب النقرات على الروابط التي تتتبعها Delivyr. ويتجاهل معاينات الروابط التي تجريها الروبوتات.

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

الحمولات

الصق كل واحدة منها، دون تغيير، بوصفها حمولة حدثها.

delivery_receipt

{ "version": 1, "type": "delivery_receipt", "id": id, "request_id": request_id, "message_log_id": message_log_id, "status": status, "status_mapped": status_mapped, "epoch": epoch }

rejected_message

{ "version": 1, "type": "rejected_message", "id": id, "request_id": request_id, "phone_number": phone_number, "rejection_code": rejection_code, "rejection_reason": rejection_reason }

opt_out

{ "version": 1, "type": "opt_out", "dml": dml, "phone_number": phone_number, "system_number": system_number, "incoming_log_id": incoming_log_id, "request_id": request_id }

incoming_messages

{ "version": 1, "type": "incoming_messages", "id": id, "from": from, "to": to, "body": body, "message_log_id": message_log_id, "request_id": request_id }

message_log

{ "version": 1, "type": "message_log", "id": id, "request_id": request_id, "sending_number": sending_number, "segments": segments, "testing": testing }

event_log

{ "delivyr_ignore": event != "click", "version": 1, "type": "event_log", "event": event, "message_log_id": message_log_id, "request_id": request_id }

• الإصدار. تحمل كل حمولة "version": 1. إذا غيّر Joryio الحمولة، ستذكر البطاقة ذلك؛ الصق الجديدة حينها. يُرفض التقرير الذي لا يتعرّف Joryio على حمولته ويُحتسب في البطاقة.
• احتفظ بالعنوان سرًا. يمكن لأي شخص يملكه إرسال تقارير وإلغاءات اشتراك لمساحة العمل هذه. إذا تسرّب، انقر إنشاء عنوان جديد في البطاقة: يتوقف القديم عن العمل فورًا، وتتوقف التقارير حتى تلصق العنوان الجديد في Delivyr.
• لا تُحتسب إلا رسائلك. يطابق Joryio كل تقرير مع الرسالة التي أرسلها من مساحة العمل هذه. والتقرير الذي تتعذّر مطابقته يُحتسب في البطاقة كغير مطابق، ولا يُضاف أبدًا إلى جهة اتصال أو حملة.

القيود الحالية

• لا رسائل SMS بنص حر. يجب أن تكون كل رسالة قالبًا معتمدًا. تُرفض الحملة التي تُنشأ عبر API برسالة نصها حر على حساب Delivyr.
• الولايات المتحدة وكندا فقط. يفشل الإرسال إلى رقم خارج +1 برسالة "Delivyr sends to US and Canada (+1) numbers only" ولا تُعاد محاولته.
• تتطلب تقارير التسليم إضافة webhook. لا تصل الرسائل المُسلّمة أو الفاشلة وإلغاءات الاشتراك والردود إلى Joryio إلا بعد إضافة webhook الخاص بـ Joryio في بوابة Delivyr - راجع تقارير التسليم وإلغاء الاشتراك والردود. تقارير التسليم جديدة: إذا أظهرت البطاقة تقارير تعذّرت مطابقتها مع رسالة بينما تبقى الرسائل المُسلّمة عند الصفر، تواصل معنا.

API العام

القوالب نفسها متاحة أيضًا عبر REST API العام، لمساحات عمل Delivyr فقط. راجع قوالب SMS في Messaging API.