من التعليقات إلى DMAPI

حوّل تعليقات «أرسل لي الرابط» إلى رسائل خاصة

أنشئ أتمتة واحدة ويراقب FoPost التعليقات على حساباتك في Instagram وFacebook. عندما يطابق تعليق ما شروطك، يصل إلى صاحبه ردّ خاص في الرسائل المباشرة، ويُحتجز أولاً لموافقتك ما لم تحدد غير ذلك.

احصل على مفتاح APIاقرأ الوثائق
POST /v1/automations
curl -X POST https://api.fopost.com/v1/automations \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workspaceId": "9b2f6c1e-...",
    "name": "Price comments to DM",
    "triggerType": "inbox_message",
    "triggerConfig": { "keywords": ["price", "link"], "types": ["comment"], "maxRunsPerDay": 20 },
    "graph": {
      "nodes": [
        { "id": "t1", "kind": "trigger" },
        { "id": "m1", "kind": "send_message", "config": {
          "channel": "private",
          "text": "Hi {{contact.name}}, here is the link you asked for.",
          "buttons": [{ "title": "Shop now", "url": "https://yourbrand.com/shop" }]
        } }
      ],
      "edges": [{ "id": "e1", "source": "t1", "target": "m1" }]
    }
  }'

مطابقة الكلمات المفتاحية

أي من الكلمات أو كلها، بحد أقصى 20 كلمة، على التعليقات فقط أو على كل أنواع الرسائل.

الموافقة أولاً

الأتمتة الجديدة تحتجز كل ردّ ليوافق عليه شخص قبل إرساله.

مرة واحدة لكل تعليق

يُحجز التعليق قبل خروج الـ DM، فلا يُردّ عليه مرتين أبداً.

المشغّل

حدّد التعليقات التي تستحق رسالة

يعمل المشغّل inbox_message عند التعليقات الجديدة والإشارات والردود والرسائل المباشرة وردود القصص والمراجعات. ضيّق نطاقه بالكلمات المفتاحية وأنواع الرسائل وحسابات محددة أو منشورات محددة، واختر الرد على المتابعين فقط أو على أول رسالة من الشخص فقط. تعمل كل أتمتة افتراضياً 3 مرات يومياً كحد أقصى؛ ارفع maxRunsPerDay حتى 20.

اقرأ مرجع المشغّل
أتمتات تعمل بجدول زمني وعلى خلاصة منشورات وعبر الشبكات

لكل منشور

يقصر postIds الأتمتة على التعليقات تحت المنشورات التي تسمّيها.

للمتابعين فقط

يتخطى followersOnly المعلّقين الذين لا يتابعون الحساب.

حد يومي

يمنع maxRunsPerDay المنشور الرائج من إرسال مئات الرسائل.

الرسالة

ردّ خاص، بصياغتك أنت

تُرسل الخطوة send_message مع ضبط channel على private رسالة DM إلى صاحب التعليق عبر الرد الخاص من Meta. استخدم {{contact.name}} و{{message.text}} في النص، وأضف حتى 3 أزرار روابط أو 13 ردّاً سريعاً، وأرفق رابطاً يحمل وسوم UTM وتُحتسب إعادة توجيهاته. تقبل Meta الرد الخاص خلال 7 أيام فقط من التعليق، لذا تفشل التعليقات الأقدم بهذا السبب.

اطّلع على الخطوة send_message
POST /v1/automations/:id/dry-run
curl -X POST https://api.fopost.com/v1/automations/f2b7d9a4-.../dry-run \
  -H "X-API-Key: $API_KEY"

{
  "would_defer": false,
  "approval_mode": false,
  "steps": [
    { "node_id": "t1", "action_type": "trigger", "status": "completed", ... },
    { "position": 1, "node_id": "m1", "action_type": "send_message", "status": "completed",
      "handle": "out", "error_message": null,
      "output": { "messagePreview": "Hi Jordan, here is the link you asked for.", "channel": "private" } }
  ],
  "drafts": [],
  "total_delay_ms": 0,
  "credits_charged": 0
}

تشغيل تجريبي

عاين الرسالة على تعليق حديث. لا يُرسل شيء ولا يُنشأ شيء.

روابط متتبَّعة

تُحتسب النقرات ويحمل الرابط utm_medium=dm.

نافذة 7 أيام

حد Meta للردود الخاصة، يُفحص قبل أي إرسال.

التحكم

وافق وأوقف وراجع كل تشغيل

ما لم تضبط خطوة requireApproval على false، ينتظر كل ردّ في GET /v1/inbox/approvals إلى أن يوافق عليه شخص أو يرفضه. فعّل الأتمتة وعطّلها باستدعاء واحد، واقرأ سجل تشغيلها لترى ما عمل وما ينتظر وما فشل.

ابدأ البناء
POST /v1/automations/:id/toggle
curl "https://api.fopost.com/v1/inbox/approvals?workspace_id=9b2f6c1e-..." \
  -H "X-API-Key: $API_KEY"

curl -X POST https://api.fopost.com/v1/inbox/approvals/:id/approve -H "X-API-Key: $API_KEY"

curl -X POST https://api.fopost.com/v1/automations/f2b7d9a4-.../toggle -H "X-API-Key: $API_KEY"

{ "id": "f2b7d9a4-...", "active": false }

سجل التشغيل

GET /v1/automations/:id/runs مع الحالة ووقت البدء وأي خطأ.

إعادة التشغيل

أعد تشغيل عملية سابقة بعد إصلاح الرسالة أو المشغّل.

الإصدارات

كل تغيير محفوظ هو إصدار يمكنك عرضه أو استعادته.

أسئلة حول من التعليقات إلى DM، مع إجاباتها

ما الشبكات التي تدعم التعليق إلى DM؟

Instagram وFacebook. الردود الخاصة على التعليقات ميزة من Meta، ولا تقدم الشبكات الأخرى ما يعادلها. ومع ذلك يمكن للأتمتة نفسها الرد على التعليقات علناً على الشبكات الأخرى بضبط channel على same.

هل يمكن أن يتلقى الشخص نفسه الرسالة مرتين؟

ليس لنفس التعليق. يُعلَّم التعليق قبل إرسال الـ DM، ولا تعمل الأتمتة إلا مرة واحدة لكل تعليق، فلا ترسل إعادة المحاولات أو التشغيلات المتكررة شيئاً جديداً.

هل ترسل دون أن يراجعها أحد؟

ليس افتراضياً. الخطوة send_message المنشأة دون requireApproval تحتجز كل ردّ للموافقة. اضبط requireApproval على false في الخطوة عندما تكون مستعداً لأن ترسل من تلقاء نفسها.

ماذا يحدث للتعليقات الأقدم من 7 أيام؟

لا تسمح Meta بالرد الخاص بعد 7 أيام، لذا يفشل التشغيل بهذا السبب ولا يُرسل شيء.

ما نطاقات مفتاح API التي أحتاجها؟

إنشاء الأتمتات وإدارتها يتطلب نطاق automations. أما عرض الردود المحتجزة والموافقة عليها فيستخدم نطاق inbox.

هل يمكنني بدء أتمتة من نظامي الخاص؟

نعم، بمشغّل مختلف. الأتمتة ذات المشغّل api_webhook تعمل عندما ترسل POST إلى /v1/automations/:id/trigger مع سرّها في الترويسة x-automation-secret.

ابنِ على من التعليقات إلى DM اليوم

البداية مجانية وواجهة API كاملة مُضمَّنة. أنشئ مفتاحًا ونفّذ أول طلب خلال دقائق.

احصل على مفتاح API