واجهة وسائل التواصل البرمجية للنشر والجدولة وwebhooks

انشر وجدول على 13 شبكة بواجهة REST API واحدة. اقرأ التحليلات، ورد على التعليقات والرسائل المباشرة، واستقبل webhook موقّعًا لحظة نشر المنشور أو فشله أو اعتماده.

REST وJSON مفاتيح API من نوع Bearer Webhooks موقّعة وخادم MCP أيضًا
REST/api/v1+webhooks
  1. تجدول منشورًا أنت → RobinReachPOST /api/v1/posts
    Authorization: Bearer YOUR_API_KEY
    {"content":"Our autumn menu lands on Friday.","social_profile_ids":[101,102],"publish_time":"2026-11-20T09:00","timezone":"America/New_York","status":"scheduled"}
  2. يضعه RobinReach في التقويم RobinReach → أنتالاستجابة
    {"id":18342,"status":"scheduled","publish_time":"2026-11-20T09:00:00-05:00","timezone":"America/New_York","social_profiles":[{"name":"Northwind Instagram","platform":"instagram","status":"pending"},{"name":"Northwind LinkedIn","platform":"linkedin","status":"pending"}]}
  3. يوم الجمعة في 9:00 يُنشر وتصلك المعلومة RobinReach → خادمكPOST https://your-app.com/webhooks
    X-RobinReach-Event: post.published
    X-RobinReach-Signature: t=1794150000,v1=5257a869e7…
    {"id":"evt_1c626cf6bcb5","type":"post.published","data":{"post":{"id":18342,"status":"published","summary":{"total":2,"published":2,"failed":0}}}}

تبادل افتراضي بمعرّفات مختلَقة. تصل webhooks على شكل طلب POST موقّع إلى نقطة استقبال HTTPS لديك.

بداية سريعة

جدول أول منشور لك بطلب واحد

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

  1. أنشئ مفتاح API من صفحة التكاملات في لوحة التحكم.
  2. استدعِ GET /api/v1/social_profiles للحصول على معرّفات الحسابات التي تريد النشر عليها.
  3. أرسل هذا الطلب. يُقرأ الوقت حسب timezone الذي تمرّره، فالساعة 09:00 تعني 9:00 لجمهورك.

لست متأكدًا من أن المنشور سيمر؟ POST /api/v1/posts/validate يجري الفحوصات نفسها دون حفظ أي شيء.

الطرفية
curl -X POST https://robinreach.com/api/v1/posts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "content": "Our autumn menu lands on Friday.",
  "social_profile_ids": [
    101,
    102
  ],
  "publish_time": "2026-11-20T09:00",
  "timezone": "America/New_York",
  "status": "scheduled"
}'
نقاط النهاية

كل ما في RobinReach عبر HTTP

