انتقل إلى المحتوى
القنوات والتكاملات

قناة API

وصّل Entagl بتطبيقك أو بـ Make: ابعت الرسائل، استقبل الردود، وادير workspace بتاعك.

1 قم بتفعيل ردود الذكاء الاصطناعي لقناة API. لقطة شاشة مؤرخة 10 نوفمبر 2026.

نظرة عامة

قناة الـ API بتخليك تشغّل نفس الـ AI agent اللي بيشغّل الـ DMs بتاعتك من chat بتاع موقعك، أو mobile app، أو backend. إنت بتبعت رسالة، والـ agent بيفكر (بنفس الـ buffering وردود متعددة شبه الإنسان زي الـ DM الحقيقي)، والرد بيوصل لك بعد شوية، من خلال webhook callback أو polling. فعّلها من القنوات → API: اعمل API key، شغّل القناة، وبعدها اختار callback أو polling. نفس الـ API كمان بيسمح لمطورك، أو Make، يتعامل مع contacts, conversations, bookings, orders والمزيد. شوف تبويب Workspace API.

للمطوّرين: مرجع الـ API
كل endpoint وfield وحدث webhook، مع أمثلة كود.

التبويبات في الصفحة دي

الـ API مش للـ chat بس. مطورك، أو أداة زي Make، يقدر يستخدمه لقراءة وتحديث معظم الـ workspace بتاعك.

تقدر تعمل بيه إيه

غير إرسال الرسائل، الـ API بيغطي:

  • Contacts: إنشاء، تحديث، بحث، دمج، إضافة ملاحظات، وتحديد do-not-contact
  • Tags و lifecycle stages: إضافة أو إزالة tags، ونقل contact لمرحلة تانية
  • Conversations: assignment لزميل، إغلاق بـ closing note، إيقاف أو استئناف الـ AI، إضافة team comments، وإرسال رسالة باسم البزنس بتاعك
  • Bookings و reminders: فحص الأوقات الفاضية، الحجز، إعادة الجدولة، الإلغاء، وإنشاء وإغلاق reminders
  • Orders و products: إنشاء وتحديث orders وعناصرها، وإدارة الكتالوج بتاعك
  • Calls: بدء AI phone call أو إضافتها في queue، وقراءة النتيجة
  • Campaigns: تشوف campaigns بتاعتك وتبعت واحدة

لما حاجة بتتغير، Entagl يقدر يبلغ أدواتك فورًا عن طريق webhooks.

طريقتين للـ sign in

Make. لما توصل Make، بتسجّل دخول بحساب Entagl بتاعك. بعد كده Make بيتصرف كأنك إنت، بنفس صلاحياتك بالضبط: الـ owner أو admin يقدر يعمل كل حاجة، و team member يقدر يعمل بس اللي صلاحياته تسمح بيه. لو الـ login بتاعك فيه أكتر من workspace، إنت بتختار أنهي واحد تستخدمه.

API key. لسيرفرك بتاعك، اعمل key من القنوات → API أو الإعدادات → API keys وابعتُه كـ Authorization: Bearer <your key>. الـ key بيبقى تابع لـ workspace واحدة وبيكون عنده full owner access ليها، فاعتبره زي password.

آمن مع الإعادة: header الـ Idempotency-Key

أحيانًا الـ request بتوصل لكن الرد بيضيع في الرجوع. لو السيستم بتاعك مش متأكد إن الطلب اشتغل، يقدر يبعتُه تاني بنفس Idempotency-Key header. خلال 24 ساعة Entagl بيتعرف على الـ key، بيتخطى الشغل، ويرجع أول answer، فمش هتطلع لك orderين أو contactين. استخدام نفس الـ key لـ request مختلفة بيترفض بخطأ.

قد إيه request تقدر تبعت

لحد 120 request في الدقيقة لكل workspace. لو زودت عن كده، Entagl بيرد بـ error 429 (rate_limited). استنى شوية وجرّب تاني. أغلب الـ automations عمرها ما بتقرب من الحد ده.

مرجع الـ API الكامل

كل نقطة نهاية، حقل ورمز خطأ مدرج في مرجع API الخاص بـ Entagl. افتحه مع رابط للمطورين: مرجع API بالقرب من أعلى هذه الصفحة وشاركه مع مطورك.

