واجهة REST لجهات الاتصال والمحادثات والرسائل والعملاء المحتملين، وويب هوك موقّع لكل حدث، وخطوات تدفق تستدعي أنظمتك — كلها ضمن كل باقة بلا إضافات.
اقرأ وأنشئ جهات الاتصال والعملاء المحتملين، واعرض المحادثات، وأرسل رسالة حقيقية على أي قناة متصلة.
استقبل كل رسالة جديدة وتغيّر حالة وصفقة مكسوبة، موقّعة لتثق فيما يصلك.
يمكن لخطوة في التدفق استدعاء نقطة النهاية الخاصة بك وحفظ قيمة من الرد على جهة الاتصال — بلا وسيط.
أضف صفًا إلى جدول بيانات من أي تدفق — الطريق بدون كود حين يكون التكامل الكامل مبالغة.
أضف سطر سكربت واحدًا لموقعك وتصل المحادثات إلى نفس صندوق الوارد مع بقية القنوات.
أرسل أحداث العملاء المحتملين والمشتريات إلى Meta لتُحسّن حملاتك على النتائج الحقيقية.
كل شيء على بُعد رمز واحد — لا حساب مطورين منفصل ولا طابور موافقات.
سجّل واربط قناة واحدة على الأقل ليكون هناك ما تتحدث إليه.
الإعدادات ← التكاملات ← واجهة برمجة التطبيقات. اختر الصلاحيات المسموحة للرمز؛ ولا يمكنه تجاوز صلاحياتك أنت.
أرسل الرمز في ترويسة Bearer. ابدأ بـ /me للتأكد من مساحة العمل التي تتحدث إليها.
# اعرض جهات اتصالك
curl https://app.labeeq.com/api/v1/contacts \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Accept: application/json"
# أرسل رسالة داخل محادثة
curl -X POST https://app.labeeq.com/api/v1/conversations/42/messages \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"body": "Your order is on its way!"}'
العنوان الأساسي: https://app.labeeq.com/api/v1
| نقطة النهاية | صلاحية الرمز | ماذا تفعل |
|---|---|---|
GET/me
|
— |
من أنا: مستخدم الرمز ومساحة العمل والصلاحيات. |
GET/contacts?search=
|
contacts:read |
قائمة جهات الاتصال من الأحدث؛ البحث يطابق الاسم والبريد. |
GET/contacts/{id}
|
contacts:read |
جهة اتصال واحدة بمعرّفها. |
POST/contacts
|
contacts:write |
إنشاء جهة اتصال (الاسم مطلوب؛ البريد والهاتف والمرحلة اختيارية). |
GET/conversations?status=&contact_id=&channel_id=
|
conversations:read |
قائمة المحادثات مع مرشحات الحالة وجهة الاتصال والقناة. |
GET/conversations/{id}
|
conversations:read |
محادثة واحدة مع قناتها والمسند إليه. |
GET/conversations/{id}/messages
|
conversations:read |
رسائل المحادثة من الأحدث. |
POST/conversations/{id}/messages
|
messages:send |
إرسال رسالة صادرة ({"body": "…"}) — تسليم حقيقي عبر القناة باسم صاحب الرمز. |
GET/leads?outcome=&contact_id=
|
leads:read |
قائمة العملاء المحتملين؛ outcome تقبل open أو won أو lost. |
POST/leads
|
leads:write |
فتح عميل محتمل (contact_id والاسم مطلوبان؛ القيمة والمصدر اختياريان). |
وجّه عنوانًا إلى خادمك، واختر أحداثك، ويرسل Labeeq كل حدث فور وقوعه — مع إعادة المحاولة والتراجع التدريجي إن كان خادمك متوقفًا.
message.received
message.sent
conversation.created
conversation.opened
conversation.closed
conversation.assigned
contact.created
contact.lifecycle_changed
lead.created
lead.won
lead.lost
كل طلب يحمل HMAC-SHA256 لجسم الطلب الخام في ترويسة X-Labeeq-Signature. قارنه بسرّ عنوانك قبل الوثوق بالبيانات.
expected = "sha256=" + HMAC_SHA256(secret, raw_body)
if (expected !== header("X-Labeeq-Signature")) reject()أنشئ مساحة عمل، وأصدر رمزًا، وستستدعي الواجهة خلال دقائق. وZapier وMake وn8n تتصل بالطريقة نفسها.