Webhooks

الـ Events متقسمة لمجموعات: Contacts، Conversations، Messages، Handovers to your team، AI agent، Bookings، Reminders، Orders، Products، Calls، Campaigns، Forms، Account and channels، وWorkspace settings. افتح أي مجموعة وعلّم على الأحداث اللي عايزها، أو اضغط تحديد الكل علشان تختار المجموعة كلها. مش عارف حاجة مكانها فين؟ اكتب في مربع البحث، مثلًا "booking" أو "tag". دوس على أي event علشان تشوف مثال واضح Entagl هتبعت إيه بالظبط. بعض الـ events كمان بتخليك تختار مصدرها، فممكن تاخد بس الحجوزات اللي الـ AI عملتها وتتخطى اللي فريقك دخلها في الـ calendar.

رسالة واردة ورسالة صادرة بيشتغلوا مع كل رسالة لوحدها. في حساب مشغول ده ممكن يبقوا آلاف في اليوم. عشان كده تحديد الكل بيتخطّاهم: لازم تعلّم عليهم واحد واحد، جنب تحذير. فعّلهم بس لو الأداة اللي في الناحية التانية تقدر تستحمل العدد ده. لو كل اللي يهمك تعرف إمتى الشات بدأ أو انتهى، تم فتح المحادثة وتم إغلاق المحادثة أهدى بكتير.

زرارين بيحددوا قد إيه من معلومات العميل بيطلع من Entagl. تضمين محتوى الرسالة بيضيف اللي العملاء كتبوه: الرسائل، الملاحظات وملخصات المكالمات. تضمين بيانات جهة الاتصال بيضيف اسم العميل ورقم التليفون وemail. الاتنين بيكونوا مقفولين في الأول. وبرضه هيوصلك كل event من غيرهم، ومعاه contact ID بدل التفاصيل. بس مالك الـ workspace أو الأدمن يقدر يفعّلهم، وفعّلهم بس لو الأداة المستقبلة مسموح لها تخزن بيانات العملاء. في الـ workspace اللي عليه HIPAA، بيانات العملاء عمرها ما بتتبعت، مهما كانت إعدادات الزرارين.

الأدوات والمطوّرين يقدروا يسجّلوا webhooks خاصة بيهم من خلال الـ API بتاع Entagl، وبتظهر تحت التطبيقات المتصلة لوحدها. لكل واحد منهم هتشوف كام event بيسمع له وآخر مرة استقبل event إمتى. تقدر تفتح التسليمات الأخيرة، أو إيقاف مؤقت واستئناف، أو إزالة. الـ Make scenarios ليها صفحة خاصة بيها: القنوات → Make.

اضغط التسليمات الأخيرة علشان تشوف آخر 50 event Entagl حاولت تبعتهم، الأحدث الأول. كل واحدة بتوضح إذا وصلت ولا لأ، والرد اللي الأداة بتاعتك رجعته (زي 200 أو 500)، كام محاولة خدوا، وإمتى المحاولة الجاية. لما delivery تفشل نهائيًا، صلّح المشكلة من عندك واضغط ابعت تاني. Entagl هتبعتها خلال كام ثانية.

لو الأداة بتاعتك واقفة أو بترجع error، Entagl بتحاول تاني بعد 30 ثانية، دقيقتين، 10 دقايق، ساعة، 6 ساعات و24 ساعة. يعني حوالي 31 ساعة قبل ما الـ delivery تتعلّم إنها فشلت. لو تطبيق متصل فضل بيفشل 3 أيام ورا بعض، Entagl بتوقّفه وبتبعت إشعار لمالك الـ workspace. صلّح الأداة، وبعدها اضغط استئناف. لو Make بلّغ إن webhook بتاع scenario ما بقاش موجود، Entagl بتبطل تبعتله فورًا.

كل request بتكون معاها signature في الهيدر X-Entagl-Signature، معمول بـ signing secret بتاعك. المطوّر بيستخدمه علشان يثبت إن الـ request جاي من Entagl وإن محدّش عدّل فيه في الطريق.

• Connected apps والـ webhooks اللي اتعملت من خلال الـ API بتبعت t=1767225600,v1=5257a869…. الجزء t هو وقت الإرسال بالثواني. كل v1 هو HMAC-SHA256 للنص timestamp.body (قيمة t، نقطة، وبعدها raw request body)، معمول بالـ secret بتاعك. ارفض أي request قيمة t بتاعتها أقدم من 5 دقايق، عشان request قديم مايتعادش تشغيله. بعد تغيير الـ secret مباشرة ممكن تشوف قيمتين v1: اقبل الـ request لو أي واحدة فيهم مطابقة.
• الـ webhook اللي ظبطته في الصفحة دي بيبعت sha256= وبعدها HMAC-SHA256 للـ raw request body.