الوثائق

Meta (Messenger، الصفحات، Meta Ads)

Messenger الوارد والصادر، والنشر على صفحة Facebook، وتقارير حملات Meta Ads وإدارتها من pipeline.

Meta (Messenger، الصفحات، Meta Ads)

إلى جانب Meta Lead Ads و WhatsApp، يغطّي تكامل Meta كلاً من Messenger، والنشر على صفحاتك، وحملاتك الإعلانية.

Messenger

  • مستقبِل messenger_inbound — يُطلِق pipeline عند كل رسالة (أو نقرة زرّ) تصل إلى صفحتك. تُجلَب المرفقات، ولا تُعالَج الرسالة التي تعيد Meta إرسالها إلا مرّة واحدة.
  • node بـ messenger_outbound — يردّ عبر واجهة الإرسال في Messenger.

نافذة الـ 24 ساعة (قاعدة Meta): لا يكون الردّ الحرّ ممكناً إلا خلال 24 ساعة التالية لآخر رسالة من المستخدم. وبعد ذلك، ترفض Meta الإرسال، ويُرفَع الخطأ في مُخرَج الـ node.

النشر على صفحة

node بـ facebook_publish — ينشر منشوراً على صفحتك أو يجدوله: نصّ، أو رابط، أو صورة. وتستخدم الجدولة آلية Meta نفسها (من 10 دقائق إلى 30 يوماً مسبقاً). أمّا الفيديو و Reels و Instagram فغير متاحة بعد.

Meta Ads

  • node بـ facebook_ads_report — تقرير حتمي للأداء (الإنفاق، ومرّات الظهور، والنقرات، و CTR، و CPC…) على مستوى الحساب، أو الحملة، أو المجموعة الإعلانية، أو الإعلان.
  • أدوات الـ agent: facebook.ads_report (القراءة)؛ و facebook.ads_update_budget (الميزانية اليومية لحملة) و facebook.ads_update_campaign_status (التفعيل / الإيقاف المؤقّت) للكتابة.

الربط

  • الصفحات و Messenger — «تسجيل الدخول عبر Facebook» من خلال تطبيق Meta الخاص بالمنصّة، أو تطبيق Meta الخاص بك.
  • Meta Ads — «تسجيل الدخول عبر Facebook»، أو رمز طويل الأمد من حسابك الإعلاني. وفي الحالتين، يكون الرمز رمز مؤسستك: لا احتساب استهلاك (metering) ولا هامش من betool.

تُربَط الصفحات والحسابات الإعلانية بشكل مستقلّ.