أضف عنوان https من التكاملات ← Webhooks والإشعارات لتلقّي أحداث المكالمات:
| الحدث | متى |
|---|---|
call.started | ردّ الوكيل |
call.ended | انتهت المكالمة، مع مدتها ورصيدها |
call.analyzed | جاهزية الملخص والنتيجة والحقول المستخرجة والنص المفرَّغ |
call.transcript | أثناء المكالمة، أسطر النص المفرَّغ الجديدة كل بضع ثوان |
call.tool_called | استدعى الوكيل إحدى دوالك: name وarguments وstatus وdurationMs |
call.handed_off | سُلِّمت المكالمة إلى وكيل آخر: fromAgentId وtoAgentId |
call.transferred | حُوِّلت المكالمة إلى شخص: destination |
call.voicemail | وصلت مكالمة صادرة إلى بريد صوتي |
call.do_not_call | طلب الشخص في مكالمة صادرة ألّا يُتصل به مجددًا: phone |
call.recording_ready | خُزِّن التسجيل ثنائي القناة: recordingUrl (صالح 24 ساعة) وdurationMs |
call.message_sent | عرض الوكيل بطاقات على شاشة متصل عبر الويب أو التطبيق: items وquickReplies |
alert.triggered | تجاوز أحد تنبيهاتك (Webhooks والإشعارات ← التنبيهات) عتبته |
alert.resolved | عاد ذلك التنبيه إلى الوضع الطبيعي |
تحمل الأحداث المرسلة أثناء المكالمة data.call (id وagentId وchannel وdirection والأرقام). وكل طلب موقَّع:
EvaSay-Signature: t=<unix seconds>,v1=<hex HMAC-SHA256 of "<t>.<raw body>">
EvaSay-Delivery: <delivery id>
تحقق من التوقيع بسرّ الـWebhook الذي عُرض عند إنشائه، وردّ بحالة 2xx. تُعاد محاولة عمليات التسليم الفاشلة بعد دقيقة و5 دقائق و30 دقيقة وساعتين و12 ساعة بالمحتوى نفسه ومعرّف EvaSay-Delivery نفسه، فيمكنك تجاهل التكرارات. وتُعرض آخر عمليات تسليم الـWebhook، بالمحتوى الذي أُرسل بالضبط وبالحالة التي ردّت بها نقطة نهايتك، عبر GET /webhooks/{id}/deliveries وفي لوحة التحكم؛ ويعيد POST /webhooks/{id}/deliveries/{delivery_id} إرسال إحداها.
وإلى جانب البريد الإلكتروني وWebhooks من نوع alert.triggered / alert.resolved، يمكن أن تذهب التنبيهات إلى قناة Slack (incoming webhook) أو روبوت مجموعة WeCom أو Telegram من Webhooks والإشعارات ← التنبيهات ← الإرسال أيضًا إلى.
أنشئ Webhook عبر POST /webhooks مع { "url": "https://crm.example.com/evasay-events", "events": ["call.analyzed"] }. يحتوي الرد على الاشتراك وسرّ توقيع مولَّد، لا يُعاد إلا عند الإنشاء. تحقق من EvaSay-Signature، وأزل تكرار EvaSay-Delivery، وحدّث CRM لديك. إن Webhooks الأحداث إشعارات غير متزامنة؛ أما الأدوات أثناء المكالمة فتُرجع نتائجها مباشرة إلى الوكيل.