הוסיפו כתובת 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} שולח אחת מחדש.
מלבד דוא"ל והווב-הוקים 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 של אירועים הם התראות אסינכרוניות; כלים במהלך שיחה מחזירים תוצאות ישירות לסוכן.