API key بيدي full owner access للـ workspace بتاعه. خليه على السيرفر بتاعك، ومتخزنوش أبدًا جوه website أو app العملاء يقدروا يفتحوه، واعمله revoke أول ما تشك إنه اتسرّب.
التغييرات اللي بتتعمل من خلال الـ API بتتعلّم في webhook events إنها جاية من الـ API، فـ scenario في Make يقدر يتجاهل تغييره هو بدل ما يدخل في loop.

الميزات

الإعداد والمصادقة

افتح الإعدادات → التكاملات، اختر API وانقر على توليد مفتاح API. قم بتفعيل المفتاح في بطاقة قناة API، ثم اتصل بالـ API على https://api.entagl.com مع رأس التفويض: Bearer <مفتاحك>. كل مفتاح يعمل لمساحة واحدة فقط.

إرسال رسالة

ابعت POST /api/v1/messages مع { message, externalUserId }. هتاخد 202 و conversationId فورًا. استخدم نفس conversationId علشان تكمل المحادثة. رد الـ agent هييجي بعدين، مش في الـ response ده.

Webhook (callback) (موصى به)

قم بلصق عنوان URL للرد في بطاقة قناة API وانقر على حفظ. بعد ذلك، يقوم Entagl بإرسال كل رد من الوكيل إليه، موقّعًا برأس X-Entagl-Signature (HMAC-SHA256). استخدم عنوان HTTPS عام، وانقر على إرسال اختبار للتأكد من أنه يعمل. يجب على خادمك التحقق من التوقيع والرد برمز 2xx في غضون حوالي 5 ثوانٍ. لن يتم إعادة محاولة الردود الفاشلة.

الاستقصاء (Polling)

إذا لم تستطع استضافة عنوان callback، استدعِ GET /api/v1/conversations/:id/messages?since=<cursor> لجلب الردود الجديدة. مرّر قيمة cursor من كل استجابة كـ ?since= حتى تستقبل الرسائل الجديدة فقط.

الأمان والعزل

API keys بتتخزن بشكل hashed، و signing secret بيتشفّر (الاتنين بيظهروا مرة واحدة بس). وكل lookup مربوط بـ workspace: أي conversation ID من workspace تاني بيرجع 404، ومش ينفع تبعت user ID (لأنه بيتستنتج من الـ key).

مهام شائعة

إعداد قناة API

حوالي 3 دقيقة
  1. افتح الإعدادات → التكاملات، اختر API وانقر على توليد مفتاح API. أعطه اسمًا إذا أحببت، ثم انسخ المفتاح الآن، لأنه يظهر مرة واحدة فقط.
  2. قم بتفعيل المفتاح في رأس بطاقة قناة API. حتى يتم تفعيله، يتم رفض الرسائل المرسلة إلى API.
  3. موصى به: افتح إعدادات البطاقة، ألصق عنوان URL للرد وانقر على حفظ. انسخ السر الذي يظهر، ثم انقر على إرسال اختبار.
  4. من تطبيقك، أرسل الرسائل عبر POST إلى https://api.entagl.com/api/v1/messages واستقبل الردود عبر callback أو الاستقصاء.

نصائح

الردود بتكون asynchronous. الـ POST بيرجع 202، ورد الـ agent بييجي عن طريق الـ callback أو polling، مش في الـ response.
قد تُنتج رسالة واحدة عدة ردود بعد تأخير تجميع قصير (نحو 8 ثوانٍ، قابل للضبط حتى ~5 دقائق). اعرضها كلها بالترتيب.
الـ 202 مش معناه إن الرد هييجي أكيد. ممكن الـ agent يسكت لو automation متوقفة، أو guardrail منعت الرسالة، أو الـ workspace خلص credits.
لا توجد إعادة محاولة تلقائية في الـ callbacks. احتفظ بالاستقصاء كنسخة احتياطية، وتحقّق دائمًا من ترويسة X-Entagl-Signature قبل الوثوق بأي تسليم.
أعد استخدام conversationId لمتابعة محادثة؛ أما externalUserId فهو مجرد تسمية خاصة بك للمستخدم النهائي.
Text بس في الوقت الحالي. حافظ على API key و signing secret بتوعك: الاتنين بيظهروا مرة واحدة بس.

الأسئلة الشائعة

هل الصفحة دي مفيدة؟