RinooSol

أتمتة واتساب

كيف تربط واتساب بمنصة n8n عبر Evolution API

دليل خطوة بخطوة لربط رقم واتساب بمنصة n8n عبر نسخة Evolution API خاصة، وما يحتاجه الإعداد، وما تسمح به القواعد، ومتى تناسبك الواجهة الرسمية أكثر.

بقلم فريق RinooSol نُشر في مدة القراءة: ⁨1⁩ دقائق

ليس في واتساب زر «اربط بمنصة n8n». لإرسال الرسائل واستقبالها من سير عمل تحتاج إلى واجهة واتساب برمجية: خدمة تحتفظ بالاتصال برقم وتتيحه عبر HTTP حتى تناديها منصة n8n وتُنادى منها. وواجهة Evolution API هي الواجهة مفتوحة المصدر التي يستخدمها معظم من يستضيفون بأنفسهم؛ والمسار الآخر هو منصة WhatsApp Business الرسمية من Meta. يشرح هذا الدليل مسار Evolution API ويقول بصراحة أين يتوقف عن كونه الخيار الصحيح.

ما هي واجهة Evolution API

واجهة Evolution API خادم مفتوح المصدر يتصل بواتساب بالطريقة التي يتصل بها واتساب ويب: تمسح رمز QR بالهاتف الذي يملك الرقم، ومن بعدها يستطيع الخادم إرسال الرسائل واستقبالها على ذلك الرقم عبر واجهة REST وروابط webhook. يعمل حاويةً في Docker مع قاعدة بيانات Postgres، ويحتاج إلى نطاق بشهادة SSL، وهو ما تستضيفه RinooSol نسخةَ واجهة واتساب خاصة: حاويتك ونطاقك الفرعي وشهادتك ونسخك الاحتياطية، جاهزة للربط مع منصة n8n.

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

ما تحتاجه قبل أن تبدأ

  • رقم مخصص للأتمتة. يمكن أن يكون شريحة في هاتف احتياطي. لا تستخدم الرقم الشخصي للمالك: في أول مرة يسيء فيها سير العمل التصرف ستريد فصله دون أن تخسر واتساب الخاص بك.
  • نسخة Evolution API تعمل ولها عنوان ومفتاح واجهة برمجية. في النسخة المُدارة كلاهما في لوحة التحكم؛ أما الاستضافة الذاتية فتعني خادم VPS وDocker وPostgres ووكيلًا عكسيًا وشهادة أولًا.
  • نسخة n8n تستطيع الوصول إلى الواجهة عبر الإنترنت، وتستطيع الواجهة الوصول إليها بروابط webhook. باقة n8n مُدارة ونسخة Evolution API مُدارة تحققان الشرطين بالفعل.

الخطوة 1: اربط الرقم

في لوحة Evolution API أنشئ نسخة (كلمتهم عن رقم واحد متصل)، وافتح رمز QR الخاص بها، وفي الهاتف اذهب إلى واتساب ← الأجهزة المرتبطة ← ربط جهاز، ثم امسح الرمز. تتغير حالة النسخة إلى متصلة. أبقِ الهاتف مشحونًا ومتصلًا في اليوم الأول؛ وبعد تثبيت الجلسة يمكن أن يكون غير متصل فترات، لكن الهاتف المطفأ أسابيع سيحتاج في النهاية إلى مسح جديد.

الخطوة 2: أرسل رسالة من n8n

في منصة n8n أضف عقدة HTTP Request:

  • الطريقة POST، والعنوان https://<نسختك>/message/sendText/<اسم-النسخة>
  • ترويسة apikey: <مفتاحك>
  • جسم JSON يحوي {"number": "2010XXXXXXX", "text": "مرحبًا من n8n"}

