مشغّل WhatsApp لا يستقبل الرسائل – مشكلة في webhook

صف المشكلة / الخطأ / السؤال

ما هي رسالة الخطأ (إن وجدت)؟

يرجى مشاركة سير العمل الخاص بك

(حدد العُقد على لوحتك واستخدم اختصارات لوحة المفاتيح CMD+C/CTRL+C و CMD+V/CTRL+V لنسخ ولصق سير العمل.)

شارك الإخراج الذي تم إرجاعه بواسطة العُقدة الأخيرة

مرحبا بمجتمع n8n،
أواجه مشكلة في تكامل WhatsApp Business Cloud API الخاص بي.

  • سير العمل: Assistente pessoal WhatsApp
  • Meta App ID: 1504964524809075
  • WhatsApp Business Account ID: 1775385397062827
    تم تكوين WhatsApp Trigger لـ “Messages”، وسير العمل منشور، لكن الرسائل الواردة على WhatsApp لا تؤدي إلى تنفيذ أي عمليات.
    لقد أكدت أن تطبيق Meta منشور، وأن رقم WhatsApp متصل، والتطبيق مشترك في حساب WhatsApp Business الصحيح، واختبار اتصال بيانات اعتماد OAuth في n8n نجح.
    ألغاء النشر وإعادة نشر سير العمل لم تحل المشكلة. شاشة تكوين الإنتاج في Meta تعرض حقول عنوان URL رد النداء وتوكن التحقق فارغة.
    عند تنفيذ المشغل يدويًا، يُبلغ n8n أن معرّف تطبيق WhatsApp لديه بالفعل اشتراك webhook.
    كيف يمكنني تشخيص واستعادة تسجيل webhook الإنتاج دون الإضرار باشتراك حساب WhatsApp Business الحالي؟
    شكراً لك!

معلومات عن إعداد n8n الخاص بك

  • إصدار n8n:
  • قاعدة البيانات (الافتراضي: SQLite):
  • إعداد n8n EXECUTIONS_PROCESS (الافتراضي: own, main):
  • تشغيل n8n عبر (Docker, npm, n8n cloud, تطبيق سطح المكتب):
  • نظام التشغيل:

مرحباً @andrecury، بينما تنتظر الرد، إليك بعض الأشياء التي قد تساعدك:

الموارد المقترحة

تم مطابقتها تلقائياً مع سؤالك.

المستندات:

المنتدى:

@Tanzeela_Tauseef، @edumats، @Anshul_Namdev - لقد ساعدتم مع مشاكل مشابهة من قبل، هل يمكنكم إلقاء نظرة؟

اقترح تلقائياً بواسطة روبوت مجتمع n8n. إنه تجريبي - يرجى مشاركة ملاحظاتك هنا.

مرحباً @andrecury أهلاً وسهلاً في مجتمع N8n.
تحذير الاختبار اليدوي يعني أن n8n وجد اشتراك webhook نشط على مستوى التطبيق يشير إلى callback مختلف من محفز الاختبار. عنوان URL الإنتاج الخاص بك يمكن أن يسبب هذا التضارب أيضاً. أوقف الاختبارات اليدوية على هذا التطبيق في الوقت الحالي، لأن تنظيف n8n للاختبارات الفاشلة قد يحذف اشتراك التطبيق على مستوى التطبيق هذا.

قبل حذف أي شيء، استخدم App Access Token لقراءة GET /<APP_ID>/subscriptions وتفتيش callback_url و active و fields. هل يطابق callback عنوان URL الإنتاج لهذا المسار، عنوان URL اختبار أو مسار عمل آخر؟ يرجى مشاركة active و fields وأي عنوان URL يطابق وإصدار n8n الخاص بك وما إذا كنت على Cloud أو self-hosted. احتفظ برمز الوصول بسرية. بما أن إعادة النشر فشلت بالفعل، فإن هذه القراءة مطلوبة قبل اختيار خطوة الاستعادة.

تحدث هذه المشكلة عادةً عندما تفقد لوحة تحكم Meta المزامنة مع عنوان URL للـ webhook، أو عندما يمنع قفل الاشتراك السابق n8n من الكتابة فوق نقطة نهاية رد الاستدعاء. يمكنك حل التعارض باستخدام Meta Graph API Explorer لمسح الاشتراك الموجود وإعادة تأسيس ربط webhook مباشرة من إعداد بيانات اعتماد n8n. أخبرني إذا كنت تحتاج إلى مسار نقطة نهاية Graph API الدقيق لمسح قفل الاشتراك هذا وسأتمكن من تحديد الاستدعاء هنا مباشرة.

إضافة جانب WABA إلى فحص الاشتراكات أعلاه، حيث تغطي مستندات WhatsApp Trigger في n8n هذا في المشاكل الشائعة. رسالة “already has a webhook subscription” تتعلق بعنوان URL للويب هوك الخاص بالتطبيق، وليس بـ WABA الخاص بك، لذا لا ترسل DELETE إلى /<WABA_ID>/subscribed_apps لمسحها. هذا يلغي الاشتراك في التطبيق ويتوقف Meta عن إرسال أي شيء. قم بتشغيل GET على /<WABA_ID>/subscribed_apps بدلاً من ذلك. إذا كان إدخال تطبيقك يحتوي على override_callback_uri، فإن Meta يرسل ويب هوك الرسائل لـ WABA هذا هناك بدلاً من عنوان URL الخاص بك في n8n، وسيفوز override المعين على رقم الهاتف على كليهما. تقول نفس الصفحة أن Meta تحافظ على ويب هوك واحد لكل تطبيق، لذا لا يمكن لتشغيل اختبار يدوي والسير العمل المنشور أن يستقبلا معاً.

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

  1. GET /<APP_ID>/subscriptions مع رمز وصول التطبيق: احفظ callback_url و active و fields.
  2. GET /<WABA_ID>/subscribed_apps: تحقق مما إذا كان هذا التطبيق مدرجًا وما إذا كان override_callback_uri موجودًا.
  3. تحقق من وجود تجاوز callback على مستوى رقم الهاتف في Meta، إن وجد.

قارن كل عنوان URL للاتصال مع عنوان URL الإنتاج لهذا سير العمل، وليس عنوان URL /webhook-test/. يمكن لعملية تشغيل يدوية نقل callback على مستوى التطبيق إلى عنوان URL الاختبار، وقد يكون لتجاوز WABA أو رقم الهاتف الأولوية حتى عندما يبدو اشتراك التطبيق صحيحًا.

بعد إجراء تغيير واحد، توقف الاختبارات اليدوية وأعد النشر مرة واحدة، ثم أرسل من رقم غير اختبار. اطلب كلا الإثباتين: إدخال في سجل تسليم webhook الخاص بـ Meta مع HTTP 200، وتنفيذ جديد لـ n8n يحتوي على حمولة الرسالة. إذا لم يكن لدى Meta محاولة تسليم، فهذه مشكلة اشتراك/توجيه. إذا كانت Meta تتلقى 200 لكن n8n ليس لديه تنفيذ، فتحقق من ingress و activation في n8n. إذا كان هناك تنفيذ ولكن فشلت العقد اللاحقة، فالمشغل يعمل بالفعل.

يرجى حفظ هذه القيم قبل حذف أي اشتراك.

فحوصات الاشتراك والتجاوز أعلاه تغطي الأسباب المحتملة. قبل تغيير التسجيل مرة أخرى، هل يمكنك مشاركة مصفوفة صغيرة معقمة: تطابقات رد الاتصال للإنتاج (نعم/لا)، حقل الرسائل مشترك فيه (نعم/لا)، وجود تجاوز WABA (نعم/لا)، وجود تجاوز على مستوى الهاتف (نعم/لا)، وحالة HTTP/الطابع الزمني لآخر تسليم واردة حقيقي؟ يرجى أيضاً إدراج إصدار n8n الخاص بك وما إذا كنت تستخدم Cloud أم self-hosted. يرجى حذف الرموز ومحتوى الرسائل الخاصة. اختبار بيانات اعتماد OAuth الناجح يثبت الوصول، وليس أن الأحداث الواردة تصل إلى رد الاتصال للإنتاج. يجب أن تجعل هذه المصفوفة من الأسهل اختيار إصلاح مستهدف واحد بدلاً من حذف أو إعادة إنشاء الاشتراكات بشكل تخميني.

@andrecury أنا واجهت هذه المشكلة الدقيقة بالضبط أثناء مشروع تدريب داخلي. تم نشر تطبيق Meta واختبار بيانات اعتماد n8n كان ناجحاً، إلا أنه لم تظهر أي عملية تنفيذ في n8n عند إرسال رسالة عبر WhatsApp.

في حالتي، كان السبب هو مفتاح تبديل في لوحة تحكم تطبيق Meta. انتقل إلى App Dashboard → WhatsApp → Basic setup، وابحث عن قسم “تسجيل رقم هاتف WhatsApp” تحت “الخطوة 2. إعداد الإنتاج.” كان مفتاح التبديل “Subscribe webhooks” على بطاقة حسابي WhatsApp Business مطفأ. بمجرد تشغيله، بدأت الرسائل تصل إلى n8n.

ذكرت أن التطبيق مشترك بشكل صحيح في WABA، لذلك قد لا يكون هذا سبب مشكلتك. ومع ذلك، يستحق الأمر التحقق من هذا قبل المتابعة مع فحوصات API المذكورة أعلاه، لأنه يمكن التحقق منه بسهولة مباشرة من لوحة التحكم.

شيء آخر تعلمته هو أن تطبيق Meta واحد فقط يمكن أن يحتوي على عنوان URL webhook واحد فقط. لهذا السبب استخدمت تطبيقات Meta منفصلة وحسابات WhatsApp Business منفصلة لمشروعيّ؛ وإلا فقد تنتهي الرسائل من مشروع واحد بإرسالها إلى webhook للمشروع الآخر.

آمل أن يكون هذا مفيداً. يرجى إخبارني بما تجده.

مرحباً @andrecury — اختبار OAuth الناجح يثبت فقط المصادقة الخارجة. يمكن أن ينجح حتى عندما لا تنشر Meta رسائل واردة إلى عنوان URL الإنتاج لسير العمل هذا.

رسالة “لديها بالفعل اشتراك webhook” التي رأيتها في تشغيل يدوي متوقعة: وجدت n8n اشتراكاً موجوداً على مستوى التطبيق لا ينتمي رد الاتصال فيه إلى عنوان URL الاختبار، لذا تتوقف بدلاً من الكتابة فوقه. باستخدام رمز الوصول على مستوى التطبيق، استخدم GET /{APP_ID}/subscriptions وقارن callback_url بعنوان URL الإنتاج لهذا المشغّل (يجب أن يحتوي على /webhook/ وليس /webhook-test/).

بشكل منفصل، استخدم GET /{WABA_ID}/subscribed_apps برمز يملك whatsapp_business_management. تأكد من أن تطبيقك مدرج، وتحقق من override_callback_uri — ستُرسل Meta رسائل webhook هناك بدلاً من رد الاتصال للتطبيق. يأخذ تجاوز رقم الهاتف الأولوية على كليهما. لا تحذف اشتراك WABA لمسح التضارب؛ هذا سيُلغي اشتراك التطبيق وتتوقف Meta عن إرسال الأحداث.

من المفيد التحقق أولاً من منطقة التبديل “Subscribe webhooks” الخاصة بـ Jamilur، لأن إلغاء النشر وإعادة النشر لم تغيير الأشياء بالفعل.

المستندات: WhatsApp Trigger | Nodes | n8n Docs

لا يمكن لـ Error Trigger التقاط هذا، لأنه لا يتم إنشاء أي تنفيذ. أعمل على LeadPulse؛ لدينا فحص صحة n8n مجاني لسير العمل الذي يتوقف عن إنتاج عمليات التنفيذ (مفتاح API للقراءة فقط؛ المفتاح لا يتم تخزينه): Free n8n Health Check · LeadPulse