قوالب رسائل واتساب من إيفربريدج: دليل خطوة بخطوة

لإرسال رسائل واتساب مُصممة مسبقًا من قوالب حوادث Everbridge، أنت بحاجة إلى أكثر من مجرد معاينة للرسالة. يستخدم تكامل ChatArchitect متغيرًا خاصًا بالحادثة يُسمى رمز واتساب لتحديد قالب واتساب المُعتمد، ثم يُنشئ معاييره من القيم المُدخلة في نموذج المُشغل. تُحدد أسماء الحقول وأرقام التسلسل وترتيب المعايير كيفية تجميع تلك الرسالة.

يشرح هذا الدليل كيفية إعداد سير العمل هذا، باستخدام تنبيه عملي للحوادث بثلاثة معايير. كما يتناول الأخطاء التي قد تُغير الرسالة النهائية: القيم المفقودة، ومتغيرات الحوادث الإضافية، وحقل المعرّف الموضوع في غير موضعه الصحيح، والخلط بين معرّف قالب Everbridge ومعرّف قالب WhatsApp.

كيفية إرسال Everbridge لنموذج WhatsApp عبر ChatArchitect

يُوفّر قالب واتساب المُعتمد الصياغة الثابتة. وتُوفّر إيفربريدج القيم الخاصة بالحادثة، مثل الموقع ووصف الحدث والوقت. ويقوم ChatArchitect بدمج مُعرّف قالب واتساب مع هذه القيم لإعداد إرسال القالب.

على سبيل المثال، قد يُشير النموذج المُعتمد إلى: "حادث في {{1}}: {{2}}. تم ​​الإبلاغ عنه في {{3}}". يُدخل المُشغّل الموقع والحدث والوقت في متغيرات منفصلة خاصة بالحادث. ومع التكوين الصحيح، تُملأ هذه القيم تلقائيًا في الخانات الثلاث بالترتيب الصحيح.

تركز هذه المقالة على آلية إنشاء الرسائل التي تم إدخالها بين 31 مايو و3 يونيو 2025، وذلك لتكامل قائم بين Everbridge وChatArchitect. وهي بمثابة دليل إرشادي للتكوين، وليست بديلاً عن إعداد التكامل الأولي. للاطلاع على مقدمة أشمل، يُرجى قراءة نظرة عامة على تكامل واجهة برمجة تطبيقات WhatsApp Business مع Everbridge.

ما تحتاجه قبل إعداد نموذج الحادث

قم بإعداد ما يلي قبل تعديل النموذج:

• تكامل موجود بالفعل بين Everbridge و ChatArchitect.
• الوصول إلى المنظمة ذات الصلة في بوابة مدير Everbridge والإذن بتعديل متغيرات الحوادث والقوالب الخاصة بها.
• نموذج رسالة واتساب معتمد متوفر في ChatArchitect.
• معرّف قالب واتساب الدقيق، منسوخًا مع أقواسه المعقوفة.
• قائمة بعناصر القالب النائبة والقيمة التي يجب أن يحصل عليها كل منها.
• تم إعداد ملف تعريف اشتراك الاستجابة لتكاملك.
• المستلمون المُعيّنون للاختبار لأول عملية إرسال مُتحكّم بها.

دوّن ترتيب العناصر النائبة قبل العمل في Everbridge. إذا كان {{1}} يُمثّل الموقع و{{2}} يُمثّل الحدث، فيجب أن يُمرّر النموذج قيمة الموقع قبل قيمة الحدث. تُساعد أسماء المتغيرات الواضحة المُشغّل، لكن الأسماء وحدها لا تُحدّد ربط المعلمات.

الخطوة 1: انسخ معرّف قالب واتساب الصحيح

افتح تطبيق ChatArchitect، واختر قالب واتساب المعتمد المطلوب، وانسخ معرّفه. احتفظ بالقيمة المنسوخة كما هي، بما في ذلك الأقواس المعقوفة. ستلصق هذه القيمة في متغير الحادثة المسمى " رمز واتساب".

لا تستبدل معرّف القالب الموضح في رأس قالب حادثة Everbridge. فهذا المعرّف يُحدد قالب Everbridge. يحتاج رمز WhatsApp إلى معرّف قالب رسالة WhatsApp المُحدد في ChatArchitect.

يجب الفصل بين دوري العنصرين: يحدد المعرّف قالب واتساب المعتمد، بينما توفر متغيرات الحادثة قيم معلمات هذا القالب. تعديل النص في رسالة Everbridge الصادرة لا يُعدّ اختيار قالب واتساب مختلف.

الخطوة الثانية: إنشاء متغيرات الحادث

في بوابة إدارة Everbridge، حدد المؤسسة المناسبة وافتح قسم الاتصالات ← الحوادث ← المتغيرات. انقر على "متغير جديد"، ثم اختر "مربع نص"، وسمِّ متغير المعرّف " رمز واتساب". اختر حدًا لعدد الأحرف مناسبًا للمعرّف المنسوخ، ثم انقر على "موافق".

أنشئ متغيرًا واحدًا أو أعد استخدام متغير واحد لكل مُعامل من مُعاملات قالب واتساب. في المثال الموضح في هذا الدليل، استخدم الموقع، والحدث، والوقت. يجب أن يُقدّم كل منها قيمة نصية عادية. أدخل اسم المبنى على سبيل المثال "المبنى أ"، بدلًا من إضافة أقواس المعاملات يدويًا حوله.

يقرأ التكامل القيمة الأولى لكل متغير من متغيرات الحادث. لا يُنتج متغير الاختيار المتعدد تلقائيًا مُعامل واتساب واحدًا لكل خيار مُحدد. تُسهّل الحقول ذات القيمة الواحدة مراجعة عملية الربط وتتجنب هذا الغموض.

الخطوة 3: إضافة الحقول وترتيبها في نموذج المشغل

افتح قسم الاتصالات ← الحوادث ← القوالب، ثم عدّل قالب الحادثة المناسب. في قسم النموذج والرسالة، أضف رمز واتساب وجميع المتغيرات اللازمة لقالب واتساب المُختار. حدّد الحقول المطلوبة حيث أن ترك قيمة فارغة سيمنع إرسال رسالة صحيحة.

بعد ذلك، افتح "معاينة وتحرير" ← "نموذج المشغل". راجع الأرقام المعروضة بجانب المتغيرات وقم بترتيب الحقول عن طريق سحبها إلى الموضع المطلوب.

يجب أن يحمل رمز واتساب وكل معلمات واتساب رقمًا تسلسليًا 3 أو أعلى. يتم تجاهل الحقول التي تقل عن هذا الحد في سير عمل هذا النموذج. ضع حقل المعرّف في المرتبة الثالثة أو ما بعدها، ثم رتّب حقول المعلمات بالترتيب المطلوب في النموذج المعتمد.

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

يتضمن السلوك المُعدَّل أيضًا وضع حقول المعلمات المؤهلة قبل رمز واتساب. يُسهِّل وضع المعرّف قبل المعلمات عملية فحص النموذج، ولكن نقله لا يُزيل الحقول المؤهلة الأخرى من قائمة المعلمات.

مثال كامل لتنبيه الحوادث بثلاثة معايير

لنفترض أن نموذج رسالة واتساب المعتمد يحتوي على هذه الصياغة:

الحادثة في {{1}}: {{2}}. تم ​​الإبلاغ عنها في {{3}}.

قم بتكوين قسم واتساب في نموذج المشغل بهذا الترتيب:

1. المركز 3 — رمز واتساب: {{your-template-id}}
2. الموقع 4 - الموقع: المبنى أ
3. الموقع 5 — الحدث: انقطاع التيار الكهربائي
4. المركز السادس - الوقت: 14:30

القيمة {{your-template-id}} هي مثال توضيحي، وليست معرّفًا يجب نسخه. استبدلها بالمعرّف الدقيق المنسوخ من القالب المعتمد لديك في ChatArchitect.

يقوم التكامل بإنشاء سلسلة الإرسال التالية:

{{your-template-id}} {{المبنى أ}} {{انقطاع التيار الكهربائي}} {{14:30}}

الرسالة المقصودة التي تم استلامها عبر واتساب هي:

حادثة في المبنى أ: انقطاع التيار الكهربائي. تم الإبلاغ عنها الساعة 14:30.

يُدخل المُشغّل "المبنى أ"، "انقطاع التيار الكهربائي"، و "14:30" كنص عادي. يُضيف النظام أقواس المعلمات أثناء تجميع الرسالة. احتفظ بالأقواس في مُعرّف القالب المنسوخ، ولكن لا تُضفها يدويًا إلى قيم المعلمات العادية.

الخطوة الرابعة: تحقق من إعدادات الرسائل الصادرة والتسليم

في قسم "الرسائل الصادرة" ← "جميع طرق التسليم" ، احتفظ بمحتوى القالب المنسوخ من ChatArchitect، مع اتباع تعليمات إعداد التكامل. ثم راجع إعدادات قالب البلاغ ، وحدد WhatsApp كطريقة تسليم، واختر ملف تعريف اشتراك الاستجابة المناسب . احفظ القالب.

عند إدخال رمز واتساب مؤهل، يستخدم نموذج إرسال واتساب هذا الرمز وقيم النموذج. تغيير نص الرسالة الصادرة وحده لا يُغيّر نموذج واتساب المُختار أو معاييره. لتغييرها، حدّث رمز واتساب أو متغيرات الحادثة ذات الصلة.

احرص على توضيح هذا التمييز في تعليمات المشغل. وإلا، فقد يقوم أحدهم بتعديل معاينة الرسالة الصادرة ويفترض أن مستلم واتساب سيتلقى الصياغة المعدلة، على الرغم من أن القالب المعتمد والمعايير المُقدمة تبقى كما هي.

الخطوة 5: إجراء اختبار مُحكم وفحص تطبيق واتساب

افتح قسم الاتصالات ← الحوادث ← بدء حادثة، ثم اختر القالب المُعدّ، وأكمل نموذج المشغل. تحقق من مُعرّف القالب، وكل مُعامل، والمستلمين قبل المتابعة.

انتقل إلى الخطوة التالية، وراجع تفاصيل الحادث وخيارات الإرسال، ثم استخدم زر "مراجعة وإرسال". يعتمد زر "مراجعة" على إعدادات المراجعة الخاصة بالمؤسسة، لذا قد يختلف مسار المراجعة.

عند إرسال الرسالة لأول مرة بعد تغيير القالب، حدد مستلمين تجريبيين معينين. قارن رسالة واتساب الفعلية بالنتيجة المتوقعة: تحقق من الصياغة الثابتة، وترتيب المعلمات، والإملاء، والاكتمال.

تعرض معاينة Everbridge الرسالة الصادرة المُعدّة في Everbridge، لكنها لا تغني عن التحقق من نموذج رسالة WhatsApp المُستلمة. لذا، يُرجى اعتبار اختبار التكامل الناجح خطوة تحقق منفصلة قبل استخدام النموذج المُعدّل للإشعارات التشغيلية.

أربع قواعد تمنع تعيين المعلمات بشكل غير صحيح

1. ترتيب الحقول يحدد قيم العناصر النائبة

يُرسل التكامل القيم المؤهلة بترتيب حقولها الأصلي. لا يؤدي تغيير اسم متغير إلى نقل قيمته إلى مكان آخر. إذا بدّلت الرسالة المستلمة الموقع والحدث، فتحقق من تسلسل النموذج أولاً.

2. يمكن أن تصبح الحقول الإضافية المعبأة معلمات

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

3. يتم تجاهل القيم الفارغة

لا يحجز الحقل الفارغ موضعًا فارغًا. يمكن للقيم المُدخلة لاحقًا أن تتقدم للأمام. في المثال أعلاه، قد يؤدي ترك حقل "الموقع" فارغًا إلى شغل حقل "انقطاع التيار الكهربائي" للموضع الأول. أدخل جميع القيم المطلوبة للقالب المُختار.

4. يتحكم رمز واتساب في سير عمل القالب

في حال عدم وجود رمز واتساب، أو كان فارغًا، أو كان رقم تسلسله أقل من 3، فسيعود التكامل إلى نص الرسالة الصادرة من إيفربريدج ولن تُضاف متغيرات الحادث الأخرى. هذا يصف عملية تجميع الرسائل؛ ولا يضمن وصول الرسالة البديلة عبر واتساب. في سير العمل هذا، يُرجى دائمًا إدخال المعرّف الصحيح.

