إعداد Meta وWhatsApp Business (Cloud API)

Convord يعالج الطلبات والرسائل الواردة عبر WhatsApp Cloud API. القيم أدناه تُقرأ من .env على الخادم إلى مجموعة إعداد whatsapp.

المتطلبات المسبقة

1. تطبيق Meta Business مع منتج WhatsApp مفعّل، ورقم WhatsApp Business نشط (اختبار أو فعلي).
2. عنوان HTTPS عام مستقر لـ webhooks (استخدم نفقًا مثل ngrok للاختبار المحلي).
3. التوثيق الرسمي: WhatsApp Cloud API — Get Started.

متغيرات الخادم (.env)

المفاتيح المستخدمة لاستدعاءات Graph والتحقق من webhook:

• WHATSAPP_API_TOKEN — رمز مؤقت أو مستخدم نظام من Meta. تذكّر تدوير الرموز المنتهية في الإنتاج.
• WHATSAPP_PHONE_NUMBER_ID — من WhatsApp → API Setup: Phone number ID.
• WHATSAPP_VERIFY_TOKEN — سلسلة سرية تبتكرها؛ حقل webhook «Verify» في Meta يجب أن يستخدم نفس القيمة.
• WHATSAPP_API_URL — اختياري؛ مثل https://graph.facebook.com/v18.0 (ارفع الإصدار عند الترقية).

عنوان Webhook

استخدم هذا العنوان الكامل كـ «Callback URL» في Meta: https://convord.com/webhook/whatsapp

• تحقق GET: hub.verify_token يجب أن يطابق WHATSAPP_VERIFY_TOKEN.
• أحداث POST: الرسائل الواردة تصل إلى هذا النقطة؛ التطبيق يتولى التحقق والمعالجة.

بعد الإعداد

بمجرد نجاح «Verify» في Meta، أرسل رسالة اختبار من رقم مسموح وافحص سجلات التطبيق. أخطاء Graph عادة تتضمن تفاصيل في جسم الاستجابة.

مزيد من المعلومات

اقرأ مع دليل التكامل لربط العملاء والعمليات.

دليل Meta Developer الكامل (المراحل 1–7، المستودع) →