நிகழ்வுகள் பட்டியல்

ஒவ்வொரு webhook உடலிலும் type புலம் இருக்கும்; அதன் மதிப்பு இந்தப் பக்கத்தில் உள்ள நிகழ்வு வகைகளில் ஒன்றாகும். நீங்கள் ஒரு இறுதிப்புள்ளிக்கு சந்தா செலுத்தும்போது, events வரிசையில் நீங்கள் விரும்பும் நிகழ்வு வகைகள் இருக்க வேண்டும் (அல்லது அனைத்திற்கும் சந்தா செலுத்த அதை காலியாக விடலாம்).

இந்த நிகழ்வுகள் இரண்டு விநியோக முறைகளில் அனுப்பப்படுகின்றன:

• இறுதிப்புள்ளி விநியோகங்கள் எப்போதும் மீண்டும் முயற்சிகளுடன் கூடிய தடையற்ற அறிவிப்புகளாகும்: எந்த 2xx பதிலையும் அளிக்கவும்; உறையில் நகல்களை நீக்குவதற்கான event_id இருக்கும்.
• தடுக்கும் பரிமாற்றங்கள் மரபு ஒற்றை-URL webhook இல் மட்டுமே இயங்கும்: telephony.incoming / web.incoming உள்ளமைவு கோரிக்கை (webhook-முறை எண்கள் மற்றும் widget விசைகள், 10 s நேரமுடிவு) மற்றும் webhook-முறை கருவி அனுப்புதல். உங்கள் பதில் நேரடி அழைப்பை வடிவமைக்கிறது.

கீழேயுள்ள எடுத்துக்காட்டு payload-கள் இறுதிப்புள்ளி உறையை அதன் அனுப்பும் வரிசையில் (விசைகள் அகரவரிசைப்படி வரிசைப்படுத்தப்பட்டுள்ளன: data, event_id, type) காட்டுகின்றன; மரபு விநியோகங்களில் event_id இல்லாமல் அதே data இருக்கும்.

அழைப்பு நிகழ்வுகள்

telephony.incoming

உள்வரும் அழைப்பு உங்கள் தொலைபேசி எண்களில் ஒன்றை அடையும்போது அனுப்பப்படும். Endpoint விநியோகங்கள், ஏஜென்ட்-கட்டமைக்கப்பட்டதா அல்லது webhook-கட்டமைக்கப்பட்டதா என்பதைக் கருத்தில் கொள்ளாமல், ஒவ்வொரு உள்வரும் அழைப்பிற்கும் அனுப்பப்படும் பதிலுக்காகக் காத்திருக்காத அறிவிப்புகளாகும். ஒதுக்கப்பட்ட ஏஜென்ட் இல்லாத எண்கள், மரபுவழி webhook-இல் கூடுதலாக தடுக்கும் கட்டமைப்பு கோரிக்கையைப் பெறும் — முழுமையான கோரிக்கை / பதில் schema-விற்கு telephony.incoming / web.incoming ஐப் பார்க்கவும்.

{
  "data": {
    "call_id": 987654321,
    "from_number": "+14155550199",
    "to_number": "+15551234567"
  },
  "event_id": "3f6b2ad0-1c9e-4a57-9f2b-8f6f0f9d2f11",
  "type": "telephony.incoming"
}

telephony.complete

உள்வரும் அல்லது வெளிச்செல்லும் தொலைபேசி அழைப்பு முடிவடையும்போது அனுப்பப்படும். தடுப்பற்றது. உரையாடல் பதிவு, கிடைக்கும்போது பதிவு URL மற்றும் பில்லிங் சுருக்கம் ஆகியவை இதில் அடங்கும். Payload schema-விற்கு telephony.complete / web.complete ஐப் பார்க்கவும்.

telephony.tool

ஒரு தொலைபேசி அழைப்பு செயல்பாட்டு கருவியை அழைத்த பிறகு அனுப்பப்படும். தடுப்பற்ற தணிக்கை அறிவிப்பு — இந்த நிகழ்வு வழங்கப்படும்போது கருவி ஏற்கனவே செயல்படுத்தப்பட்டிருக்கும்; இது உங்கள் சொந்த செயல்பாட்டு கருவிகளை மட்டுமே உள்ளடக்கும் (உள்ளமைக்கப்பட்ட, அறிவுத் தளம், app-connection அல்லது MCP கருவிகள் அல்ல).

{
  "data": {
    "arguments": { "date": "2026-04-21" },
    "call_id": 987654321,
    "from_number": "+14155550199",
    "response": {
      "response": { "available_slots": ["9:00 AM", "2:00 PM"] },
      "status": 200
    },
    "to_number": "+15551234567",
    "tool_name": "search_appointments"
  },
  "event_id": "1f0a7c3e-52d4-4a0e-8f4b-b1a6a1c0d9e2",
  "type": "telephony.tool"
}