استكشاف أخطاء رسائل قوالب واتساب من إيفربريدج وإصلاحها

تظهر معلومات خاطئة في خانة مخصصة. قارن ترتيب المعلمات مع النموذج المعتمد. تحقق من وجود قيم فارغة وحقول إضافية مؤهلة مُعبأة قبل تغيير صياغة النموذج.

يوجد حقل مفقود من الرسالة. تأكد من وجود قيمة له، وظهوره في نموذج المُشغِّل، وأن رقم تسلسله الفعلي لا يقل عن 3. إذا كان متغيرًا متعدد الاختيارات، فتذكر أنه يتم قراءة قيمته الأولى فقط.

يستخدم التكامل النص الصادر بدلاً من سلسلة القالب المقصودة. تحقق من اسم المتغير "رمز واتساب" ومعرفه المنسوخ ورقم تسلسله بدقة. لا تستخدم معرف رأس قالب حادثة إيفربريدج.

تبدو معاينة Everbridge صحيحة، لكن الأمر يختلف مع WhatsApp. تفحّص رمز WhatsApp وقيم النموذج. يحدد المعرّف المُعبأ والمؤهل قالب WhatsApp بغض النظر عن التعديلات التي تُجرى على النص المُرسَل.

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

الأسئلة الشائعة

ما هو رمز واتساب في إيفربريدج؟

هو متغير الحدث الذي يستخدمه تكامل ChatArchitect لحمل معرّف قالب رسالة WhatsApp. يجب أن يكون اسمه مطابقًا تمامًا لـ "رمز WhatsApp"، ويجب أن يكون رقم تسلسله 3 أو أعلى.

هل يجب أن أضع قيم الحوادث بين قوسين معقوفين؟

لا. أدخل قيم المعلمات كنص عادي. يقوم التكامل بإضافة الأقواس. معرّف القالب مختلف: احتفظ بأقواسه كما هي منسوخة من ChatArchitect.

هل يمكن أن تأتي حقول المعلمات قبل رمز واتساب؟

نعم. يشمل السلوك المُعدَّل حقول المعلمات غير الفارغة المؤهلة حتى عندما تسبق المعرّف. يجب أن تظل أرقام تسلسلها 3 أو أعلى، ويجب أن يتطابق ترتيبها مع عناصر القالب النائبة.

هل يؤدي تغيير الرسالة الصادرة إلى اختيار قالب مختلف؟

لا، عند إدخال رمز واتساب مؤهل. غيّر هذا المعرّف لاختيار قالب معتمد آخر، ثم راجع عدد وترتيب معاييره.

ما الذي يجب تحديثه في نموذج حادثة قديم؟

أضف رمز واتساب أو املأه، مع تضمين جميع متغيرات المعلمات المطلوبة، وتحقق من أرقام تسلسلها وترتيبها. يحتفظ التكامل المُعدَّل بخيار النص العادي كخيار احتياطي. أعلنت ChatArchitect بشكل منفصل عن اشتراط وجود مُعرِّف لإرسال القوالب بدءًا من 1 أغسطس 2025؛ لذا احرص دائمًا على نسخ المُعرِّف الصحيح لسير عمل القالب الموضح هنا.

قم بإعداد سير عمل Everbridge WhatsApp الخاص بك باستخدام ChatArchitect

يبدأ تكوين النموذج الموثوق به بمعرّف قالب دقيق وتسلسل معلمات متوقع. اجعل مهمة المستخدم واضحة: اختر القالب المطلوب، واملأ جميع القيم المطلوبة، وراجع المستلمين، وتحقق من الرسالة المستلمة بعد إجراء تغييرات التكوين.

استخدم دليل إعداد قالب ChatArchitect Everbridge كمرجع للتكوين. إذا كنت تخطط للتكامل، فراجع خطط ChatArchitect WhatsApp Business API ، وجهّز رسالة نموذجية للبلاغ تتضمن الحقول التي يحتاجها فريقك.