انشر وجدول على 13 شبكة بواجهة REST API واحدة. اقرأ التحليلات، ورد على التعليقات والرسائل المباشرة، واستقبل webhook موقّعًا لحظة نشر المنشور أو فشله أو اعتماده.
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"}
{"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"}]}
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 المنشور وفق قواعد كل شبكة، ويضعه في التقويم، وينشره في موعده.
GET /api/v1/social_profiles للحصول على معرّفات الحسابات التي تريد النشر عليها.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" }'
require "net/http" require "json" uri = URI("https://robinreach.com/api/v1/posts") request = Net::HTTP::Post.new(uri, "Authorization" => "Bearer YOUR_API_KEY", "Content-Type" => "application/json") request.body = { content: "Our autumn menu lands on Friday.", social_profile_ids: [101, 102], publish_time: "2026-11-20T09:00", timezone: "America/New_York", status: "scheduled" }.to_json response = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https") { |http| http.request(request) } puts response.body
const response = await fetch("https://robinreach.com/api/v1/posts", { method: "POST", headers: { Authorization: "Bearer YOUR_API_KEY", "Content-Type": "application/json", }, body: JSON.stringify({ content: "Our autumn menu lands on Friday.", social_profile_ids: [101, 102], publish_time: "2026-11-20T09:00", timezone: "America/New_York", status: "scheduled", }), }); console.log(await response.json());
import requests response = requests.post( "https://robinreach.com/api/v1/posts", headers={"Authorization": "Bearer YOUR_API_KEY"}, json={ "content": "Our autumn menu lands on Friday.", "social_profile_ids": [101, 102], "publish_time": "2026-11-20T09:00", "timezone": "America/New_York", "status": "scheduled", }, timeout=30, ) print(response.json())
تغطي الواجهة البرمجية العمل الذي يؤديه فريقك في لوحة التحكم، ليؤديه الكود الخاص بك أيضًا.
أنشئ المنشورات وتحقق منها وانشرها فورًا وأعد جدولتها واحذفها، مع خيارات كل شبكة الخاصة، مربوطة بفكرة حين تأتي منها.
/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أضف نقاط استقبال، وأرسل أحداثًا تجريبية، وغيّر أسرار التوقيع، واقرأ سجل التسليم.
/webhook_endpoints/webhook_endpoints/{id}/webhook_endpoints/{id}/test/webhook_endpoints/{id}/rotate_secret/webhook_endpoints/{id}/enable/webhook_endpoints/{id}/deliveriesأضف نقطة استقبال HTTPS ويرسل RobinReach طلب POST موقّعًا للأحداث التي تختارها. نبّه فريقك، أو زامن نظام CRM، أو رد على تعليق أو رسالة مباشرة في اللحظة التي تصل فيها.
post.publishedنُشر منشور على كل الحسابات المحددة.post.partially_publishedنُشر منشور على بعض الحسابات وفشل على أخرى.post.failedفشل منشور على كل الحسابات المحددة، مع السبب لكل منها.post.approvedاعتُمد منشور في لوحة التحكم أو عبر Approval Link.post.rejectedرُفض منشور، مع ملاحظة المراجع.comment.receivedعلّق شخص آخر على حساب مربوط. ردودك أنت لا تطلقه أبدًا.review.receivedوصلت مراجعة جديدة على الملف التجاري على Google.message.receivedأرسل أحدهم رسالة مباشرة إلى صفحة Facebook أو حساب Instagram مربوط.حتى 10 نقاط استقبال لكل علامة. وبالمفتاح الرئيسي يمكن لنقطة استقبال على علامتك الافتراضية أن تستقبل أحداث كل العلامات معًا.
{
"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 للطابع الزمني والمحتوى الخام، موقّع بسر التوقيع الخاص بنقطة الاستقبال. تحقق منه قبل الوثوق بالمحتوى، وارفض الطوابع الزمنية الأقدم من خمس دقائق.
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
import crypto from "node:crypto"; import express from "express"; const app = express(); app.post("/webhooks/robinreach", express.raw({ type: "application/json" }), (req, res) => { const raw = req.body.toString("utf8"); if (!verify(raw, req.get("X-RobinReach-Signature"), process.env.ROBINREACH_WEBHOOK_SECRET)) { return res.sendStatus(401); } const event = JSON.parse(raw); // Skip event.id if you have seen it, then queue the work. res.sendStatus(200); }); function verify(rawBody, header, secret, toleranceSec = 300) { const parts = Object.fromEntries((header || "").split(",").map((p) => p.split("=", 2))); const t = Number(parts.t); if (!t || !parts.v1 || Math.abs(Date.now() / 1000 - t) > toleranceSec) return false; const expected = crypto.createHmac("sha256", secret).update(`${t}.${rawBody}`).digest("hex"); const a = Buffer.from(expected), b = Buffer.from(parts.v1); return a.length === b.length && crypto.timingSafeEqual(a, b); }
import hashlib, hmac, os, time from flask import Flask, request, abort app = Flask(__name__) @app.post("/webhooks/robinreach") def robinreach_webhook(): raw = request.get_data() if not verify(raw, request.headers.get("X-RobinReach-Signature", ""), os.environ["ROBINREACH_WEBHOOK_SECRET"]): abort(401) event = request.get_json() # Skip event["id"] if you have seen it, then queue the work. return "", 200 def verify(raw_body, header, secret, tolerance=300): parts = dict(p.split("=", 1) for p in header.split(",") if "=" in p) try: t = int(parts["t"]) except (KeyError, ValueError): return False if "v1" not in parts or abs(time.time() - t) > tolerance: return False expected = hmac.new(secret.encode(), f"{t}.".encode() + raw_body, hashlib.sha256).hexdigest() return hmac.compare_digest(expected, parts["v1"])
يُعاد التسليم الفاشل 7 مرات على مدى نحو 28 ساعة، مع فواصل تطول في كل مرة.
بعد 10 عمليات تسليم فاشلة متتالية تتوقف نقطة الاستقبال مؤقتًا ويتلقى مدير العلامة رسالة بريد إلكتروني. استأنفها بنقرة واحدة.
لكل حدث معرّف فريد، ليتجاهل الكود الخاص بك التكرار النادر.
تُحفظ كل محاولة ورمز حالتها ومحتوى استجابتها لمدة 30 يومًا، ويمكنك إرسال حدث تجريبي في أي وقت.
https://robinreach.com/api/v1. كل المسارات في هذه الصفحة نسبية إليه.Authorization: Bearer YOUR_API_KEY. يعمل معامل الاستعلام api_key أيضًا، لكنه قد ينتهي في سجلات الخادم، لذا فضّل الترويسة.brand_id. أما مفتاح العلامة فيصل إلى علامة واحدة فقط، لذا يمكن تسليمه بأمان لعميل أو لأداة ذات غرض واحد.America/New_York، أو حسب المنطقة الزمنية للعلامة إذا لم تمرّر واحدة.401 عند غياب المفتاح أو خطئه، و404 لكل ما يقع خارج نطاق المفتاح، و422 مع رسالة واضحة عندما يخالف المنشور قواعد إحدى الشبكات.429 مع الترويستين Retry-After وX-RateLimit-*، ليتمهل العميل من تلقاء نفسه./api/v1، ويذكر كل webhook إصدار محتواه في api_version.تحتفظ كل شبكة بخياراتها، مثل Reels على Instagram وعناوين YouTube ولوحات Pinterest ومنشورات المستندات على LinkedIn، وتُضبط لكل منشور في platform_options.
امنح مستخدميك النشر على 13 شبكة دون أن تبني الواجهة البرمجية لكل شبكة وتصونها بنفسك.
أدر كل علامة عميل من حساب واحد، مع مفتاح علامة وwebhooks خاصة بكل عميل.
حوّل المنتجات والإعلانات والمقالات والفعاليات الجديدة إلى منشورات مجدولة فور ظهورها.
أرسل المنشورات الفاشلة إلى Slack، وادفع النتائج إلى نظام CRM، واسحب التحليلات إلى لوحاتك الخاصة.
يحصل Claude وChatGPT وCursor ووكلاؤك الخاصون على الإجراءات نفسها كأدوات، عبر رابط واحد والمفتاح نفسه.
اطلع على خادم MCPثبّت n8n-nodes-robinreach وجدول المنشورات من أي سير عمل في n8n.
اعرض على GitHubاستدعِ الواجهة البرمجية من خطوة webhook في Zapier أو من وحدة HTTP في Make. وتجد في صفحة التكاملات الإعدادات جاهزة للنسخ.
افتح التكاملاتAuthorization: Bearer YOUR_API_KEY. يعمل معامل الاستعلام api_key أيضًا، لكن الترويسة تُبقي المفتاح خارج سجلات الخادم.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 لفحصه وفق قواعد كل شبكة دون حفظه.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 للرد فور وصول أي شيء./api/v1/ideas الأفكار ويضيفها (حتى 20 دفعة واحدة) ويعدّلها ويحذفها مع ملاحظاتها وروابطها وتصنيفاتها وملفات مكتبة الوسائط، ويكتب POST /api/v1/ideas/generate أفكارًا جديدة بالذكاء الاصطناعي من RobinReach مقابل منشور واحد بالذكاء الاصطناعي. مرّر idea_id عند إنشاء منشور فتتبعه الفكرة على اللوحة من المسودة حتى النشر.أنشئ مفتاحًا، وجدول منشورًا بطلب واحد، وأضف webhook. ويضم المرجع كل حقل.
الوصول إلى الواجهة البرمجية متوفر في Bloom، Thrive وScale.