response என்பது செயல்படுத்தப்பட்ட முடிவாகும்: வெற்றியின்போது {"status": <http status>, "response": <your endpoint's JSON>}, அல்லது தோல்வியின்போது {"status": <status>, "error": "<message>"}.

web.incoming

telephony.incoming-இன் web-channel இணையானது; ஒரு web widget அமர்வு அல்லது builder mic சோதனை அழைப்பு தொடங்கும்போது அனுப்பப்படும். Endpoint விநியோகங்கள் ஒவ்வொரு web அமர்விற்கும் பதிலுக்காகக் காத்திருக்காதவையாகும். mode="webhook"-இல் உள்ள வெளியிடக்கூடிய விசைகள், மரபுவழி webhook-இல் கூடுதலாக தடுக்கும் கட்டமைப்பு கோரிக்கையைப் பெறும் — அந்தத் தடுக்கும் கோரிக்கையின் வடிவம் வேறுபட்டது (origin_domain, publishable_key_prefix; தொலைபேசி எண்கள் இல்லை). பார்க்கவும் telephony.incoming / web.incoming.

{
  "data": {
    "call_id": 987654322,
    "from_number": "web",
    "origin_domain": "https://example.com",
    "publishable_key_prefix": "pk_live_a1b2",
    "to_number": "+15551234567"
  },
  "event_id": "9a2b4c6d-8e0f-4a1b-9c2d-3e4f5a6b7c8d",
  "type": "web.incoming"
}

from_number எப்போதும் "web" என்ற எழுத்து மதிப்பாக இருக்கும். Webhook-mode widget அமர்வுகளுக்கு to_number காலியாக இருக்கும் (அமர்வின் ஏஜென்ட் எண் கட்டமைப்பிற்குப் பிறகு ஒதுக்கப்படும்); builder mic சோதனை அழைப்புகளுக்கு origin_domain மற்றும் publishable_key_prefix காலியாக இருக்கும்.

web.complete

telephony.complete-இன் web-channel இணையானது; web widget அழைப்புகள் (direction: "web") மற்றும் builder mic சோதனை அழைப்புகள் (direction: "test") ஆகியவற்றை உள்ளடக்கும். தடுப்பற்றது. இதன் payload வடிவம் telephony.complete போலவே இருக்கும்; கூடுதலாக origin_domain இடம்பெறும், மேலும் from_number "web" என அமைக்கப்படும்.

web.tool

telephony.tool-இன் web-channel இணையானது. data-வில் from_number / to_number என்பவற்றிற்குப் பதிலாக origin_domain இருக்கும்.

குரல் நிகழ்வுகள்

தனிப்பயன் குரல் உருவாக்கம் ஒத்திசைவற்றது. இந்தத் தடைசெய்யாத நிகழ்வுகள், குளோன் விவர எண்ட்பாயிண்டை மீண்டும் மீண்டும் கேள்வியிடுவதற்குப் பதிலாக இறுதி முடிவுக்கு நீங்கள் எதிர்வினையாற்ற அனுமதிக்கின்றன.

voice.ready

தனிப்பயன் குரல் செயலாக்கத்தை முடித்து, ஏஜென்டுக்கு ஒதுக்கப்படத் தயாராகும்போது அனுப்பப்படும்.

{
  "data": {
    "voice": {
      "created_at": "2026-07-30T14:12:08.317Z",
      "display_name": "Support voice",
      "failure_reason": "",
      "gender": "female",
      "id": "cv_2f6f90b0e9a34ee8b39be7d1",
      "language": "en",
      "name": "custom:cv_2f6f90b0e9a34ee8b39be7d1",
      "status": "ready",
      "updated_at": "2026-07-30T14:13:31.605Z"
    }
  },
  "event_id": "2d5f0a61-e9b5-4a3c-b684-29d7d9e4b214",
  "type": "voice.ready"
}

voice.failed

தனிப்பயன் குரல் செயலாக்கம் நிரந்தரத் தோல்வியை அடையும்போது அனுப்பப்படும்.

{
  "data": {
    "reason": "audio sample could not be processed",
    "voice": {
      "created_at": "2026-07-30T14:12:08.317Z",
      "display_name": "Support voice",
      "failure_reason": "audio sample could not be processed",
      "gender": "female",
      "id": "cv_2f6f90b0e9a34ee8b39be7d1",
      "language": "en",
      "name": "custom:cv_2f6f90b0e9a34ee8b39be7d1",
      "status": "failed",
      "updated_at": "2026-07-30T14:13:31.605Z"
    }
  },
  "event_id": "3493e985-1a75-4f77-a10a-e74af440cd31",
  "type": "voice.failed"
}

தர நிகழ்வுகள்

call.graded

ஒரு அழைப்பிற்கான AI தரமதிப்பீட்டு இயக்கம் முடிவடையும் போதெல்லாம் அனுப்பப்படும். செயல்பாட்டைத் தடுக்காது.

{
  "data": {
    "call_id": 987654321,
    "grade": {
      "call_outcome": "success",
      "created_at": "2026-04-20T18:25:11.002Z",
      "detected_issues": [],
      "graded_at": "2026-04-20T18:25:11.002Z",
      "grader_model": "heuristic-v1",
      "id": 5512,
      "score": 92,
      "status": "completed",
      "summary": "Caller asked about their policy and got a full answer…"
    }
  },
  "event_id": "7c1d2e3f-4a5b-4c6d-8e9f-0a1b2c3d4e5f",
  "type": "call.graded"
}

issue.reported

ஒரு சிக்கல் அறிக்கை உருவாக்கப்படும்போது அனுப்பப்படும் — டாஷ்போர்டிலிருந்து பயனரால் பதிவு செய்யப்பட்டதாகவோ (source: "user") அல்லது அழைப்பு தரமதிப்பீட்டால் தானாகவோ (source: "system"). செயல்பாட்டைத் தடுக்காது.

{
  "data": {
    "call_id": 987654321,
    "issue_report": {
      "created_at": "2026-04-20T18:25:11.002Z",
      "description": "Five-second silence before responding to the main question.",
      "id": 4321,
      "severity": "warning",
      "source": "system",
      "status": "open",
      "title": "Agent paused too long"
    }
  },
  "event_id": "5e6f7a8b-9c0d-4e1f-8a2b-3c4d5e6f7a8b",
  "type": "issue.reported"
}

சோதனை அழைப்பு நிகழ்வுகள்

test-call.completed

ஒரு சோதனை அழைப்பு இயக்கம் completed அல்லது failed என்ற இறுதி நிலையை அடையும்போது அனுப்பப்படும்; இதில் தொடக்கத்தில் தோல்வியடைந்து அழைப்பை ஒருபோதும் உருவாக்காத இயக்கங்களும் அடங்கும். செயல்பாட்டைத் தடுக்காது. தொகுதி CI இயக்கங்களை உங்கள் அரட்டை/அறிவிப்பு அமைப்புகளுடன் இணைக்கப் பயனுள்ளது.

{
  "data": {
    "test_call_run": {
      "call_id": 987654321,
      "completed_at": "2026-04-20T18:25:04.822Z",
      "error_message": "",
      "id": 7110,
      "status": "completed",
      "target_id": 12,
      "target_type": "agent"
    }
  },
  "event_id": "2b3c4d5e-6f7a-4b8c-9d0e-1f2a3b4c5d6e",
  "type": "test-call.completed"
}

எச்சரிக்கை நிகழ்வுகள்

alert.triggered

உருவாக்குநர் வெப்ஹூக்குகளுக்கு அனுப்பு சேனல் இயக்கப்பட்டுள்ள எச்சரிக்கை விதி, அதன் வரம்பைக் கடக்கும்போது அனுப்பப்படும். தடை செய்யாதது. ஒரு விதி ஒருமுறை செயல்பட்டு, பின்னர் அதன் குளிர்வுக் காலத்தைப் பின்பற்றும்; எனவே தொடர்ச்சியான மீறல் ஒவ்வொரு குளிர்வுக் காலச் சாளரத்திற்கும் ஒரு நிகழ்வை உருவாக்கும்.

{
  "data": {
    "comparator": "lt",
    "event_id": "b8e6a1d4-2c3f-4a5b-9c8d-7e6f5a4b3c2d",
    "fired_at": "2026-04-20T18:00:00+00:00",
    "metric": "success_rate",
    "metric_value": 71.4,
    "rule_id": "d2c3b4a5-6f7e-4d8c-9b0a-1c2d3e4f5a6b",
    "rule_name": "Success rate below 80%",
    "threshold": 80.0,
    "window_hours": 24
  },
  "event_id": "4d5e6f7a-8b9c-4d0e-9f1a-2b3c4d5e6f7a",
  "type": "alert.triggered"
}

விதிகள், அளவீடுகள், குளிர்வுக் காலங்கள் மற்றும் மின்னஞ்சல் / Slack சேனல்களை உருவாக்க எச்சரிக்கைகள் வழிகாட்டியை பார்க்கவும்.

தொடர்புடையவை