> ## Documentation Index > Fetch the complete documentation index at: https://help.kwentra.com/llms.txt > Use this file to discover all available pages before exploring further. # إرسال رسائل WhatsApp عبر Mersal > أعدّ Mersal ليُرسل kwentra بطاقات التسجيل والتأكيدات والفواتير وروابط الدفع من رقم WhatsApp الخاص بفندقك. يُرسل kwentra الرسالة من رقم WhatsApp الموثّق لفندقك، بدلاً من فتح WhatsApp Web. ### **القيمة العملية** * يحمي رقمك من الحجب بسبب الرسائل المزعجة. * يُرسل الرسالة من kwentra دون فتح تبويب جديد. * يمنح النزيل رسالة كاملة باسمه، لا رابطاً مجرّداً. * يسجّل كل إرسال في سجل الحجز. * يضيف مفتاح دولة النزيل إلى الأرقام المحلية. ### **حالات الاستخدام** * يرسل موظف الاستقبال بطاقة التسجيل فيستلمها النزيل من رقم الفندق. * يرسل أمين الصندوق الفاتورة ويرى فوراً إن كانت قد خرجت. * يفتح مدير المكتب الأمامي الحجز ويعرف من أرسل وماذا أرسل. ### **كيف يعمل** | **Where:** Settings → Integrations → WhatsApp (Mersal) | | - | قبل ذلك كان زر **Share via WhatsApp** يفتح WhatsApp Web والرابط ملصوق فيه. ثم يضغط الموظف زر الإرسال من الهاتف المسجَّل على ذلك الجهاز. وسبّب ذلك ثلاث مشكلات: * يحجب WhatsApp الأرقام التي ترسل روابط كثيرة بهذه الطريقة. يعدّها رسائل مزعجة. * كان النزيل يستلم رابطاً مجرّداً بلا شرح. * لم يكن لدى الفندق سجل بما أُرسل، ولمن، ومن أرسله. الآن يُرسل kwentra الرسالة بنفسه. وتستخدمه أربع شاشات: * Registration Card * Booking Confirmation (الفردي والجماعي) * Folio * Payment Link #### **ما هو Mersal** **Mersal مزوّد رسمي لخدمة WhatsApp Business.** لا تسمح Meta لنظام الفندق بإرسال رسائل WhatsApp مباشرة. تمرّ الرسائل عبر مزوّد معتمد. * للفندق حساب لدى Mersal. ويحمل Mersal رقم WhatsApp الموثّق للفندق. * يسلّم kwentra الرسالة إلى Mersal، ويرسلها Mersal. * **يتعاقد الفندق مع Mersal مباشرة** ويدفع له ثمن الرسائل. لا يحاسب kwentra على الرسائل ولا يعيد بيعها. * **يجب أن تستخدم الرسائل قوالب معتمدة.** لا يسمح WhatsApp للنشاط التجاري ببدء محادثة إلا بقالب اعتمدته Meta. الكتابة الحرة غير ممكنة. هذه قاعدة من Meta، لا قيد من kwentra. ### **الجزء الأول: إعداد Mersal** نفّذ هذه الخطوات في Mersal قبل أي إعداد في kwentra. #### **1. احصل على حساب Mersal** تواصل مع Mersal على [chat.mersal.ai](https://chat.mersal.ai). اطلب إعداد الحساب بالرقم الذي سيراه النزلاء. * استخدم رقماً يملكه الفندق ولا مانع من نشره. * سيردّ النزلاء على هذا الرقم. #### **2. أنشئ قوالب الرسائل** تكتب القوالب **في لوحة Mersal**، لا في kwentra. تراجع Meta كل قالب، عادةً خلال وقت قصير. لا يُستخدم إلا القالب المعتمد. قائمة قوالب الرسائل في لوحة Mersal * يُكتب كل قالب لكل لغة على حدة. * القالب نفسه بالإنجليزية والعربية مدخلان، بالاسم نفسه ولغتين مختلفتين. يستطيع kwentra استخدام الاثنين. * في القالب نص ثابت وفراغات مرقّمة: `{{1}}` و`{{2}}` و`{{3}}`. * يملأ kwentra الفراغات عند الإرسال، مثل اسم النزيل واسم الفندق ورابط المستند. إنشاء قالب جديد في لوحة Mersal **قواعد تُبقي القالب صالحاً في kwentra:** | القاعدة | السبب | | - | - | | ضع رابط المستند في **نص الرسالة**، في فراغ واحد بالضبط | عنوان زر الرابط يُثبَّت عند اعتماد القالب. لا يمكن وضع رابط kwentra الكامل فيه. | | **لا ترويسة صورة أو فيديو أو مستند** | يُرسل kwentra نصاً فقط. تظهر هذه القوالب كغير مدعومة. | | **لا قوالب carousel** | للسبب نفسه. | | الترويسة النصية مقبولة، حتى بفراغاتها الخاصة | فراغات الترويسة مرقّمة وحدها. وتبدأ أيضاً من `{{1}}`. | | أزرار الردّ السريع مقبولة | ليس فيها ما يملؤه kwentra. | | استخدم فئة **Utility** للمستندات | قوالب Marketing أغلى، ويكتمها النزلاء بسهولة أكبر. | **قاعدتان من Meta تسبّبان معظم حالات الرفض:** * لا يمكن أن **تبدأ أو تنتهي** الرسالة بفراغ. * لا يمكن أن تكون الرسالة فراغات في معظمها. إذا ردّت Meta بأن الرسالة "has too many variables for its length"، أضف نصاً ثابتاً أكثر حولها. #### **3. أمثلة على القوالب** قالب لكل مستند يعمل جيداً. حافظ على ترتيب الفراغات هذا. هو الترتيب الذي ستربطه في kwentra. **بطاقة التسجيل:** `{{1}}` اسم النزيل، `{{2}}` اسم الفندق، `{{3}}` الرابط. ```text theme={null} Hello {{1}}, please review and sign your registration card for {{2}}: {{3}} ``` **تأكيد الحجز:** ```text theme={null} Dear {{1}}, your booking at {{2}} is confirmed. Reservation {{3}}, arriving {{4}}. Full details: {{5}} ``` **الفاتورة:** ```text theme={null} Dear {{1}}, your folio from {{2}} for reservation {{3}} is ready: {{4}} ``` **رابط الدفع:** ```text theme={null} Dear {{1}}, you can pay {{2}} for your stay at {{3}} here: {{4}} ``` | **ملاحظة:** يمكن لقالب عام واحد أن يخدم عدة مستندات. لكنه يرسل مستنداً واحداً فقط: المستند المربوط به في kwentra. | | - | #### **4. أنشئ مفتاح API** في لوحة Mersal، اذهب إلى **Settings › API** وأنشئ مفتاحاً. يبدأ بـ `mrsl_api_`. الإعدادات في لوحة Mersal | **ملاحظة:** تعامل مع المفتاح ككلمة مرور. من يملكه يستطيع إرسال رسائل WhatsApp من رقم الفندق. أرسله بشكل خاص لمن يُعدّ kwentra، لا في محادثة مشتركة ولا في تذكرة. | | - | ### **الجزء الثاني: إعداد kwentra** | **Where:** Settings → Integrations → WhatsApp (Mersal) | | - | #### **الخطوة 1: اربط الحساب** شاشة WhatsApp (Mersal) قبل حفظ المفتاح | **الحقل** | ما هو | | - | - | | **Mersal API key** | مفتاحك من Mersal. يُخفى بعد الحفظ ولا يظهر مرة أخرى. | | **Check and save** | يتحقّق من المفتاح مع Mersal ثم يحفظه. | | **Replace key** | يغيّر المفتاح. يبقى المفتاح المحفوظ يعمل حتى يُتحقَّق من الجديد. | | **Remove** | يحذف المفتاح. تؤكّد أولاً. | | **Send through Mersal** | يشغّل الإرسال عبر Mersal. | 1. الصق المفتاح في **Mersal API key**. 2. اضغط **Check and save**. 3. يظهر لك اسم حساب Mersal وبريده وحالته، ووقت آخر تحقّق. حساب Mersal متصل مع Replace key وRemove وSend through Mersal المفتاح الخاطئ يُظهر رسالة Mersal نفسها، **Invalid or revoked API key**. ولا يُحفظ شيء. #### **الخطوة 2: تأكد من تحميل القوالب** بعد حفظ المفتاح، تُحمَّل قوالبك **المعتمدة** تلقائياً. * لكل قالب ولغة صفّ واحد. * تعرض القائمة عدد القوالب المحمّلة ووقت تحميلها. * يعرض كل صف الاسم واللغة والفئة والرابط الذي يرسله، وهل هو جاهز. * افرز بـ **All** أو **Set up** أو **Not set up**، أو ابحث بالاسم. * تحفظ القائمة ترتيب Mersal. ويأتي آخر قالب مُحدَّث أولاً. قائمة القوالب مع الفلاتر وReload from Mersal اضغط **Reload from Mersal** بعد إضافة قالب أو تغييره في Mersal. * الحسابات الكبيرة قد تأخذ حتى دقيقة. * تبقى القائمة الحالية مستخدمة حتى ينتهي التحميل. #### **الخطوة 3: أعدّ كل قالب** افتح صف القالب وحدّد أمرين: 1. **Link this template sends.** اختر Registration Card أو Booking Confirmation أو Folio أو Payment Link. 2. **Fill the blanks.** لكل فراغ، اختر ما يضعه kwentra فيه. قالب Folio بفراغات معبّأة والمعاينة قائمة القيم التي يمكن اختيارها للفراغ قالب Booking Confirmation بأربعة فراغات معبّأة القيم المتاحة تعتمد على الرابط: | **الرابط** | القيم المتاحة | | - | - | | **Registration Card** | Guest name وHotel name وReservation number وRoom number | | **Booking Confirmation** | Guest name وHotel name وReservation number وArrival date وDeparture date | | **Folio** | Guest name وHotel name وReservation number وFolio number وBalance due | | **Payment Link** | Guest name وHotel name وReservation number وAmount due | ورابط المستند نفسه موجود في كل قائمة. **أين يمكن وضع رابط المستند:** * في فراغ **الرسالة** فقط. * في فراغ واحد بالضبط. * لا يوضع أبداً في فراغ الترويسة أو فراغ الزر. يعرض **Preview** القالب كما يعيده Mersal: الترويسة والرسالة والتذييل والأزرار. ويُعلَّم كل فراغ بالقيمة التي اخترتها. ترى الرسالة التي سيقرؤها النزيل. **معنى كل قيمة:** | **القيمة** | ماذا تضع | | - | - | | **Guest name** | الاسم المكتوب على المستند. وفي تأكيدات المجموعات وفواتير الـ paymaster وفواتير AR يكون اسم المجموعة أو الـ paymaster أو الشركة. | | **Hotel name** | اسم المنشأة من Property Information. | | **Balance due** | رصيد الفاتورة لحظة الإرسال، بعملة الفاتورة. بنفس تنسيق الفاتورة. | | **Amount due** | مبلغ رابط الدفع وعملته. | | **Arrival date** و **Departure date** | بتنسيق تاريخ الفندق. | يصبح القالب جاهزاً بمجرّد اختيار رابطه وتعبئة كل فراغاته. لا توجد خطوة تشغيل منفصلة. وحتى ذلك الحين يقول الصف ما الناقص، مثل: * *choose a link* * *1 blank is empty* * *the link is in 2 blanks. Keep it in exactly one* | **ملاحظة:** القالب الذي ترويسته صورة أو فيديو أو مستند يعرض **Image/video/document header · not supported**. ولا يمكن إعداده. | | - | #### **الخطوة 4: شغّل الإرسال** شغّل **Send through Mersal**. ما دام مغلقاً، تعمل كل أزرار WhatsApp كما كانت وتفتح WhatsApp Web. ### **الجزء الثالث: إرسال مستند** 1. افتح المستند كالمعتاد. مثل **Print / Email → RC** في الحجز، أو التأكيد، أو الفاتورة، أو نافذة رابط الدفع. 2. اضغط **Share via WhatsApp**. 3. تعرض النافذة جوّال النزيل مخفياً جزئياً، مثل `+20******44`. 4. إذا كان أكثر من قالب مُعدّ يرسل هذا المستند، تعرض النافذة خيار **Message template**. كل خيار يعرض الاسم واللغة، مثل `booking_confirmation · Arabic`. ويُختار لك الأول. 5. اضغط **Save & Send**. تخرج الرسالة من رقم WhatsApp الخاص بالفندق. ولا يُفتح تبويب جديد. * إذا كان قالب واحد فقط مُعدّاً، لا يظهر أي خيار. ويُستخدم ذلك القالب. * نفس اسم القالب بلغة أخرى خيار منفصل. اختر لغة النزيل. * إذا غيّرت الرقم، يُحفظ في ملف النزيل. | **النتيجة** | ما تراه | | - | - | | أُرسلت | `WhatsApp message sent to {guest number}.` | | لم تُرسل | `WhatsApp message not sent: {Mersal's reason}` | عند الفشل تبقى النافذة مفتوحة وتعرض السبب. ويمكنك تصحيح الرقم أو اختيار قالب آخر. #### **أرقام الهاتف** يُرسل kwentra الرقم دائماً بالصيغة الدولية. * الرقم الذي يبدأ بـ `+` أو `00` فيه مفتاح الدولة أصلاً. يُرسل كما كُتب تماماً. * الرقم الذي يبدأ بـ `0` رقم محلي. يأخذ مفتاح دولة النزيل. * تُؤخذ دولة النزيل من ملف النزيل. وإن لم تكن فيه، تُؤخذ من الحجز. * لا تُستخدم دولة فندقك (Property Information) إلا إذا لم تُحدَّد أيٌّ منهما. * أي رقم آخر يُعامَل كرقم دولي. ويُرسل كما كُتب. * تقبل النافذة الأرقام فقط، مع `+` اختيارية في البداية. لا تُقبل المسافات والشرطات. | **ما تكتبه** | **يُرسل إلى** | | - | - | | `+201003214578` | `+201003214578` (كما كُتب) | | `00201003214578` | `00201003214578` (كما كُتب) | | `01003214578` (نزيل من مصر) | `201003214578` | | `201003214578` | `201003214578` | | **ملاحظة:** اكتب مفتاح الدولة دائماً. تُؤخذ الدولة من النزيل لا من الفندق. إذا لم تطابق جنسية النزيل رقمه، يذهب الرقم المحلي إلى دولة خاطئة. | | - | #### **سجل الإرسال** يُسجَّل كل إرسال في **History** الحجز. وتُسجَّل المحاولات الفاشلة أيضاً. يعرض كل سجل: * من أرسل، ومتى. * المستند، والقالب ولغته. * الرقم. * معرّف رسالة Mersal، أو الخطأ. ### **متى يُستخدم WhatsApp Web بدلاً من ذلك** يعمل الزر كما كان تماماً، ويفتح WhatsApp Web بالرابط، عندما: * لا يوجد مفتاح Mersal محفوظ. * يكون **Send through Mersal** مغلقاً. * لا يكون للمستند قالب مُعدّ. ### **حلّ المشكلات** | **ما تراه** | **معناه** | | - | - | | **Invalid or revoked API key** | المفتاح خاطئ، أو ألغاه Mersal. أنشئ مفتاحاً جديداً من Mersal › Settings › API. | | قالب غير موجود في القائمة | لم يُعتمد في Mersal بعد، أو أُضيف بعد آخر تحميل. اضغط **Reload from Mersal**. | | **Image/video/document header · not supported** | في القالب ترويسة وسائط. أنشئ قالباً بترويسة نصية أو بلا ترويسة. | | **Not set up · choose a link** | القالب غير مربوط بمستند بعد. | | **Put the … link in one message blank** | لا يحمل أي فراغ رابط المستند. | | رُفضت الرسالة | تعرض النافذة سبب Mersal. الأسباب الشائعة: القالب لم يعد معتمداً، أو حجب النزيل الرقم، أو الرقم غير مسجّل على WhatsApp. | ### **معلومات مفيدة** * **من يستطيع الإرسال:** كل من يستطيع فتح المستند حالياً. إعداد التكامل يحتاج صلاحية إعدادات. * **اللغات:** إذا وُجد القالب بالعربية والإنجليزية، يظهر الاثنان في النافذة. يختار الموظف ما يناسب النزيل. * **غير متاح حالياً:** الرسائل المكتوبة بحرية، وإيصالات التسليم والقراءة، والإرسال من ملف النزيل. يسمح WhatsApp بالكتابة الحرة فقط خلال 24 ساعة من رسالة النزيل. * **الكمية:** يسمح Mersal بـ 60 رسالة في الدقيقة و20,000 رسالة في اليوم لكل مفتاح. هذا أكثر بكثير من الاستخدام المعتاد للمكتب الأمامي. ### **مقالات ذات صلة** تحتفظ شاشات المستندات الثلاث بمقالاتها: * [مشاركة بطاقة التسجيل عبر WhatsApp](/ar/front-office/reservations/individual-reservations/share-registration-card-via-whatsapp) * [مشاركة التأكيد عبر WhatsApp](/ar/front-office/reservations/individual-reservations/share-confirmation-via-whatsapp) * [مشاركة الفوليو عبر WhatsApp](/ar/front-office/reservations/individual-reservations/share-folio-via-whatsapp) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.