تغطي الواجهة البرمجية العمل الذي يؤديه فريقك في لوحة التحكم، ليؤديه الكود الخاص بك أيضًا.

  • المنشورات والجدولة

    أنشئ المنشورات وتحقق منها وانشرها فورًا وأعد جدولتها واحذفها، مع خيارات كل شبكة الخاصة، مربوطة بفكرة حين تأتي منها.

    /posts/posts/validate/posts/{id}/posts/{id}/publish_now/posts/{id}/reschedule
  • لوحة الأفكار

    اعرض أفكار منشورات العلامة وأضفها وعدّلها وأرشفها، واكتب أفكارًا جديدة بالذكاء الاصطناعي من RobinReach.

    /ideas/ideas/generate/ideas/{id}
  • مكتبة الوسائط

    ارفع الصور والفيديوهات وملفات PDF، ونظّمها في مجلدات، وأعد استخدامها في المنشورات.

    /attachments/attachments/{id}/folders/folders/{id}
  • العلامات والحسابات

    اعرض العلامات والحسابات المربوطة، إضافة إلى لوحات Pinterest وصوتيات Instagram وتصنيفات WordPress ووسومه والمواقع ومجموعات الوسوم.

    /brands/brands/{id}/social_profiles/social_profiles/{id}/social_profiles/{id}/pinterest_boards/locations/hashtag_groups
  • التحليلات

    التفاعل لكل حساب ولكل منشور، وأفضل منشوراتك، وهذا الأسبوع مقارنة بالأسبوع الماضي، والتقويم.

    /analytics/summary/analytics/top_posts/posts/{id}/analytics/social_profiles/{id}/analytics/calendar
  • التعليقات والرسائل

    اقرأ سلاسل التعليقات ورسائل Facebook وInstagram المباشرة ومراجعات Google عبر حساباتك، ورد باسم العلامة.

    /comment_threads/comment_threads/{id}/reply
  • الأتمتات

    أنشئ أتمتات الرسائل التلقائية للتعليقات وموجزات RSS ومهام إعادة الاستخدام، وأوقفها مؤقتًا واستأنفها. تحقق من الموجز قبل إضافته، وشغّل المهمة متى شئت.

    /comment_automations/comment_automations/{id}/pause/rss_feeds/rss_feeds/validate/rss_feeds/{id}/sync/repurposing_tasks/repurposing_tasks/{id}/run
  • صفحة البايو

    عدّل صفحة البايو الخاصة بالعلامة وكتلها، ورتّبها، واقرأ تحليلات الصفحة، واحصل على رمز QR الخاص بها.

    /bio_page/bio_page/blocks/bio_page/blocks/{id}/bio_page/blocks/reorder/bio_page/analytics/bio_page/qr
  • روابط العملاء

    تتيح Connect Links للعملاء إضافة حساباتهم بأنفسهم، وتتيح لهم Approval Links مراجعة المنشورات دون تسجيل الدخول.

    /connect_links/connect_links/{id}/approval_links/approval_links/{id}/posts/{id}/approve/posts/{id}/reject
  • Webhooks

    أضف نقاط استقبال، وأرسل أحداثًا تجريبية، وغيّر أسرار التوقيع، واقرأ سجل التسليم.

    /webhook_endpoints/webhook_endpoints/{id}/webhook_endpoints/{id}/test/webhook_endpoints/{id}/rotate_secret/webhook_endpoints/{id}/enable/webhook_endpoints/{id}/deliveries
Webhooks

توقف عن الاستعلام المتكرر. اعرف لحظة حدوثه.

أضف نقطة استقبال HTTPS ويرسل RobinReach طلب POST موقّعًا للأحداث التي تختارها. نبّه فريقك، أو زامن نظام CRM، أو رد على تعليق أو رسالة مباشرة في اللحظة التي تصل فيها.

8 أحداث للاشتراك فيها

  • post.publishedنُشر منشور على كل الحسابات المحددة.
  • post.partially_publishedنُشر منشور على بعض الحسابات وفشل على أخرى.
  • post.failedفشل منشور على كل الحسابات المحددة، مع السبب لكل منها.
  • post.approvedاعتُمد منشور في لوحة التحكم أو عبر Approval Link.
  • post.rejectedرُفض منشور، مع ملاحظة المراجع.
  • comment.receivedعلّق شخص آخر على حساب مربوط. ردودك أنت لا تطلقه أبدًا.
  • review.receivedوصلت مراجعة جديدة على الملف التجاري على Google.
  • message.receivedأرسل أحدهم رسالة مباشرة إلى صفحة Facebook أو حساب Instagram مربوط.

حتى 10 نقاط استقبال لكل علامة. وبالمفتاح الرئيسي يمكن لنقطة استقبال على علامتك الافتراضية أن تستقبل أحداث كل العلامات معًا.

ما يصل

طلب POST إلى نقطة الاستقبال
{
  "id": "evt_1c626cf6bcb54613a8053e24d5361527",
  "type": "post.published",
  "created_at": "2026-11-20T14:00:00Z",
  "api_version": "2026-11-01",
  "data": {
    "brand": {
      "id": "northwind",
      "name": "Northwind Coffee"
    },
    "post": {
      "id": 18342,
      "status": "published",
      "content": "Our autumn menu lands on Friday.",
      "social_profiles": [
        {
          "id": 101,
          "platform": "instagram",
          "status": "published",
          "remote_url": "https://www.instagram.com/p/C9xYz12AbCd/"
        },
        {
          "id": 102,
          "platform": "linkedin",
          "status": "published",
          "remote_url": "https://www.linkedin.com/feed/update/urn:li:share:7392018841650188288/"
        }
      ],
      "summary": {
        "total": 2,
        "published": 2,
        "failed": 0
      }
    }
  }
}

تحقق من كل طلب

يحمل كل طلب X-RobinReach-Signature: t=…,v1=…، وهو HMAC-SHA256 للطابع الزمني والمحتوى الخام، موقّع بسر التوقيع الخاص بنقطة الاستقبال. تحقق منه قبل الوثوق بالمحتوى، وارفض الطوابع الزمنية الأقدم من خمس دقائق.

robinreach_webhooks_controller.rb
class RobinreachWebhooksController < ActionController::API
  def create
    body = request.raw_post
    return head :unauthorized unless valid_signature?(body, request.headers["X-RobinReach-Signature"])

    event = JSON.parse(body)
    # Skip event["id"] if you have seen it, then queue the work.
    head :ok
  end

  private

  def valid_signature?(body, header, tolerance: 300)
    parts = header.to_s.split(",").map { |p| p.split("=", 2) }.select { |kv| kv.size == 2 }.to_h
    t = Integer(parts["t"].to_s, exception: false)
    return false unless t && parts["v1"] && (Time.now.to_i - t).abs <= tolerance

    expected = OpenSSL::HMAC.hexdigest("SHA256", ENV.fetch("ROBINREACH_WEBHOOK_SECRET"), "#{t}.#{body}")
    ActiveSupport::SecurityUtils.secure_compare(expected, parts["v1"])
  end
end
موثوق افتراضيًا

مصمم لليوم الذي يتعطل فيه خادمك

  • إعادة المحاولة لنحو يوم

    يُعاد التسليم الفاشل 7 مرات على مدى نحو 28 ساعة، مع فواصل تطول في كل مرة.

  • إيقاف مؤقت، لا صمت

    بعد 10 عمليات تسليم فاشلة متتالية تتوقف نقطة الاستقبال مؤقتًا ويتلقى مدير العلامة رسالة بريد إلكتروني. استأنفها بنقرة واحدة.

  • آمن إن وصل مرتين

    لكل حدث معرّف فريد، ليتجاهل الكود الخاص بك التكرار النادر.

  • سجل للتسليم

    تُحفظ كل محاولة ورمز حالتها ومحتوى استجابتها لمدة 30 يومًا، ويمكنك إرسال حدث تجريبي في أي وقت.

التفاصيل

ما يحتاج كل تكامل إلى معرفته

عنوان URL الأساسي
https://robinreach.com/api/v1. كل المسارات في هذه الصفحة نسبية إليه.
المصادقة
أرسل مفتاحك على شكل Authorization: Bearer YOUR_API_KEY. يعمل معامل الاستعلام api_key أيضًا، لكنه قد ينتهي في سجلات الخادم، لذا فضّل الترويسة.
المفاتيح الرئيسية ومفاتيح العلامات
يصل المفتاح الرئيسي إلى كل علامات الحساب، واختر إحداها بـ brand_id. أما مفتاح العلامة فيصل إلى علامة واحدة فقط، لذا يمكن تسليمه بأمان لعميل أو لأداة ذات غرض واحد.
الصيغة
JSON في الإرسال والاستقبال. الأوقات بصيغة ISO 8601، وتُقرأ حسب المنطقة الزمنية IANA التي تمرّرها، مثل America/New_York، أو حسب المنطقة الزمنية للعلامة إذا لم تمرّر واحدة.
الأخطاء
401 عند غياب المفتاح أو خطئه، و404 لكل ما يقع خارج نطاق المفتاح، و422 مع رسالة واضحة عندما يخالف المنشور قواعد إحدى الشبكات.
حدود الطلبات
الطلبات محدودة لكل مفتاح. ويحصل الطلب المقيّد على 429 مع الترويستين Retry-After وX-RateLimit-*، ليتمهل العميل من تلقاء نفسه.
الإصدارات
رقم إصدار REST API في المسار، /api/v1، ويذكر كل webhook إصدار محتواه في api_version.
الخطط
متوفرة في Bloom، Thrive وScale. أنشئ المفاتيح من صفحة التكاملات في لوحة التحكم.
ما يبنيه الناس

واجهة برمجية واحدة، و13 شبكة

تحتفظ كل شبكة بخياراتها، مثل Reels على Instagram وعناوين YouTube ولوحات Pinterest ومنشورات المستندات على LinkedIn، وتُضبط لكل منشور في platform_options.

  • الجدولة داخل منتجك

    امنح مستخدميك النشر على 13 شبكة دون أن تبني الواجهة البرمجية لكل شبكة وتصونها بنفسك.

  • العمل مع العملاء على نطاق واسع

    أدر كل علامة عميل من حساب واحد، مع مفتاح علامة وwebhooks خاصة بكل عميل.

  • منشورات من بياناتك

    حوّل المنتجات والإعلانات والمقالات والفعاليات الجديدة إلى منشورات مجدولة فور ظهورها.

  • التنبيهات والتقارير

    أرسل المنشورات الفاشلة إلى Slack، وادفع النتائج إلى نظام CRM، واسحب التحليلات إلى لوحاتك الخاصة.

طرق أخرى

بلا كود، أو مع وكيل ذكاء اصطناعي؟ المنصة نفسها.

  • خادم MCP لوكلاء الذكاء الاصطناعي

    يحصل Claude وChatGPT وCursor ووكلاؤك الخاصون على الإجراءات نفسها كأدوات، عبر رابط واحد والمفتاح نفسه.

    اطلع على خادم MCP
  • عقدة مجتمع n8n

    ثبّت n8n-nodes-robinreach وجدول المنشورات من أي سير عمل في n8n.

    اعرض على GitHub
  • Zapier وMake

    استدعِ الواجهة البرمجية من خطوة webhook في Zapier أو من وحدة HTTP في Make. وتجد في صفحة التكاملات الإعدادات جاهزة للنسخ.

    افتح التكاملات
الأسئلة الشائعة

أسئلة يطرحها المطورون

ما واجهة RobinReach البرمجية؟

واجهة REST API للنشر على وسائل التواصل. بمفتاح واحد تنشئ المنشورات وتجدولها وتنشرها على 13 شبكة، وترفع الوسائط، وتقرأ التحليلات، وترد على التعليقات والرسائل المباشرة، وتشغّل الأتمتات، وتستقبل webhooks، باستخدام الحسابات التي تربطها في RobinReach.

ما الشبكات الاجتماعية التي تدعمها الواجهة البرمجية؟

Instagram وFacebook وTikTok وLinkedIn وYouTube وX (Twitter) وThreads وPinterest وBluesky وMastodon والملف التجاري على Google وTelegram وWordPress. وتحتفظ كل منها بخياراتها، مثل Reels وعناوين YouTube ولوحات Pinterest.

كيف تتم المصادقة؟

أنشئ مفتاحًا من صفحة التكاملات في لوحة التحكم وأرسله على شكل Authorization: Bearer YOUR_API_KEY. يعمل معامل الاستعلام api_key أيضًا، لكن الترويسة تُبقي المفتاح خارج سجلات الخادم.

هل يمكنني قصر مفتاح API على علامة واحدة؟

نعم. يعمل المفتاح الرئيسي على كل العلامات في حسابك، وتختار إحداها بـ brand_id. ويمكن لكل علامة أيضًا أن يكون لها مفتاح خاص لا يعمل إلا عليها: لا يحتاج إلى brand_id، ولا يرى علاماتك الأخرى، ولا يستطيع إنشاء العلامات أو حذفها.