تُكتب الأرقام بالصيغة الدولية دون علامة الزائد. شغّل العقدة مرة يدويًا وتأكد أن الهاتف يستقبلها. توجد أيضًا حزمة عقدة مجتمعية لواجهة Evolution API ضمن عُقد مجتمع n8n؛ تغلّف المسارات نفسها بنموذج بدل جسم JSON، وتستحق التثبيت بعد نجاح أول نداء يدوي.

الخطوة 3: استقبل الرسائل برابط webhook

في منصة n8n أضف مُحفّز Webhook، وانسخ عنوانه الإنتاجي، وفي Evolution API اضبط عنوان webhook للنسخة عليه مع تفعيل حدث messages upsert. أرسل رسالة إلى الرقم من هاتف آخر؛ ينطلق المُحفّز بجسم JSON يحوي المرسل والنص ومعرّف الرسالة. وكل ما بعد ذلك هو n8n عادي: شرط على النص، وبحث في جدول، ورد بعقدة HTTP من الخطوة 2.

تفصيلان يوفّران عليك عصرًا كاملًا:

  • ترسل إليك Evolution API رسائلك الصادرة أيضًا، موسومة fromMe: true. رشّحها أولًا وإلا أطلق كل رد سير العمل من جديد.
  • تحمل رسالة المجموعة معرّف مجموعة بدل رقم. قرر مبكرًا هل يتجاهل سير عملك المجموعات؛ معظمها ينبغي أن يفعل.

الخطوة 4: التسليم إلى شخص

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

القواعد بصراحة

لا تسمح شروط واتساب بالإرسال الجماعي غير المطلوب، والرقم الذي يرسل كثيرًا من رسائل التواصل الأول إلى أشخاص لم يراسلوه يُقيَّد، وأحيانًا نهائيًا. لن توقفك Evolution API؛ التقييد هو ما يوقفك. ابنِ سير العمل حول من راسلوك أولًا، أو من أعطوك أرقامهم لهذه الرسالة بالذات (تأكيد حجز، أو تحديث طلب، أو تذكير بموعد حدّدوه). أبقِ الحجم على مقاس البشر، ولا ترفع قائمة مشتراة أبدًا.

متى تكون الواجهة الرسمية المسار الأفضل

منصة WhatsApp Business من Meta هي الواجهة المعتمدة: اسم شركة موثّق، وقوالب رسائل معتمدة لكل ما يُرسل خارج نافذة محادثة مدتها أربع وعشرون ساعة، وتسعير لكل محادثة، ولا خطر تقييد من القناة نفسها. يستغرق إعدادها وقتًا أطول (حساب Meta تجاري، وتوثيق، واعتماد قوالب) وتدعمها منصة n8n بعقدة مدمجة. اخترها حين سترسل إشعارات على نطاق واسع إلى عملاء لم يراسلوك أولًا، أو حين تهم عملاءك الشارة الخضراء الموثّقة، أو حين يكون الرقم مما لا تستطيع الشركة خسارته. وللسير المعتمد على الردود بحجم متواضع، Evolution API أسرع وأرخص؛ وللإشعارات الموجهة للعملاء على نطاق واسع، المنصة الرسمية هي النظام الأكثر أمانًا. تبني RinooSol على أي منهما وتختار المسار معك في الاستشارة.

كيف يبدو الإعداد المكتمل

رقم عيادة مرتبط بنسخة Evolution API خاصة؛ وسير عمل n8n يجيب عن الأسئلة الخمسة الشائعة، ويؤكد الحجوزات من التقويم، ويذكّر المرضى مساء اليوم السابق، ويسلّم ما عدا ذلك إلى الاستقبال. تصف صفحة أتمتة واتساب ذلك البناء خطوة بخطوة، وصفحة تذكيرات المواعيد جزء التذكير وحده.

مقالات ذات صلة

أخبرنا بما تفعله يدويًا اليوم

احجز استشارة مجانية ونصمم معك الأتمتة المناسبة.

نرد بالعربية أو الإنجليزية

آخر تحديث: