تشرح هذه المقالة كيف تجعل HueChat يدفع الأحداث إلى خادمك، ليتفاعل نظام CRM أو أداة التذاكر أو الأتمتة لديك لحظة وصول الرسالة. Webhooks متضمنة بدءًا من خطة Growth.
لدى HueChat نظامان لـ Webhooks:
/api/v2/accounts/{account_id}/outbound-webhooks. يحمل كل تسليم توقيع HMAC-SHA256 ومعرّف تسليم وطابعًا زمنيًا، ويُعاد إرسال عمليات التسليم الفاشلة.message_created ولا تحمل ترويسة توقيع. لا تزال تعمل، لكن استخدم الاشتراكات الموقّعة لأي شيء جديد.webhooks:write، أو استخدم رمز الوصول الشخصي.POST إلى /api/v2/accounts/{account_id}/outbound-webhooks مع name ورابط url بروتوكول HTTPS الخاص بك وقائمة events التي تريدها.secret من الرد. يُعرض مرة واحدة وتحتاجه للتحقق من عمليات التسليم.webhook.test وتأكد من أن خادمك يرد بـ 200.أمثلة الطلبات والردود الكاملة متاحة في مركز المطورين على https://developers.huechat.ai.
| الحدث | يُطلق عند |
|---|---|
message.created |
إرسال رسالة أو استلامها |
message.delivered، message.read، message.failed |
تأكيد القناة للتسليم أو القراءة أو الفشل |
conversation.created |
بدء محادثة جديدة |
conversation.status_changed |
تغيّر الحالة بين مفتوحة أو معلقة أو محلولة |
conversation.assigned، agent.assigned |
إسناد محادثة إلى وكيل أو فريق |
contact.created، contact.updated |
إضافة جهة اتصال أو تغييرها |
automation.triggered |
تشغيل قاعدة أتمتة |
sla.breached |
خرق سياسة اتفاقية مستوى الخدمة (SLA) |
كل تسليم هو طلب POST بصيغة JSON مع الترويسات X-HueChat-Event وX-HueChat-Delivery وX-HueChat-Timestamp وX-HueChat-Signature. يحتوي الجسم على اسم الحدث وطابع زمني وaccount_id الخاص بك وكائن data يتضمن الرسالة أو المحادثة أو جهة الاتصال.
تحقق دائمًا قبل التصرف بناءً على أي تسليم. يمكن لأي شخص يعثر على رابطك أن يرسل إليه؛ لكن HueChat وحده يستطيع التوقيع بسرّك.
sha256=<hex digest> مع الترويسة X-HueChat-Signature باستخدام مقارنة ثابتة الزمن.X-HueChat-Timestamp فيها بضع دقائق.عيّنات الكود لـ Node.js وPython وGo متاحة في مركز المطورين.
200 خلال ثوانٍ قليلة ونفّذ العمل الفعلي في مهمة خلفية.PATCH.X-HueChat-Delivery لتجاهل التكرارات، لأن إعادة المحاولات قد تسلّم الحدث نفسه مرتين.تعرض نقطة سجل التسليم كل محاولة مع حالتها ورد خادمك، وتصدر نقطة إعادة توليد السر سرًا جديدًا عندما تحتاج إلى تبديله.
لقطة شاشة: صفحة Webhooks في الإعدادات مع اشتراك موجود وزر إضافة Webhook.