Webhooks · Zapier · Make · n8n
اربط Brainy Social بالأتمتة بتاعتك
Brainy Social بيبعت POST فيه JSON موقّع للينك بتاعك لما يحصل حاجة في الـ workspace. استخدمه علشان تضيف العملاء المحتملين لشيت أو CRM، أو تنبّه الفريق برسايل واتساب الجديدة، أو تسجّل كل بوست اتنشر.
19 نوفمبر 2026
الأحداث
اختار الأحداث اللي كل Webhook يستقبلها. كل حدث ليه نفس الشكل: id وtype وcreated_at وworkspace_id وdata.
- post.published
- بوست مجدول أو فوري اتنشر على منصة (المنصة، الحساب، الكابشن، اللينك، المواعيد).
- message.received
- رسالة جديدة في محادثة وصلت الـ Inbox: رسايل إنستجرام وفيسبوك، رسايل X، ومحادثات واتساب وتيليجرام (اسم المرسل، النص، الوقت).
- comment.received
- تعليق أو منشن أو تقييم جوجل جديد وصل الـ Inbox (نفس البيانات ومعاها لينك البوست).
- lead.created
- حد بعت فورم التواصل في صفحة اللينك في البايو (الاسم، الإيميل أو الموبايل، الرسالة، مصدر الـ UTM).
ضيف Webhook في Brainy
- افتح الـ workspace ← قايمة الترس ← التكاملات والـ Webhooks (للمالك والأدمن).
- الصق اللينك اللي الأداة بتديهولك (https بس، على عنوان عام، بورت 443).
- اختار الأحداث واحفظ. انسخ المفتاح السري — بيظهر مرة واحدة بس.
- دوس “ابعت تجربة” علشان يوصل حدث تجريبي وتربط بياناته في الأداة.
Zapier
- اعمل Zap بالـ trigger “Webhooks by Zapier” ← “Catch Hook”.
- انسخ الـ custom webhook URL وضيفه في Brainy مع الأحداث اللي عايزها.
- في Brainy دوس “ابعت تجربة”، وبعدين “Test trigger” في Zapier: البيانات التجريبية هتظهر تحت data.
- ضيف الأكشنز بتاعتك (Google Sheets أو HubSpot أو Slack…) وشغّل الـ Zap.
Make
- ضيف موديول “Webhooks” ← “Custom webhook” واعمل webhook جديد.
- انسخ العنوان في Brainy، ودوس “ابعت تجربة” علشان Make يتعرف على شكل البيانات.
- اربط الموديولات اللي بعده وشغّل السيناريو (الجدولة: فورًا).
n8n
- ضيف node من نوع “Webhook” بالـ method POST والرد “Immediately”.
- فعّل الـ workflow وانسخ الـ Production URL (الـ test URL بيشتغل بس وانت فاتح المحرر).
- ضيفه في Brainy ودوس “ابعت تجربة”. علشان تتأكد من التوقيع، ضيف Code node بالكود اللي تحت والـ raw body.
التوصيل وإعادة المحاولة
- Brainy بيستنى رد لحد ١٠ ثواني. أي 2xx معناه إن الحدث وصل؛ والـ redirects مش بنتبعها.
- غير كده بنعيد المحاولة بعد دقيقة، ٥ دقايق، ٣٠ دقيقة، ساعتين، ٦ ساعات و١٢ ساعة (٧ محاولات في الإجمالي)، وبعدها بنوقف. تقدر تبعت أي توصيل تاني من صفحة التكاملات.
- رد بـ 410 Gone علشان تلغي الاشتراك: الـ Webhook بيتقفل فورًا. ولو فشل ٢٠ مرة ورا بعض بيتقفل كمان.
- ممكن الحدث يوصل أكتر من مرة أو مش بالترتيب: استخدم الـ id بتاع الحدث (موجود كمان في X-Brainy-Event-Id) علشان تتجاهل المكرر.
الهيدرز
X-Brainy-Event
X-Brainy-Event-Id
X-Brainy-Delivery
X-Brainy-Timestamp
X-Brainy-Signatureمثال للبيانات
{
"id": "1c7e5b8a-0000-4000-8000-00000000e001",
"type": "comment.received",
"created_at": "2026-12-20T11:15:03Z",
"workspace_id": "6f1c2a9e-0000-4000-8000-000000000000",
"data": {
"thread_id": "6f1c2a9e-0000-4000-8000-0000000000c1",
"message_id": "6f1c2a9e-0000-4000-8000-0000000000c2",
"platform_message_id": "18000000000000000",
"platform": "facebook",
"kind": "comment",
"account_id": "6f1c2a9e-0000-4000-8000-0000000000a3",
"account_name": "Brainy Demo Store",
"from_name": "Hany Mostafa",
"from_handle": null,
"text": "عندكم فرع في المعادي؟",
"sent_at": "2026-12-20T11:15:00Z",
"post_permalink": "https://www.facebook.com/EXAMPLE"
}
}اتأكد من التوقيع
X-Brainy-Signature شكله t=<unix seconds>,v1=<hex>، والـ v1 = HMAC-SHA256 لـ <t>.<raw body> بالمفتاح السري بتاعك. احسبه على نفس البايتس اللي وصلتك بالظبط، وارفض أي توقيت أقدم من ٥ دقايق.
Node.js
import { createHmac, timingSafeEqual } from "node:crypto";
// rawBody = the exact bytes you received (before JSON.parse)
export function verifyBrainy(rawBody, header, secret = process.env.BRAINY_WEBHOOK_SECRET) {
const parts = Object.fromEntries(header.split(",").map((p) => p.split("=")));
const t = Number(parts.t);
if (!t || Math.abs(Date.now() / 1000 - t) > 300) return false; // replay window
const expected = createHmac("sha256", secret).update(`${t}.${rawBody}`).digest();
const given = Buffer.from(parts.v1 ?? "", "hex");
return given.length === expected.length && timingSafeEqual(given, expected);
}Python
import hmac, hashlib, time
def verify_brainy(raw_body: bytes, header: str, secret: str) -> bool:
parts = dict(p.split("=", 1) for p in header.split(","))
t = int(parts.get("t", "0"))
if abs(time.time() - t) > 300:
return False
expected = hmac.new(secret.encode(), f"{t}.".encode() + raw_body, hashlib.sha256).hexdigest()
return hmac.compare_digest(expected, parts.get("v1", ""))REST endpoints للأدوات
التطبيقات تقدر تدير اشتراكاتها بنفسها (REST hooks) وتسحب الأحداث بمفتاح API بصلاحية النشر من AI & MCP ← مفاتيح الـ API، لمالك أو أدمن. نفس الـ base URL والـ auth والحدود بتاعة publishing API.
POST /api/v1/webhooks{url, events, description?} — اشتراك؛ الرد فيه المفتاح السري مرة واحدة.GET /api/v1/webhooks— القايمة؛DELETE /api/v1/webhooks/{id}— إلغاء الاشتراك.GET /api/v1/events?type=&since=&limit=— آخر الأحداث، الأحدث الأول (بتتحفظ ٣٠ يوم)، للـ polling triggers.- كل الباقي — الحسابات والبوستات والميديا والأرقام — موجود في دليل المطورين.
TOKEN=bsk_EXAMPLE_not_a_real_token
API=https://brainy-social.com/api/v1
# Subscribe (REST hooks). The secret is in the answer, once.
curl -s -X POST "$API/webhooks" -H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"url": "https://hooks.example.com/brainy", "events": ["lead.created"]}'
# Unsubscribe
curl -s -X DELETE "$API/webhooks/<id>" -H "Authorization: Bearer $TOKEN"
# Polling trigger: newest events first, only newer than the last one you saw
curl -s "$API/events?type=message.received&since=2026-12-20T00:00:00Z" -H "Authorization: Bearer $TOKEN"الحدود
- لحد ١٠ Webhooks لكل workspace. الـ Webhooks جزء من باقة Growth وأعلى.
- الأحداث بتتحفظ ٣٠ يوم. النصوص بتتقص (٤٬٠٠٠ حرف للرسايل، ٢٬٠٠٠ للكابشن).
- الـ Webhooks بتبعت بس اللي عند الـ workspace أصلًا؛ ومفيش أي حاجة عن workspaces تانية.