كيف أجدول منشورًا عبر الواجهة البرمجية؟

أرسل POST /api/v1/posts مع content وsocial_profile_ids وpublish_time بصيغة ISO 8601 وtimezone مثل America/New_York، واضبط status على scheduled. واستدعِ أولًا POST /api/v1/posts/validate لفحصه وفق قواعد كل شبكة دون حفظه.

هل تدعم الواجهة البرمجية webhooks؟

نعم. أضف حتى 10 نقاط استقبال HTTPS لكل علامة واختر من بين 8 أحداث: نشر منشور، ونشره جزئيًا، وفشله، واعتماده، ورفضه، ووصول تعليق، ووصول مراجعة، ووصول رسالة من Facebook أو Instagram. كل طلب موقّع بـ HMAC-SHA256، وتُعاد محاولة التسليمات الفاشلة لنحو يوم.

كيف أتحقق من توقيع webhook؟

اقرأ t وv1 من الترويسة X-RobinReach-Signature، واحسب HMAC-SHA256 لـ t.raw_body بسر التوقيع، وقارن القيمتين في زمن ثابت. وارفض الطوابع الزمنية الأقدم من خمس دقائق. وتفعل الأمثلة أعلاه ذلك بلغات Ruby وNode وPython.

هل يمكنني الرد على التعليقات والرسائل المباشرة عبر الواجهة البرمجية؟

نعم. يعرض GET /api/v1/comment_threads سلاسل التعليقات ومحادثات Facebook وInstagram ومراجعات Google، ويرد POST /api/v1/comment_threads/{id}/reply على أي منها باسم العلامة: تحت التعليق، أو بشكل خاص للرسالة المباشرة، أو علنًا على Google للمراجعة. واجمعه مع webhooks comment.received وmessage.received للرد فور وصول أي شيء.

ما الخطط التي تتضمن الوصول إلى الواجهة البرمجية؟

Bloom، Thrive وScale. ويعمل المفتاح نفسه أيضًا مع خادم MCP. اطلع على صفحة الأسعار لمعرفة حدود كل خطة.

هل يمكنني استخدامها بلا كود، أو من وكيل ذكاء اصطناعي؟

نعم. يمنح خادم MCP كلًّا من Claude وChatGPT والوكلاء الآخرين الإجراءات نفسها كأدوات، وتعمل عقدة مجتمع n8n في أي سير عمل في n8n، ويستطيع Zapier وMake استدعاء الواجهة البرمجية من خطوة webhook أو HTTP.

هل يمكنني إدارة الأتمتات وصفحة البايو عبر الواجهة البرمجية؟

نعم. تغطي نقاط النهاية أتمتات الرسائل التلقائية للتعليقات، وموجزات RSS (مع خطوة تحقق ومزامنة عند الطلب)، ومهام إعادة الاستخدام (إيقاف مؤقت أو استئناف أو تشغيل فوري)، وصفحة البايو مع كتلها وتحليلاتها ورمز QR. ويمكن استدعاء الإيقاف المؤقت والاستئناف مرتين دون خطر، فلا تستطيع إعادة المحاولة عكس أي إعداد.

هل تعمل الواجهة البرمجية مع لوحة الأفكار؟

نعم. يعرض /api/v1/ideas الأفكار ويضيفها (حتى 20 دفعة واحدة) ويعدّلها ويحذفها مع ملاحظاتها وروابطها وتصنيفاتها وملفات مكتبة الوسائط، ويكتب POST /api/v1/ideas/generate أفكارًا جديدة بالذكاء الاصطناعي من RobinReach مقابل منشور واحد بالذكاء الاصطناعي. مرّر idea_id عند إنشاء منشور فتتبعه الفكرة على اللوحة من المسودة حتى النشر.

أطلق تكاملك هذا الأسبوع

أنشئ مفتاحًا، وجدول منشورًا بطلب واحد، وأضف webhook. ويضم المرجع كل حقل.

الوصول إلى الواجهة البرمجية متوفر في Bloom، Thrive وScale.