واجهة API للمراسلةAPI

الرسائل المباشرة على كل شبكة، من كودك الخاص

يجمع FoPost كل محادثة DM من حساباتك المرتبطة في مكان واحد. اعرض المحادثات، وابدأ محادثات جديدة، وراسل شريحة من جهات اتصالك دفعة واحدة، أو أرسل سلسلة رسائل على مدى أيام، كل ذلك بمفتاح API نفسه.

احصل على مفتاح APIاقرأ الوثائق
GET /v1/inbox/conversations
curl "https://api.fopost.com/v1/inbox/conversations?workspace_id=9b2f6c1e-..." \
  -H "X-API-Key: $API_KEY"

{
  "data": [
    {
      "workspace_id": "9b2f6c1e-...",
      "account_id": "4a71d80b-...",
      "conversation_id": "t_1029384756",
      "message_count": 6,
      "unread_count": 2,
      "last_message_at": "2026-11-10T16:42:08Z",
      "last_message_text": "Is the large size back in stock?",
      "last_message_outbound": false,
      "participant": { "name": "Jordan P.", "handle": "jordanp", "avatar_url": "https://..." },
      "account": { "id": "4a71d80b-...", "platform": "instagram", "username": "yourbrand" }
    }
  ],
  "meta": { "page": 1, "per_page": 25, "total": 1, "total_pages": 1 }
}

قائمة محادثات واحدة

كل محادثات DM من كل حساب مرتبط، الأحدث أولاً.

الرسائل الجماعية

رسالة واحدة تصل إلى المحادثات القائمة مع مجموعة مصفّاة من جهات الاتصال.

التسلسلات

سلسلة رسائل، تُرسل كل واحدة بعد عدد محدد من الساعات من سابقتها.

المحادثات

اقرأ المحادثة، أو ردّ عليها، أو افتح محادثة جديدة

ردّ داخل محادثة قائمة عبر POST /v1/inbox/:id/reply. ابدأ محادثة جديدة بالمعرّف على X وMastodon وReddit وSlack، أو مرّر comment_id للرد على تعليق في Instagram أو Facebook بشكل خاص. وعلى Facebook وInstagram يمكنك أيضاً إظهار مؤشر الكتابة، وعلى Messenger يمكنك تسليم المحادثة إلى تطبيق آخر واستعادتها.

اقرأ مرجع المحادثات
POST /v1/inbox/conversations
curl -X POST https://api.fopost.com/v1/inbox/conversations \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "4a71d80b-...",
    "handle": "jordanp",
    "text": "Thanks for the order. Your tracking link is on its way."
  }'

{ "conversation_id": "t_1029384756", "item": { "id": "2c9d4e81-...", "type": "dm", ... } }

نص ووسائط

حتى 10 معرّفات وسائط من مكتبتك تُرفق عندما تسمح الشبكة بذلك.

الكتابة والتسليم

POST /v1/inbox/conversations/:id/typing و/handover لمحادثات Meta.

X Chat

تمرّ محادثات X المشفّرة كنص مشفّر، ويبقى المفتاح في المتصفح.

الرسائل الجماعية

راسل شريحة دون مخالفة قواعد المنصة

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

اطّلع على مرجع الرسائل الجماعية
POST /v1/broadcasts/:id/send
curl -X POST https://api.fopost.com/v1/broadcasts \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_id": "9b2f6c1e-...",
    "account_id": "4a71d80b-...",
    "name": "Restock, November",
    "text": "The large size is back in stock this week.",
    "audience": { "platforms": ["instagram"], "label_ids": ["d41e7a90-..."] }
  }'

curl -X POST https://api.fopost.com/v1/broadcasts/8e2a5c13-.../send -H "X-API-Key: $API_KEY"

{ "id": "8e2a5c13-...", "status": "sending", "recipients": 212 }

أرسل الآن أو لاحقاً

اضبط scheduled_at لوضعها في قائمة الانتظار، أو ألغِها قبل خروجها.

نتيجة لكل مستلم

يعرض GET /v1/broadcasts/:id/recipients حالة كل مستلم: أُرسلت أو تُخطّيت أو فشلت، مع السبب.

تُرسل مرة واحدة

يُحجز كل مستلم قبل الإرسال، فلا تؤدي إعادة المحاولة إلى مراسلته مرتين.

التسلسلات

تابع على مدى أيام، تلقائياً

التسلسل قائمة تضم حتى 20 خطوة، كل خطوة رسالة وتأخير بالساعات بعد الخطوة السابقة. سجّل جهات الاتصال بالمعرّف أو بمرشّح الجمهور نفسه الذي تستخدمه الرسالة الجماعية، وألغِ تسجيلهم في أي وقت. تُتخطى أي خطوة تقع خارج نافذة المراسلة ويستمر التسلسل.

اطّلع على مرجع التسلسلات
POST /v1/sequences/:id/enroll
curl -X POST https://api.fopost.com/v1/sequences/5b9c2e40-.../enroll \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "contact_ids": ["a7f3c2d1-..."] }'

{ "id": "5b9c2e40-...", "enrolled": 1 }

إيقاف مؤقت في أي وقت

اضبط status على paused ولن تخرج أي خطوات أخرى حتى تستأنف.

إلغاء التسجيل

يوقف POST /v1/sequences/:id/unenroll الإرسال إلى جهة الاتصال فوراً.

أعداد المسجّلين

النشطون والمكتملون والمتوقفون والفاشلون، لكل تسلسل.

جهات الاتصال

اعرف من تتحدث إليه

من يراسل حساباتك يصبح جهة اتصال تلقائياً. أضف المزيد يدوياً أو استورد ملف CSV بحد أقصى 5,000 صف يضم عمودَي المنصة والمعرّف. عرّف حتى 50 حقلاً مخصصاً لكل مساحة عمل (نص أو رقم أو تاريخ أو اختيار أو نعم/لا) وصفِّ الرسائل الجماعية والتسلسلات بناءً عليها.

ابدأ البناء
حسابات مرتبطة عبر كل الشبكات في مساحة عمل واحدة

استيراد CSV

يعيد POST /v1/contacts/import الصفوف المُنشأة والمدمجة والمتخطّاة مع الأسباب.

حقول مخصصة

الأعمدة التي تطابق مفتاح حقل تُعبَّأ تلقائياً عند الاستيراد.

السجل الكامل

يعرض GET /v1/contacts/:id/conversations ما كتبته كل جهة اتصال.

أسئلة حول واجهة API للمراسلة، مع إجاباتها

إلى أي الشبكات يمكنني إرسال رسائل؟

تُقرأ المحادثات من Bluesky وFacebook وInstagram وMastodon وReddit وSlack وTelegram وWhatsApp وX متى منح الحساب إذن المراسلة. أما بدء محادثة جديدة بالمعرّف فيعمل على X وMastodon وReddit وSlack.

ما نافذة المراسلة؟

تقبل Facebook وInstagram وWhatsApp رسالة تجارية خلال 24 ساعة فقط من آخر رسالة من جهة الاتصال. تتحقق الرسائل الجماعية والتسلسلات من ذلك قبل كل إرسال وتتخطى من هم خارجها، مع تسجيل السبب.

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

قراءة المحادثات وجهات الاتصال والرسائل الجماعية والتسلسلات تتطلب نطاق inbox. وأي عملية تضع رسالة على شبكة، مثل إرسال رسالة جماعية أو تسجيل جهة اتصال، تتطلب publish أيضاً.

هل يمكن لرسالة جماعية أن تصل إلى أشخاص لم يراسلونا قط؟

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

هل يُرسل شيء دون طلبي؟

تُرسل الرسالة الجماعية عندما تستدعي send أو في الوقت الذي جدولته. ويرسل التسلسل خطواته بعد أن تسجّل أحداً فيه. لا يُراسَل أحد بما لم تُعدّه.

هل هناك حد للطلبات؟

نعم، 100 طلب في الدقيقة لكل مفتاح. وتطبق الشبكات حدودها الخاصة أيضاً، ويأتي الإرسال المرفوض مع سبب الشبكة.

ابنِ على واجهة API للمراسلة اليوم

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

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