---
title: "ಈವೆಂಟ್‌ಗಳ ಕ್ಯಾಟಲಾಗ್"
description: "ThunderPhone ಹೊರಸೂಸುವ ಎಲ್ಲಾ ವೆಬ್‌ಹುಕ್ ಈವೆಂಟ್ ಪ್ರಕಾರಗಳು."
---

ಪ್ರತಿ ವೆಬ್‌ಹುಕ್ ಬಾಡಿಯಲ್ಲಿ `type` ಕ್ಷೇತ್ರವಿದ್ದು, ಅದರ ಮೌಲ್ಯವು ಈ ಪುಟದಲ್ಲಿರುವ ಈವೆಂಟ್
ಪ್ರಕಾರಗಳಲ್ಲಿ ಒಂದಾಗಿರುತ್ತದೆ. ನೀವು ಒಂದು
[ಎಂಡ್‌ಪಾಯಿಂಟ್‌ಗೆ](/kn/webhooks/endpoints) ಚಂದಾದಾರರಾದಾಗ, `events` ಅರೇಯಲ್ಲಿ
ನಿಮಗೆ ಬೇಕಾದ ಈವೆಂಟ್ ಪ್ರಕಾರಗಳು ಇರಬೇಕು (ಅಥವಾ ಎಲ್ಲದಕ್ಕೂ ಚಂದಾದಾರರಾಗಲು ಅದು ಖಾಲಿಯಾಗಿರಬೇಕು —
ಪ್ರತಿ-ತಿರುವಿನ ಈವೆಂಟ್‌ಗಳಾದ [`telephony.turn`](#telephony-turn) /
[`web.turn`](#web-turn) ಹೊರತುಪಡಿಸಿ; ಇವುಗಳನ್ನು ಸ್ಪಷ್ಟವಾಗಿ ಹೆಸರಿಸುವ
ಎಂಡ್‌ಪಾಯಿಂಟ್‌ಗಳಿಗೆ ಮಾತ್ರ ತಲುಪಿಸಲಾಗುತ್ತದೆ).

ಈ ಈವೆಂಟ್‌ಗಳನ್ನು ಎರಡು ವಿತರಣಾ ಶೈಲಿಗಳು ಸಾಗಿಸುತ್ತವೆ:

* **ಎಂಡ್‌ಪಾಯಿಂಟ್ ವಿತರಣೆಗಳು** ಯಾವಾಗಲೂ [ಮರುಪ್ರಯತ್ನಗಳೊಂದಿಗೆ](/kn/webhooks/overview) **ತಡೆಯಿಲ್ಲದ**
  ಅಧಿಸೂಚನೆಗಳಾಗಿರುತ್ತವೆ: ಯಾವುದೇ 2xx ಮೂಲಕ ಪ್ರತಿಕ್ರಿಯಿಸಿ; ನಕಲುಗಳನ್ನು ತೆಗೆದುಹಾಕಲು
  ಎನ್ವಲಪ್‌ನಲ್ಲಿ `event_id` ಇರುತ್ತದೆ.
* **ತಡೆಯುವ** ವಿನಿಮಯಗಳು [ಹಿಂದಿನ ಏಕ-URL ವೆಬ್‌ಹುಕ್‌ನಲ್ಲಿ](/kn/webhooks/overview) ಮಾತ್ರ ನಡೆಯುತ್ತವೆ:
  [`telephony.incoming` / `web.incoming`](/kn/webhooks/call-incoming)
  ಕಾನ್ಫಿಗರೇಶನ್ ವಿನಂತಿ (ವೆಬ್‌ಹುಕ್-ಮೋಡ್ ಸಂಖ್ಯೆಗಳು ಮತ್ತು ವಿಜೆಟ್ ಕೀಗಳು, 10 ಸೆಕೆಂಡುಗಳ
  ಸಮಯಮಿತಿ) ಮತ್ತು ವೆಬ್‌ಹುಕ್-ಮೋಡ್
  [ಟೂಲ್ ರವಾನೆ](/kn/tools/overview). ನಿಮ್ಮ ಪ್ರತಿಕ್ರಿಯೆಯು
  ನಡೆಯುತ್ತಿರುವ ಕರೆಯನ್ನು ರೂಪಿಸುತ್ತದೆ.

ಕೆಳಗಿನ ಉದಾಹರಣೆ ಪೇಲೋಡ್‌ಗಳು ಎಂಡ್‌ಪಾಯಿಂಟ್ ಎನ್ವಲಪ್ ಅನ್ನು ಅದರ ಸಾಗಣೆ ಕ್ರಮದಲ್ಲಿ
ತೋರಿಸುತ್ತವೆ (ಕೀಗಳನ್ನು ಅಕಾರಾದಿಯಾಗಿ ವಿಂಗಡಿಸಲಾಗಿದೆ: `data`, `event_id`, `type`);
ಹಿಂದಿನ ವಿತರಣೆಗಳು `event_id` ಇಲ್ಲದೆ ಅದೇ `data` ಅನ್ನು ಹೊಂದಿರುತ್ತವೆ.

## ಕರೆ ಈವೆಂಟ್‌ಗಳು

### `telephony.incoming`

ಒಳಬರುವ ಕರೆ ನಿಮ್ಮ [ಫೋನ್ ಸಂಖ್ಯೆಗಳಲ್ಲಿ](/api-reference/phone-numbers) ಒಂದನ್ನು ತಲುಪಿದಾಗ ಕಳುಹಿಸಲಾಗುತ್ತದೆ. ಎಂಡ್‌ಪಾಯಿಂಟ್ ವಿತರಣೆಗಳು ಏಜೆಂಟ್-ಕಾನ್ಫಿಗರ್ ಮಾಡಲಾಗಿದೆಯೇ ಅಥವಾ ವೆಬ್‌ಹುಕ್-ಕಾನ್ಫಿಗರ್ ಮಾಡಲಾಗಿದೆಯೇ ಎಂಬುದನ್ನು ಲೆಕ್ಕಿಸದೆ **ಪ್ರತಿಯೊಂದು** ಒಳಬರುವ ಕರೆಗೆ ಕಳುಹಿಸಲಾಗುವ ಪ್ರತಿಕ್ರಿಯೆ-ಕಾಯದ ಅಧಿಸೂಚನೆಗಳಾಗಿವೆ. ನಿಯೋಜಿತ ಏಜೆಂಟ್ ಇಲ್ಲದ ಸಂಖ್ಯೆಗಳು ಲೆಗಸಿ ವೆಬ್‌ಹುಕ್‌ನಲ್ಲಿ ಹೆಚ್ಚುವರಿಯಾಗಿ **ತಡೆಯುವ** ಕಾನ್ಫಿಗರೇಶನ್ ವಿನಂತಿಯನ್ನು ಪಡೆಯುತ್ತವೆ — ಸಂಪೂರ್ಣ ವಿನಂತಿ / ಪ್ರತಿಕ್ರಿಯೆ ಸ್ಕೀಮಾಗಾಗಿ [`telephony.incoming` / `web.incoming`](/kn/webhooks/call-incoming) ನೋಡಿ.

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

| ಕ್ಷೇತ್ರ | ವಿಧ | ವಿವರಣೆ |
|-------|------|-------------|
| `agent_id` | ಪೂರ್ಣಾಂಕ \| ಶೂನ್ಯ | ಏಜೆಂಟ್ ನಿಯೋಜಿಸಲ್ಪಟ್ಟಿದ್ದರೆ, ಕರೆಯನ್ನು ನಿರ್ವಹಿಸಿದ ಏಜೆಂಟ್ |
| `agent_name` | ಸ್ಟ್ರಿಂಗ್ \| ಶೂನ್ಯ | ಏಜೆಂಟ್ ನಿಯೋಜಿಸಲ್ಪಟ್ಟಿದ್ದರೆ, ಕರೆಯನ್ನು ನಿರ್ವಹಿಸಿದ ಏಜೆಂಟ್ |

### `telephony.complete`

ಒಳಬರುವ ಅಥವಾ ಹೊರಹೋಗುವ ಟೆಲಿಫೋನಿ ಕರೆ ಕೊನೆಗೊಂಡಾಗ ಕಳುಹಿಸಲಾಗುತ್ತದೆ. ತಡೆಯುವುದಿಲ್ಲ. ಟ್ರಾನ್ಸ್‌ಕ್ರಿಪ್ಟ್, ಲಭ್ಯವಿದ್ದಾಗ ರೆಕಾರ್ಡಿಂಗ್ URL, ಮತ್ತು ಬಿಲ್ಲಿಂಗ್ ಸಾರಾಂಶವನ್ನು ಒಳಗೊಂಡಿರುತ್ತದೆ. ಪೇಲೋಡ್ ಸ್ಕೀಮಾಗಾಗಿ [`telephony.complete` / `web.complete`](/kn/webhooks/call-complete) ನೋಡಿ.

| ಕ್ಷೇತ್ರ | ವಿಧ | ವಿವರಣೆ |
|-------|------|-------------|
| `agent_id` | ಪೂರ್ಣಾಂಕ \| ಶೂನ್ಯ | ಏಜೆಂಟ್ ನಿಯೋಜಿಸಲ್ಪಟ್ಟಿದ್ದರೆ, ಕರೆಯನ್ನು ನಿರ್ವಹಿಸಿದ ಏಜೆಂಟ್ |
| `agent_name` | ಸ್ಟ್ರಿಂಗ್ \| ಶೂನ್ಯ | ಏಜೆಂಟ್ ನಿಯೋಜಿಸಲ್ಪಟ್ಟಿದ್ದರೆ, ಕರೆಯನ್ನು ನಿರ್ವಹಿಸಿದ ಏಜೆಂಟ್ |

### `telephony.tool`

ಟೆಲಿಫೋನಿ ಕರೆ [ಫಂಕ್ಷನ್ ಟೂಲ್](/kn/tools/overview) ಅನ್ನು ಆಹ್ವಾನಿಸಿದ ನಂತರ ಕಳುಹಿಸಲಾಗುತ್ತದೆ. ತಡೆಯದ ಆಡಿಟ್ ಅಧಿಸೂಚನೆ — ಈ ಈವೆಂಟ್ ವಿತರಿಸಲ್ಪಡುವ ಹೊತ್ತಿಗೆ ಟೂಲ್ ಈಗಾಗಲೇ ಕಾರ್ಯಗತಗೊಂಡಿರುತ್ತದೆ; ಇದು ನಿಮ್ಮ ಸ್ವಂತ ಫಂಕ್ಷನ್ ಟೂಲ್‌ಗಳನ್ನು ಒಳಗೊಂಡಿರುತ್ತದೆ (ಅಂತರ್ನಿರ್ಮಿತ, ಜ್ಞಾನ-ಆಧಾರ, ಆ್ಯಪ್-ಸಂಪರ್ಕ, ಅಥವಾ MCP ಟೂಲ್‌ಗಳಲ್ಲ).

```json
{
  "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>"}`.

| ಕ್ಷೇತ್ರ | ವಿಧ | ವಿವರಣೆ |
|-------|------|-------------|
| `agent_id` | ಪೂರ್ಣಾಂಕ \| ಶೂನ್ಯ | ಏಜೆಂಟ್ ನಿಯೋಜಿಸಲ್ಪಟ್ಟಿದ್ದರೆ, ಕರೆಯನ್ನು ನಿರ್ವಹಿಸಿದ ಏಜೆಂಟ್ |
| `agent_name` | ಸ್ಟ್ರಿಂಗ್ \| ಶೂನ್ಯ | ಏಜೆಂಟ್ ನಿಯೋಜಿಸಲ್ಪಟ್ಟಿದ್ದರೆ, ಕರೆಯನ್ನು ನಿರ್ವಹಿಸಿದ ಏಜೆಂಟ್ |

### `telephony.turn`

ಟೆಲಿಫೋನಿ ಕರೆ **ಪ್ರಗತಿಯಲ್ಲಿರುವಾಗ**, ಭಾಷಣ ಹೊಂದಿರುವ ಪ್ರತಿಯೊಂದು ಟರ್ನ್ ಸಂಭವಿಸಿದಂತೆ ಒಮ್ಮೆ ಕಳುಹಿಸಲಾಗುತ್ತದೆ — ಏಜೆಂಟ್‌ನ ಮಾತನಾಡಿದ ಪೂರ್ಣಗೊಳಿಕೆಗಳು ಮತ್ತು ಕರೆಮಾಡುವವರ ಟ್ರಾನ್ಸ್‌ಕ್ರೈಬ್ ಮಾಡಿದ ಟರ್ನ್‌ಗಳು. ಪೋಲಿಂಗ್ ಮಾಡುವ ಬದಲು ಸರಳ ವೆಬ್‌ಹುಕ್‌ಗಳ ಮೂಲಕ ಲೈವ್ ಸಂಭಾಷಣೆಯನ್ನು ಅನುಸರಿಸಲು ಇದು ನಿಮಗೆ ಅನುಮತಿಸುತ್ತದೆ
[`GET /v1/calls/{call_id}/transcript`](/api-reference/calls#get-transcript).
ತಡೆಯುವುದಿಲ್ಲ.

<Note>
  **ಸ್ಪಷ್ಟ ಚಂದಾದಾರಿಕೆ ಅಗತ್ಯವಿದೆ.** ಪ್ರತಿಯೊಂದು ಇತರ ಈವೆಂಟ್ ವಿಧಕ್ಕಿಂತ ಭಿನ್ನವಾಗಿ, ಟರ್ನ್ ಈವೆಂಟ್‌ಗಳನ್ನು ಖಾಲಿ `events` ಅರೇ ಮೂಲಕ (ಎಲ್ಲದಕ್ಕೂ-ಚಂದಾದಾರಿಕೆ) ಎಂದಿಗೂ ವಿತರಿಸಲಾಗುವುದಿಲ್ಲ. ಎಂಡ್‌ಪಾಯಿಂಟ್‌ನ `events` ಪಟ್ಟಿಯು `telephony.turn` / `web.turn` ಅನ್ನು ಸ್ಪಷ್ಟವಾಗಿ ಹೊಂದಿದ್ದಾಗ ಮಾತ್ರ ಅದು ಅವುಗಳನ್ನು ಪಡೆಯುತ್ತದೆ.
</Note>

```json
{
  "data": {
    "call_id": 987654321,
    "entry_type": "completion",
    "from_number": "+14155550199",
    "position": 7,
    "role": "assistant",
    "start_ms": 15200,
    "text": "How many employees does your company have?",
    "to_number": "+15551234567"
  },
  "event_id": "8d3f5a2c-7b1e-4c9a-b6d0-2e4f6a8c0d1e",
  "type": "telephony.turn"
}
```

| ಕ್ಷೇತ್ರ | ವಿಧ | ವಿವರಣೆ |
|-------|------|-------------|
| `agent_id` | ಪೂರ್ಣಾಂಕ \| ಶೂನ್ಯ | ಏಜೆಂಟ್ ನಿಯೋಜಿಸಲ್ಪಟ್ಟಿದ್ದರೆ, ಕರೆಯನ್ನು ನಿರ್ವಹಿಸಿದ ಏಜೆಂಟ್ |
| `agent_name` | ಸ್ಟ್ರಿಂಗ್ \| ಶೂನ್ಯ | ಏಜೆಂಟ್ ನಿಯೋಜಿಸಲ್ಪಟ್ಟಿದ್ದರೆ, ಕರೆಯನ್ನು ನಿರ್ವಹಿಸಿದ ಏಜೆಂಟ್ |
| `position` | ಪೂರ್ಣಾಂಕ | ಕರೆ ಇತಿಹಾಸದಲ್ಲಿನ ಟರ್ನ್‌ನ ಸೂಚ್ಯಂಕ — ಕ್ರಮಗೊಳಿಸಲು ಸ್ಥಿರ ಗುರುತು |
| `role` | ಸ್ಟ್ರಿಂಗ್ | `assistant` (ಏಜೆಂಟ್ ಭಾಷಣ) ಅಥವಾ `user` (ಕರೆಮಾಡುವವರ ಭಾಷಣ) |
| `text` | ಸ್ಟ್ರಿಂಗ್ | ಹೊರಸೂಸುವ ಸಮಯದಲ್ಲಿ ತಿಳಿದಿರುವ ಟರ್ನ್‌ನ ಟ್ರಾನ್ಸ್‌ಕ್ರಿಪ್ಟ್ ಪಠ್ಯ |
| `entry_type` | ಸ್ಟ್ರಿಂಗ್ | ಆಧಾರವಾಗಿರುವ ಇತಿಹಾಸ ನಮೂದು ವಿಧ: `completion` (ಏಜೆಂಟ್), ಅಥವಾ `user_turn` / `span` (ಕರೆಮಾಡುವವರು) |
| `start_ms`, `end_ms` | ಪೂರ್ಣಾಂಕ | ಕರೆ ಆರಂಭದಿಂದ ms ಗಳಲ್ಲಿ ಆಡಿಯೊ ಆಫ್‌ಸೆಟ್‌ಗಳು; ಹೊರಸೂಸುವ ಸಮಯದಲ್ಲಿ ಪ್ಲೇಔಟ್ ಸಮಯ ಈಗಾಗಲೇ ತಿಳಿದಿದ್ದಾಗ ಮಾತ್ರ ಇರುತ್ತವೆ |

<Note>
  ವಿತರಣೆಯು ಕನಿಷ್ಠ-ಒಮ್ಮೆಯಾಗಿದೆ ಮತ್ತು ಟರ್ನ್‌ಗಳು **ಕ್ರಮಬಾಹಿರವಾಗಿ** ಬರಬಹುದು:
  ಎನ್ವಲಪ್‌ನ `event_id` ಮೂಲಕ ನಕಲು ತೆಗೆಯಿರಿ ಮತ್ತು `position` ಮೂಲಕ ಕ್ರಮಗೊಳಿಸಿ. ಕರೆಮಾಡುವವರ
  ಟ್ರಾನ್ಸ್‌ಕ್ರಿಪ್ಟ್‌ಗಳು ಹೊರಸೂಸಿದ ನಂತರವೂ ಪರಿಷ್ಕರಿಸಬಹುದು; ಕರೆ-ನಂತರದ
  [`telephony.complete`](/kn/webhooks/call-complete) ಟ್ರಾನ್ಸ್‌ಕ್ರಿಪ್ಟ್
  ಅಧಿಕೃತವಾಗಿದೆ. ಮಾತನಾಡಿದ ಟರ್ನ್‌ಗಳು ಮಾತ್ರ ಹೊರಸೂಸಲ್ಪಡುತ್ತವೆ — ಟೂಲ್ ಕರೆಗಳು, ಪಿಸುಮಾತುಗಳು ಮತ್ತು
  ಇತರ ಆಂತರಿಕ ನಮೂದುಗಳು ಈ ಸ್ಟ್ರೀಮ್‌ನಲ್ಲಿ ಎಂದಿಗೂ ಕಾಣಿಸುವುದಿಲ್ಲ.
</Note>

### `web.incoming`

`telephony.incoming` ನ ವೆಬ್-ಚಾನೆಲ್ ಸಮಾನವಾದುದು; [ವೆಬ್ ವಿಜೆಟ್](/kn/widget/overview) ಸೆಷನ್ ಅಥವಾ ಬಿಲ್ಡರ್ ಮೈಕ್ ಪರೀಕ್ಷಾ ಕರೆ ಪ್ರಾರಂಭವಾದಾಗ ಕಳುಹಿಸಲಾಗುತ್ತದೆ. ಎಂಡ್‌ಪಾಯಿಂಟ್ ವಿತರಣೆಗಳು ಪ್ರತಿಯೊಂದು ವೆಬ್ ಸೆಷನ್‌ಗೆ ಪ್ರತಿಕ್ರಿಯೆ-ಕಾಯದವಾಗಿರುತ್ತವೆ. `mode="webhook"` ನಲ್ಲಿನ ಪ್ರಕಾಶಿಸಬಹುದಾದ ಕೀಗಳು ಲೆಗಸಿ ವೆಬ್‌ಹುಕ್‌ನಲ್ಲಿ ಹೆಚ್ಚುವರಿಯಾಗಿ **ತಡೆಯುವ** ಕಾನ್ಫಿಗರೇಶನ್ ವಿನಂತಿಯನ್ನು ಪಡೆಯುತ್ತವೆ — ಆ ತಡೆಯುವ ವಿನಂತಿಯು ವಿಭಿನ್ನ ಆಕಾರವನ್ನು ಹೊಂದಿರುತ್ತದೆ (`origin_domain`,
`publishable_key_prefix`; ಫೋನ್ ಸಂಖ್ಯೆಗಳಿಲ್ಲ). [`telephony.incoming` / `web.incoming`](/kn/webhooks/call-incoming) ನೋಡಿ.

```json
{
  "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"` ಆಗಿರುತ್ತದೆ. ವೆಬ್‌ಹುಕ್-ಮೋಡ್ ವಿಜೆಟ್ ಸೆಷನ್‌ಗಳಿಗೆ `to_number` ಖಾಲಿಯಾಗಿರುತ್ತದೆ (ಕಾನ್ಫಿಗರೇಶನ್ ನಂತರ ಸೆಷನ್‌ನ ಏಜೆಂಟ್ ಸಂಖ್ಯೆ ನಿಯೋಜಿಸಲಾಗುತ್ತದೆ); ಬಿಲ್ಡರ್ ಮೈಕ್ ಪರೀಕ್ಷಾ ಕರೆಗಳಿಗೆ `origin_domain` ಮತ್ತು `publishable_key_prefix` ಖಾಲಿಯಾಗಿರುತ್ತವೆ.

| ಕ್ಷೇತ್ರ | ವಿಧ | ವಿವರಣೆ |
|-------|------|-------------|
| `agent_id` | ಪೂರ್ಣಾಂಕ \| ಶೂನ್ಯ | ಏಜೆಂಟ್ ನಿಯೋಜಿಸಲ್ಪಟ್ಟಿದ್ದರೆ, ಕರೆಯನ್ನು ನಿರ್ವಹಿಸಿದ ಏಜೆಂಟ್ |
| `agent_name` | ಸ್ಟ್ರಿಂಗ್ \| ಶೂನ್ಯ | ಏಜೆಂಟ್ ನಿಯೋಜಿಸಲ್ಪಟ್ಟಿದ್ದರೆ, ಕರೆಯನ್ನು ನಿರ್ವಹಿಸಿದ ಏಜೆಂಟ್ |

### `web.complete`

`telephony.complete` ನ ವೆಬ್-ಚಾನೆಲ್ ಸಮಾನವಾದುದು; ವೆಬ್ ವಿಜೆಟ್ ಕರೆಗಳು (`direction: "web"`) ಮತ್ತು ಬಿಲ್ಡರ್ ಮೈಕ್ ಪರೀಕ್ಷಾ ಕರೆಗಳನ್ನು (`direction: "test"`) ಒಳಗೊಂಡಿರುತ್ತದೆ. ತಡೆಯುವುದಿಲ್ಲ. [`telephony.complete`](/kn/webhooks/call-complete) ನಂತೆಯೇ ಪೇಲೋಡ್ ಆಕಾರವನ್ನು ಹೊಂದಿದ್ದು, `origin_domain` ಹೆಚ್ಚುವರಿಯಾಗಿರುತ್ತದೆ ಮತ್ತು `from_number` ಅನ್ನು `"web"` ಗೆ ಹೊಂದಿಸಲಾಗಿರುತ್ತದೆ.

| ಕ್ಷೇತ್ರ | ವಿಧ | ವಿವರಣೆ |
|-------|------|-------------|
| `agent_id` | ಪೂರ್ಣಾಂಕ \| ಶೂನ್ಯ | ಏಜೆಂಟ್ ನಿಯೋಜಿಸಲ್ಪಟ್ಟಿದ್ದರೆ, ಕರೆಯನ್ನು ನಿರ್ವಹಿಸಿದ ಏಜೆಂಟ್ |
| `agent_name` | ಸ್ಟ್ರಿಂಗ್ \| ಶೂನ್ಯ | ಏಜೆಂಟ್ ನಿಯೋಜಿಸಲ್ಪಟ್ಟಿದ್ದರೆ, ಕರೆಯನ್ನು ನಿರ್ವಹಿಸಿದ ಏಜೆಂಟ್ |

<Note>
  ಲೆಗಸಿ ಏಕ-URL ವೆಬ್‌ಹುಕ್‌ನಲ್ಲಿ, ಬಿಲ್ಡರ್ ಮೈಕ್ ಪರೀಕ್ಷಾ ಕರೆಗಳು ಐತಿಹಾಸಿಕವಾಗಿ `telephony.complete` ಎಂದು ವರದಿಯಾಗುತ್ತವೆ — ಅಲ್ಲಿ `direction:
  "web"` ಕರೆಗಳು ಮಾತ್ರ `web.complete` ವಿಧವನ್ನು ಬಳಸುತ್ತವೆ. ಎಂಡ್‌ಪಾಯಿಂಟ್ ವ್ಯವಸ್ಥೆಯು ವೆಬ್ ಮತ್ತು ಪರೀಕ್ಷಾ ಕರೆಗಳೆರಡನ್ನೂ `web.*` ಗೆ ಮ್ಯಾಪ್ ಮಾಡುತ್ತದೆ. ಐತಿಹಾಸಿಕ ಪೇಲೋಡ್‌ಗಳು ಲೆಗಸಿ `direction` ಮೌಲ್ಯಗಳಾದ `widget` ಅಥವಾ `mic` ಅನ್ನು ಒಳಗೊಂಡಿರಬಹುದು.
</Note>

### `web.tool`

`telephony.tool` ನ ವೆಬ್-ಚಾನೆಲ್ ಸಮಾನವಾದುದು. `data` ಯು `from_number` / `to_number` ಬದಲಿಗೆ `origin_domain` ಅನ್ನು ಹೊಂದಿರುತ್ತದೆ.

| ಕ್ಷೇತ್ರ | ವಿಧ | ವಿವರಣೆ |
|-------|------|-------------|
| `agent_id` | ಪೂರ್ಣಾಂಕ \| ಶೂನ್ಯ | ಏಜೆಂಟ್ ನಿಯೋಜಿಸಲ್ಪಟ್ಟಿದ್ದರೆ, ಕರೆಯನ್ನು ನಿರ್ವಹಿಸಿದ ಏಜೆಂಟ್ |
| `agent_name` | ಸ್ಟ್ರಿಂಗ್ \| ಶೂನ್ಯ | ಏಜೆಂಟ್ ನಿಯೋಜಿಸಲ್ಪಟ್ಟಿದ್ದರೆ, ಕರೆಯನ್ನು ನಿರ್ವಹಿಸಿದ ಏಜೆಂಟ್ |

### `web.turn`

[`telephony.turn`](#telephony-turn) ನ ವೆಬ್-ಚಾನೆಲ್ ಸಮಾನವಾದುದು; ವೆಬ್ ವಿಜೆಟ್ ಕರೆಗಳು ಮತ್ತು ಬಿಲ್ಡರ್ ಮೈಕ್ ಪರೀಕ್ಷಾ ಕರೆಗಳನ್ನು ಒಳಗೊಂಡಿರುತ್ತದೆ. `from_number` / `to_number` ಬದಲಿಗೆ `origin_domain` ನೊಂದಿಗೆ ಅದೇ ಪೇಲೋಡ್ ಆಕಾರವನ್ನು ಹೊಂದಿರುತ್ತದೆ. `telephony.turn` ನಂತೆ, ಇದಕ್ಕೂ **ಸ್ಪಷ್ಟ ಚಂದಾದಾರಿಕೆ** ಅಗತ್ಯವಿದೆ — ಖಾಲಿ `events` ಅರೇ ಮೂಲಕ ಇದನ್ನು ಎಂದಿಗೂ ವಿತರಿಸಲಾಗುವುದಿಲ್ಲ.

| ಕ್ಷೇತ್ರ | ವಿಧ | ವಿವರಣೆ |
|-------|------|-------------|
| `agent_id` | ಪೂರ್ಣಾಂಕ \| ಶೂನ್ಯ | ಏಜೆಂಟ್ ನಿಯೋಜಿಸಲ್ಪಟ್ಟಿದ್ದರೆ, ಕರೆಯನ್ನು ನಿರ್ವಹಿಸಿದ ಏಜೆಂಟ್ |
| `agent_name` | ಸ್ಟ್ರಿಂಗ್ \| ಶೂನ್ಯ | ಏಜೆಂಟ್ ನಿಯೋಜಿಸಲ್ಪಟ್ಟಿದ್ದರೆ, ಕರೆಯನ್ನು ನಿರ್ವಹಿಸಿದ ಏಜೆಂಟ್ |

---

## ಧ್ವನಿ ಈವೆಂಟ್‌ಗಳು

ಕಸ್ಟಮ್ ಧ್ವನಿ ರಚನೆಯು ಅಸಿಂಕ್ರೋನಸ್ ಆಗಿದೆ. ಈ ನಾನ್-ಬ್ಲಾಕಿಂಗ್ ಈವೆಂಟ್‌ಗಳು
[ಕ್ಲೋನ್ ವಿವರ ಎಂಡ್‌ಪಾಯಿಂಟ್](/api-reference/custom-voices#list-and-retrieve-clones) ಅನ್ನು
ಪೋಲ್ ಮಾಡುವ ಬದಲು ಅಂತಿಮ ಫಲಿತಾಂಶಕ್ಕೆ ಪ್ರತಿಕ್ರಿಯಿಸಲು ನಿಮಗೆ ಅನುಮತಿಸುತ್ತವೆ.

`voice.ready` ಮತ್ತು `voice.failed` ಅನ್ನು `events: []` ಹೊಂದಿರುವ ಸಂಸ್ಥೆಯಾದ್ಯಂತದ
ಎಂಡ್‌ಪಾಯಿಂಟ್‌ಗೆ ಮಾತ್ರ ತಲುಪಿಸಲಾಗುತ್ತದೆ. ಅವುಗಳನ್ನು ಸ್ಪಷ್ಟ ಈವೆಂಟ್ ಫಿಲ್ಟರ್‌ಗಳಾಗಿ ಆಯ್ಕೆ ಮಾಡಲು ಸಾಧ್ಯವಿಲ್ಲ.

### `voice.ready`

ಕಸ್ಟಮ್ ಧ್ವನಿಯ ಪ್ರಕ್ರಿಯೆ ಪೂರ್ಣಗೊಂಡಾಗ ಮತ್ತು ಅದನ್ನು ಏಜೆಂಟ್‌ಗೆ ನಿಯೋಜಿಸಬಹುದಾದಾಗ ಕಳುಹಿಸಲಾಗುತ್ತದೆ.

```json
{
  "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`

ಕಸ್ಟಮ್ ಧ್ವನಿ ಪ್ರಕ್ರಿಯೆಯು ಶಾಶ್ವತ ವೈಫಲ್ಯವನ್ನು ತಲುಪಿದಾಗ ಕಳುಹಿಸಲಾಗುತ್ತದೆ.

```json
{
  "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"
}
```

| ಕ್ಷೇತ್ರ | ಪ್ರಕಾರ | ವಿವರಣೆ |
|-------|------|-------------|
| `voice.id` | ಸ್ಟ್ರಿಂಗ್ | ಕಸ್ಟಮ್ ಧ್ವನಿಯ ಸಾರ್ವಜನಿಕ ID |
| `voice.name` | ಸ್ಟ್ರಿಂಗ್ | `custom:<public_id>` ರೂಪದಲ್ಲಿರುವ ಏಜೆಂಟ್ ಧ್ವನಿ ಮೌಲ್ಯ |
| `voice.display_name` | ಸ್ಟ್ರಿಂಗ್ | ಸಂಸ್ಥೆಗಾಗಿ ಪ್ರದರ್ಶಿಸುವ ಧ್ವನಿ ಹೆಸರು |
| `voice.language` | ಸ್ಟ್ರಿಂಗ್ | ಕ್ಲೋನ್‌ನ ಏಕ ಭಾಷಾ ಕೋಡ್ |
| `voice.gender` | ಸ್ಟ್ರಿಂಗ್ | `male`, `female`, ಅಥವಾ ಖಾಲಿ ಸ್ಟ್ರಿಂಗ್ |
| `voice.status` | ಸ್ಟ್ರಿಂಗ್ | `voice.ready` ಗಾಗಿ `ready`; `voice.failed` ಗಾಗಿ `failed` |
| `voice.failure_reason` | ಸ್ಟ್ರಿಂಗ್ | ಯಶಸ್ಸಿನ ಸಂದರ್ಭದಲ್ಲಿ ಖಾಲಿ; ವೈಫಲ್ಯದ ಸಂದರ್ಭದಲ್ಲಿ ಪ್ರಕ್ರಿಯೆ ವೈಫಲ್ಯದ ವಿವರ |
| `voice.created_at`, `voice.updated_at` | ಟೈಮ್‌ಸ್ಟ್ಯಾಂಪ್ | ISO 8601 ಟೈಮ್‌ಸ್ಟ್ಯಾಂಪ್‌ಗಳು |
| `reason` | ಸ್ಟ್ರಿಂಗ್ | ವೈಫಲ್ಯದ ವಿವರ; `voice.failed` ನಲ್ಲಿ ಮಾತ್ರ ಇರುತ್ತದೆ |

---

## ಗುಣಮಟ್ಟದ ಈವೆಂಟ್‌ಗಳು

### `call.graded`

ಕರೆಗಾಗಿ [AI ಗ್ರೇಡಿಂಗ್ ರನ್](/api-reference/calls#ai-call-grading)
ಪೂರ್ಣಗೊಂಡಾಗಲೆಲ್ಲ ಕಳುಹಿಸಲಾಗುತ್ತದೆ. ತಡೆಯದ.

```json
{
  "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"
}
```

| ಕ್ಷೇತ್ರ | ಪ್ರಕಾರ | ವಿವರಣೆ |
|-------|------|-------------|
| `agent_id` | integer \| null | ನಿಯೋಜಿಸಿದ್ದರೆ, ಕರೆಯನ್ನು ನಿರ್ವಹಿಸಿದ ಏಜೆಂಟ್ |
| `agent_name` | string \| null | ನಿಯೋಜಿಸಿದ್ದರೆ, ಕರೆಯನ್ನು ನಿರ್ವಹಿಸಿದ ಏಜೆಂಟ್ |
| `grade.id` | integer | ಗ್ರೇಡ್ ಐಡಿ |
| `grade.score` | integer \| null | 0–100 |
| `grade.call_outcome` | string | `success`, `failure`, `unknown`, ಅಥವಾ `no_conversation` |
| `grade.summary` | string | ಒಂದು ಪ್ಯಾರಾಗ್ರಾಫ್ ಸಾರಾಂಶ |
| `grade.detected_issues` | array | ಗ್ರೇಡರ್ ಕಂಡುಹಿಡಿದ ಸಮಸ್ಯೆ ಸ್ಟ್ರಿಂಗ್‌ಗಳು |
| `grade.status` | string | ಯಾವಾಗಲೂ `completed` — ಪೂರ್ಣಗೊಂಡ ರನ್‌ಗಳು ಮಾತ್ರ ಹೊರಸೂಸುತ್ತವೆ |
| `grade.grader_model` | string | ಫಲಿತಾಂಶವನ್ನು ನಿರ್ಮಿಸಿದ ಗ್ರೇಡರ್ ಯಾವುದು (ಉದಾ. `heuristic-v1`) |
| `grade.graded_at`, `grade.created_at` | timestamp | |

<Note>
  ಒಂದು ಕರೆಯನ್ನು ಒಂದಕ್ಕಿಂತ ಹೆಚ್ಚು ಬಾರಿ ಗ್ರೇಡ್ ಮಾಡಬಹುದು — ವೇಗದ ಹ್ಯೂರಿಸ್ಟಿಕ್ ಗ್ರೇಡ್‌ನ
  ನಂತರ ರೆಕಾರ್ಡಿಂಗ್ ಲಭ್ಯವಾದಾಗ ಸಾಮಾನ್ಯವಾಗಿ ಪೂರ್ಣ ಮಾದರಿ ಗ್ರೇಡ್ ಬರುತ್ತದೆ ಮತ್ತು
  ಹಸ್ತಚಾಲಿತ ಮರುಗ್ರೇಡಿಂಗ್ ಕೂಡ ಸಾಧ್ಯ. ಪೂರ್ಣಗೊಂಡ ಪ್ರತಿಯೊಂದು ರನ್ ತನ್ನದೇ ಆದ
  `call.graded` ಈವೆಂಟ್ ಅನ್ನು ಹೊರಸೂಸುತ್ತದೆ; ಇತ್ತೀಚಿನ `graded_at` ಅನ್ನು
  ಅಧಿಕೃತವೆಂದು ಪರಿಗಣಿಸಿ.
</Note>

### `call.data_extracted`

ರಚನಾತ್ಮಕ ಡೇಟಾ ಹೊರತೆಗೆಯುವಿಕೆ ಯಶಸ್ವಿಯಾಗಿ ಪೂರ್ಣಗೊಂಡಾಗಲೆಲ್ಲ ಕಳುಹಿಸಲಾಗುತ್ತದೆ, ಇದರಲ್ಲಿ
`telephony.complete` / `web.complete` ನಂತರದ ತಡವಾದ ಮರುಪ್ರಯತ್ನ ಅಥವಾ
[`POST /v1/calls/{call_id}/extract`](/api-reference/calls#run-data-extraction) ಮೂಲಕದ ಹಸ್ತಚಾಲಿತ ಮರುರನ್ ಕೂಡ ಸೇರಿವೆ.
ತಡೆಯದ.

ತಡೆಯುವ ಹೊರತೆಗೆಯುವಿಕೆ ವಿಧಾನದಲ್ಲಿ, ಪೂರ್ಣಗೊಳಿಸುವಿಕೆ ಈವೆಂಟ್ ಸಾಮಾನ್ಯವಾಗಿ 75-ಸೆಕೆಂಡ್
ಹೊರತೆಗೆಯುವಿಕೆ ಮಿತಿಗಿಂತ ಹೆಚ್ಚು ಕಾಯುವುದಿಲ್ಲ. ಹೊರತೆಗೆಯುವಿಕೆ ವರ್ಕರ್ ಪ್ರಕ್ರಿಯೆ
ಕಳೆದುಹೋದರೆ, ಉತ್ಪಾದನಾ ಅಂತಿಮಗೊಳಿಸುವಿಕೆ ಡ್ರೇನ್‌ವು (ಪ್ರತಿ ಐದು ನಿಮಿಷಕ್ಕೆ)
ಮತ್ತೊಂದು ಹೊರತೆಗೆಯುವಿಕೆ ಪ್ರಯತ್ನವನ್ನು ಪ್ರಾರಂಭಿಸುವ ಮೊದಲು `blocking_deadline_at`
ಮೀರಿರುವ ಪೂರ್ಣಗೊಳಿಸುವಿಕೆಯನ್ನು ಬಿಡುಗಡೆ ಮಾಡುತ್ತದೆ. ನಂತರದ ಯಶಸ್ಸನ್ನು ಈ ಈವೆಂಟ್‌ನಂತೆ
ಪ್ರತ್ಯೇಕವಾಗಿ ತಲುಪಿಸಲಾಗುತ್ತದೆ.

<Warning>
  ಹೊರತೆಗೆದ ಮೌಲ್ಯಗಳು ಸಂಭಾಷಣೆಯ ಮಾದರಿಯ ವ್ಯಾಖ್ಯಾನವಾಗಿವೆ. ಪ್ರತಿ ಶೂನ್ಯವಲ್ಲದ
  ಮೌಲ್ಯವು ಅದು ಆಧರಿಸಿದ ಉಲ್ಲೇಖ, ಮಾತನಾಡುವವರ ಪಾತ್ರ ಮತ್ತು ಟರ್ನ್ ಸೂಚ್ಯಂಕವನ್ನು,
  ಜೊತೆಗೆ ರನ್-ಮಟ್ಟದ ಪರಿಶೀಲನೆ ಫ್ಲ್ಯಾಗ್ ಅನ್ನು ಒಳಗೊಂಡಿರುತ್ತದೆ. ಹಣ, ಗುರುತು ಅಥವಾ
  ಪ್ರವೇಶವನ್ನು ಒಳಗೊಂಡ ನಿರ್ಧಾರಗಳ ಮೊದಲು ಫಲಿತಾಂಶವನ್ನು ಪರಿಶೀಲಿಸಿ.
</Warning>

```json
{
  "data": {
    "call_id": 987654321,
    "agent_id": 12,
    "agent_name": "Acme intake",
    "extracted_data": {
      "status": "completed",
      "fields": {
        "customer_name": "Alex Morgan",
        "appointment_date": "2026-04-23"
      },
      "evidence": {
        "customer_name": {
          "quote": "My name is Alex Morgan",
          "speaker_role": "caller",
          "turn_index": 4
        },
        "appointment_date": {
          "quote": "April 23 works for me",
          "speaker_role": "caller",
          "turn_index": 7
        }
      },
      "verification": "verified",
      "field_reasons": {},
      "schema_version": "92850758e231a3c95a..."
    },
    "extracted_at": "2026-04-20T18:25:11.002Z",
    "model": "gemini-2.5-flash"
  },
  "event_id": "4d79ef1d-c2b1-4ed6-85b8-8326bd2895ef",
  "type": "call.data_extracted"
}
```

| ಕ್ಷೇತ್ರ | ಪ್ರಕಾರ | ವಿವರಣೆ |
|-------|------|-------------|
| `agent_id` | integer \| null | ನಿಯೋಜಿಸಿದ್ದರೆ, ಕರೆಯನ್ನು ನಿರ್ವಹಿಸಿದ ಏಜೆಂಟ್ |
| `agent_name` | string \| null | ನಿಯೋಜಿಸಿದ್ದರೆ, ಕರೆಯನ್ನು ನಿರ್ವಹಿಸಿದ ಏಜೆಂಟ್ |
| `extracted_data.status` | string | ಈ ಈವೆಂಟ್‌ಗೆ ಯಾವಾಗಲೂ `completed` |
| `extracted_data.fields` | object | ಕಾನ್ಫಿಗರ್ ಮಾಡಿದ ಹೊರತೆಗೆಯುವಿಕೆ ಕ್ಷೇತ್ರ ಕೀಗಳಿಂದ ಗುರುತಿಸಲಾದ ಮೌಲ್ಯಗಳು; ಲಭ್ಯವಿಲ್ಲದ ಮೌಲ್ಯಗಳು `null` ಆಗಿರುತ್ತವೆ |
| `extracted_data.evidence` | object | ಹೊರತೆಗೆಯುವಿಕೆ ಕ್ಷೇತ್ರದಿಂದ ಗುರುತಿಸಲಾದ ಸಾಕ್ಷ್ಯ. ಶೂನ್ಯವಲ್ಲದ ಮೌಲ್ಯವು ನಿಖರವಾದ ರಚನಾತ್ಮಕವಾಗಿ ಪರಿಶೀಲಿಸಲಾದ ಉಲ್ಲೇಖವನ್ನು (ಗರಿಷ್ಠ 1,000 ಅಕ್ಷರಗಳು), `speaker_role` (`caller` ಅಥವಾ `agent`) ಮತ್ತು `turn_index` ಅನ್ನು ಹೊಂದಿರುತ್ತದೆ; ಮಾದರಿ ಹಿಂತಿರುಗಿಸಿದ ಉದ್ದವಾದ ಉಲ್ಲೇಖಗಳನ್ನು ಮೊಟಕುಗೊಳಿಸುವ ಬದಲು ತಿರಸ್ಕರಿಸಲಾಗುತ್ತದೆ ಮತ್ತು ಅದರ ಕ್ಷೇತ್ರ `null` ಆಗಿರುವಾಗ ಸಾಕ್ಷ್ಯವು `null` ಆಗಿರುತ್ತದೆ |
| `extracted_data.verification` | string | ಪ್ರತಿಯೊಂದು ಅಭ್ಯರ್ಥಿ ಕ್ಷೇತ್ರಕ್ಕೂ ಸ್ವತಂತ್ರ ಸಾಕ್ಷ್ಯ ಪಾಸ್ ನಿಖರವಾಗಿ ಒಂದು ಮಾನ್ಯ ತೀರ್ಪನ್ನು ಹಿಂತಿರುಗಿಸಿದಾಗ ಮಾತ್ರ `verified`. ಪಾಸ್ ವಿಫಲವಾದರೆ, ಸಮಯ ಮೀರಿದರೆ, ಸಾಕಷ್ಟು ಮಿತಿ ಇಲ್ಲದಿದ್ದರೆ, ಅಥವಾ ವಿರೂಪಿತ ಅಥವಾ ಆಂಶಿಕ ಔಟ್‌ಪುಟ್ ಹಿಂತಿರುಗಿಸಿದರೆ `unavailable` ಎಂದರ್ಥ. ಸಂಪೂರ್ಣವಾಗಿ ಲಭ್ಯವಿಲ್ಲದ ಪಾಸ್ ಗ್ರಾಹಕ ಪರಿಶೀಲನೆಗಾಗಿ ರಚನಾತ್ಮಕ ಆಧಾರವಿರುವ ಮೌಲ್ಯಗಳನ್ನು ಉಳಿಸಿಕೊಳ್ಳುತ್ತದೆ. ಆಂಶಿಕ ಔಟ್‌ಪುಟ್‌ಗೆ, ಮಾನ್ಯ ತೀರ್ಪುಗಳನ್ನು ಅನ್ವಯಿಸಲಾಗುತ್ತದೆ ಮತ್ತು ನಿಖರವಾಗಿ ಒಂದು ಮಾನ್ಯ ತೀರ್ಪು ಇಲ್ಲದ ಪ್ರತಿಯೊಂದು ಅಭ್ಯರ್ಥಿಯನ್ನು ಶೂನ್ಯಗೊಳಿಸಲಾಗುತ್ತದೆ |
| `extracted_data.field_reasons` | object | ರಚನಾತ್ಮಕ ಆಧಾರೀಕರಣ ಅಥವಾ ಸ್ವತಂತ್ರ ಪರಿಶೀಲಕದಿಂದ ಶೂನ್ಯಗೊಳಿಸಲಾದ ಕ್ಷೇತ್ರಗಳಿಂದ ಗುರುತಿಸಲಾದ ಕಾರಣಗಳು |
| `extracted_data.schema_version` | string | ಈ ಹೊರತೆಗೆಯುವಿಕೆಗೆ ಬಳಸಲಾದ ನಿಖರ ಕ್ಷೇತ್ರ ಸ್ಕೀಮಾದ ಹ್ಯಾಶ್ |
| `extracted_at` | timestamp | ISO 8601 ಪೂರ್ಣಗೊಳಿಸುವಿಕೆ ಸಮಯ |
| `model` | string | ಹೊರತೆಗೆಯುವಿಕೆಗೆ ಬಳಸಲಾದ ಮಾದರಿ |

### `campaign.completed`

ಅಭಿಯಾನವು `running` ನಿಂದ `completed` ಗೆ ಬದಲಾದಾಗ ಒಮ್ಮೆ ಕಳುಹಿಸಲಾಗುತ್ತದೆ, ಅದರ
ವೇಳಾಪಟ್ಟಿ ಮುಗಿದಿದ್ದರೂ ಅಥವಾ ಎಲ್ಲ ಸಂಪರ್ಕಗಳು ಅಂತಿಮ ಸ್ಥಿತಿಗಳನ್ನು ತಲುಪಿದ್ದರೂ.
ರನ್ನರ್ ಮರುಪ್ರಯತ್ನಗಳು ಮತ್ತೊಂದು ಈವೆಂಟ್ ಅನ್ನು ಹೊರಸೂಸುವುದಿಲ್ಲ. ಈ ಸಂಸ್ಥೆ-ಮಟ್ಟದ
ಜೀವನಚಕ್ರ ಈವೆಂಟ್ ಅನ್ನು ಏಜೆಂಟ್-ವ್ಯಾಪ್ತಿಯ ಎಂಡ್‌ಪಾಯಿಂಟ್‌ಗಳಿಗೆ ಅಲ್ಲದೆ, ಸಂಸ್ಥೆ-ವ್ಯಾಪ್ತಿಯ
ಎಂಡ್‌ಪಾಯಿಂಟ್‌ಗಳಿಗೆ ಮಾತ್ರ ತಲುಪಿಸಲಾಗುತ್ತದೆ. ತಡೆಯದ.

```json
{
  "data": {
    "campaign_id": "3f6b2c9e-2a0d-4c63-b6d6-a708dc98f403",
    "name": "May win-back",
    "agent_id": 12,
    "status": "completed",
    "started_at": "2026-04-20T17:00:00Z",
    "completed_at": "2026-04-20T18:25:11Z",
    "counts": {
      "contacts_total": 150,
      "completed": 121,
      "failed": 11,
      "no_answer": 18,
      "remaining": 0
    }
  },
  "event_id": "8d8f52ce-6b46-423f-9dde-cea0b91ec135",
  "type": "campaign.completed"
}
```

ನಾಲ್ಕು ಫಲಿತಾಂಶ ಎಣಿಕೆಗಳು ಪರಸ್ಪರ ಪ್ರತ್ಯೇಕವಾಗಿದ್ದು `contacts_total` ಗೆ ಸೇರುತ್ತವೆ:
`completed` ಯಶಸ್ವಿ ಸಂಪರ್ಕಗಳನ್ನು ಹೊಂದಿರುತ್ತದೆ; `no_answer` ಅಂತಿಮ ಫಲಿತಾಂಶವು
ಉತ್ತರ ಇಲ್ಲದಿರುವ, ಅಂತಿಮವಾಗಿ ವಿಫಲಗೊಂಡ/ಖಾಲಿಯಾದ ಸಂಪರ್ಕಗಳನ್ನು ಹೊಂದಿರುತ್ತದೆ; `failed`
ಎಲ್ಲ ಇತರ ಅಂತಿಮವಾಗಿ ವಿಫಲಗೊಂಡ/ಖಾಲಿಯಾದ ಸಂಪರ್ಕಗಳನ್ನು ಹೊಂದಿರುತ್ತದೆ; ಮತ್ತು `remaining`
ಬಾಕಿ ಇರುವ, ನಿಗದಿಪಡಿಸಿದ ಅಥವಾ ಪ್ರಸ್ತುತ ಕರೆ ಮಾಡುತ್ತಿರುವ ಸಂಪರ್ಕಗಳನ್ನು ಹೊಂದಿರುತ್ತದೆ.
ಮರುಪ್ರಯತ್ನಕ್ಕಾಗಿ ಕಾಯುತ್ತಿರುವ ಸಂಪರ್ಕವು, ಅದರ ಇತ್ತೀಚಿನ ಪ್ರಯತ್ನಕ್ಕೆ ಉತ್ತರ ಇಲ್ಲದಿದ್ದರೂ,
`remaining` ಆಗಿರುತ್ತದೆ. ಒಮ್ಮೆ-ಮಾತ್ರದ ಪೂರ್ಣಗೊಳಿಸುವಿಕೆ ಸ್ನ್ಯಾಪ್‌ಶಾಟ್‌ಗೂ ಮೊದಲು
ನಡೆಯುತ್ತಿರುವ ಕರೆಗಳನ್ನು ಸಮನ್ವಯಗೊಳಿಸಲಾಗುತ್ತದೆ. `started_at` ಎಂಬುದು ಕಾನ್ಫಿಗರ್ ಮಾಡಿದ
ಅಭಿಯಾನದ ಆರಂಭ, ಅಥವಾ ಯಾವುದೇ ಆರಂಭವನ್ನು ಕಾನ್ಫಿಗರ್ ಮಾಡದಿದ್ದಾಗ ಅಭಿಯಾನ ರಚನೆಯ ಸಮಯ.

### `issue.reported`

[ಸಮಸ್ಯೆ ವರದಿ](/api-reference/issue-reports) ರಚಿಸಲ್ಪಟ್ಟಾಗ ಕಳುಹಿಸಲಾಗುತ್ತದೆ —
ಡ್ಯಾಶ್‌ಬೋರ್ಡ್‌ನಿಂದ ಬಳಕೆದಾರರು ಸಲ್ಲಿಸಿದ್ದರೆ (`source: "user"`) ಅಥವಾ
ಕರೆ ಗ್ರೇಡಿಂಗ್‌ನಿಂದ ಸ್ವಯಂಚಾಲಿತವಾಗಿ ರಚಿಸಲ್ಪಟ್ಟಿದ್ದರೆ (`source: "system"`).
ತಡೆಯದ.

```json
{
  "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"
}
```

| ಕ್ಷೇತ್ರ | ಪ್ರಕಾರ | ವಿವರಣೆ |
|-------|------|-------------|
| `agent_id` | integer \| null | ನಿಯೋಜಿಸಿದ್ದರೆ, ಕರೆಯನ್ನು ನಿರ್ವಹಿಸಿದ ಏಜೆಂಟ್ |
| `agent_name` | string \| null | ನಿಯೋಜಿಸಿದ್ದರೆ, ಕರೆಯನ್ನು ನಿರ್ವಹಿಸಿದ ಏಜೆಂಟ್ |
| `issue_report.severity` | string | `critical`, `warning`, ಅಥವಾ `info` |
| `issue_report.status` | string | `open` ಅಥವಾ `resolved` |
| `issue_report.source` | string | `user` (ಡ್ಯಾಶ್‌ಬೋರ್ಡ್‌ನಿಂದ ಸಲ್ಲಿಸಲಾಗಿದೆ) ಅಥವಾ `system` (ಗ್ರೇಡಿಂಗ್‌ನಿಂದ ರಚಿಸಲಾಗಿದೆ) |

<Note>
  ಕರೆಯನ್ನು ಮರುಗ್ರೇಡ್ ಮಾಡಿದಾಗ ಅದರ ಸಿಸ್ಟಮ್-ರಚಿಸಿದ ಸಮಸ್ಯೆ ವರದಿಗಳನ್ನು ಮರುನಿರ್ಮಿಸಲಾಗುತ್ತದೆ,
  ಇದರಿಂದ ಮರುರಚಿಸಿದ ವರದಿಗಳಿಗಾಗಿ `issue.reported` ಮತ್ತೆ ಹೊರಸೂಸಲ್ಪಡುತ್ತದೆ. ಪ್ರತಿ
  ಮೂಲ ಸಮಸ್ಯೆಗೆ ಒಂದೇ ಅಧಿಸೂಚನೆ ಬೇಕಾದರೆ `call_id` + `title` ಮೇಲೆ ನಕಲು ತೆಗೆದುಹಾಕಿ.
</Note>

### `issue.escalated`

ಸಿಬ್ಬಂದಿ ಪರಿಶೀಲನೆಗಾಗಿ ಸಮಸ್ಯೆ ಮಾದರಿಯನ್ನು ThunderPhone ಗೆ ಕಳುಹಿಸಿದಾಗ
ಕಳುಹಿಸಲಾಗುತ್ತದೆ: **ThunderPhone ಗೆ ವರದಿ ಮಾಡಿ** ನಂತರ, ಅಥವಾ AI ಮೂಲಕ ಸರಿಪಡಿಸುವಿಕೆಯು
ಗ್ರಾಹಕ-ಬದಿಯ ಪರಿಹಾರವನ್ನು ದೃಢೀಕರಿಸಲು ಸಾಧ್ಯವಾಗದೆ ಸಮಸ್ಯೆಯನ್ನು ಸ್ವಯಂಚಾಲಿತವಾಗಿ
ಮಾರ್ಗನಿರ್ದೇಶಿಸಿದಾಗ. ಸಂಸ್ಥೆ-ವ್ಯಾಪ್ತಿಯ ಎಂಡ್‌ಪಾಯಿಂಟ್‌ಗಳು ಮಾತ್ರ ಈ ಈವೆಂಟ್ ಅನ್ನು
ಸ್ವೀಕರಿಸುತ್ತವೆ.

```json
{
  "data": {
    "automatic": false,
    "cluster_id": "7ac2844c-2df0-4fa8-a560-7378da649e19",
    "escalation_id": "ec99f52b-c8c0-41dd-a4f2-dd8a07b10894",
    "status": "open"
  },
  "event_id": "d8f8f420-7a42-45ba-bcf1-b747f9bbecda",
  "type": "issue.escalated"
}
```

| ಕ್ಷೇತ್ರ | ಪ್ರಕಾರ | ವಿವರಣೆ |
|-------|------|-------------|
| `automatic` | boolean | ಸ್ವಯಂಚಾಲಿತ ಎಸ್ಕಲೇಶನ್‌ಗೆ `true`; ಹಸ್ತಚಾಲಿತ ಎಸ್ಕಲೇಶನ್‌ಗೆ `false` |
| `cluster_id` | UUID | ಎಸ್ಕಲೇಟ್ ಮಾಡಲಾದ ಸಮಸ್ಯೆ ಮಾದರಿ |
| `escalation_id` | UUID | ಎಸ್ಕಲೇಶನ್ ದಾಖಲೆ |
| `status` | string | ಈವೆಂಟ್ ಹೊರಸೂಸಿದಾಗ `open` |

ಇದು ಅಧಿಸೂಚನೆಯೇ ಹೊರತು ಸಾಕ್ಷ್ಯ ಬಂಡಲ್ ಅಲ್ಲ. ಸಮಸ್ಯೆ ಮಾದರಿಯೊಂದಿಗೆ ಇದನ್ನು ಸಂಬಂಧಿಸಲು
`cluster_id` ಬಳಸಿ. [ThunderPhone ಗೆ ವರದಿ ಮಾಡಿ](/kn/guides/issues) ನೋಡಿ.

---

## ಪರೀಕ್ಷಾ ಕರೆ ಈವೆಂಟ್‌ಗಳು

### `test-call.completed`

[test-call ರನ್](/api-reference/test-calls#test-call-run-object)
ಅಂತಿಮ ಸ್ಥಿತಿಯನ್ನು — `completed` ಅಥವಾ `failed` — ತಲುಪಿದಾಗ ಕಳುಹಿಸಲಾಗುತ್ತದೆ. ಇದರಲ್ಲಿ ಪ್ರಾರಂಭಿಸುವಾಗಲೇ ವಿಫಲಗೊಂಡು ಎಂದಿಗೂ ಕರೆಯನ್ನು ಉತ್ಪಾದಿಸದ ರನ್‌ಗಳೂ ಸೇರಿವೆ. ತಡೆರಹಿತ. ಬ್ಯಾಚ್ CI ರನ್‌ಗಳನ್ನು ನಿಮ್ಮ ಚಾಟ್/ಅಧಿಸೂಚನೆ ವ್ಯವಸ್ಥೆಗಳಿಗೆ ಸಂಪರ್ಕಿಸಲು ಉಪಯುಕ್ತವಾಗಿದೆ.

```json
{
  "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"
}
```

| ಕ್ಷೇತ್ರ | ಪ್ರಕಾರ | ವಿವರಣೆ |
|-------|------|-------------|
| `agent_id` | integer \| null | ಒಬ್ಬ ಏಜೆಂಟ್ ನಿಯೋಜಿಸಲ್ಪಟ್ಟಿದ್ದರೆ, ಕರೆಯನ್ನು ನಿರ್ವಹಿಸಿದ ಏಜೆಂಟ್ |
| `agent_name` | string \| null | ಒಬ್ಬ ಏಜೆಂಟ್ ನಿಯೋಜಿಸಲ್ಪಟ್ಟಿದ್ದರೆ, ಕರೆಯನ್ನು ನಿರ್ವಹಿಸಿದ ಏಜೆಂಟ್ |
| `test_call_run.target_type` | string | `agent` ಅಥವಾ `phone_number` |
| `test_call_run.target_id` | integer | `target_type` ಗೆ ಹೊಂದಿಕೆಯಾಗುವಂತೆ ರನ್ ಗುರಿಯಾಗಿಸಿಕೊಂಡ ಏಜೆಂಟ್ ಐಡಿ ಅಥವಾ ಫೋನ್-ಸಂಖ್ಯೆ ಐಡಿ |
| `test_call_run.status` | string | `completed` ಅಥವಾ `failed` |
| `test_call_run.call_id` | integer \| null | ಕರೆ ಮಾಡುವ ಮೊದಲು ರನ್ ವಿಫಲಗೊಂಡಾಗ `null` |
| `test_call_run.error_message` | string | ಯಶಸ್ವಿಯಾದಾಗ ಖಾಲಿಯಾಗಿರುತ್ತದೆ |

---

## ಎಚ್ಚರಿಕೆ ಈವೆಂಟ್‌ಗಳು

### `alert.triggered`

**ಡೆವಲಪರ್ ವೆಬ್‌ಹುಕ್‌ಗಳಿಗೆ ತಲುಪಿಸಿ** ಚಾನೆಲ್ ಸಕ್ರಿಯಗೊಳಿಸಿರುವ [ಎಚ್ಚರಿಕೆ ನಿಯಮ](/kn/guides/alerts)ವು ಅದರ ಮಿತಿಯನ್ನು ದಾಟಿದಾಗ ಕಳುಹಿಸಲಾಗುತ್ತದೆ.
ತಡೆರಹಿತ. ನಿಯಮವು ಒಮ್ಮೆ ಸಕ್ರಿಯಗೊಂಡ ನಂತರ ಅದರ ಕೂಲ್‌ಡೌನ್ ಅನ್ನು ಪಾಲಿಸುತ್ತದೆ; ಆದ್ದರಿಂದ ನಿರಂತರ ಉಲ್ಲಂಘನೆಯು ಪ್ರತಿ ಕೂಲ್‌ಡೌನ್ ವಿಂಡೋಗೆ ಒಂದು ಈವೆಂಟ್ ಅನ್ನು ಉತ್ಪಾದಿಸುತ್ತದೆ.

```json
{
  "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"
}
```

| ಕ್ಷೇತ್ರ | ಪ್ರಕಾರ | ವಿವರಣೆ |
|-------|------|-------------|
| `event_id` (`data` ನಲ್ಲಿ) | UUID | ಎಚ್ಚರಿಕೆ **ಸಕ್ರಿಯಗೊಳಿಸುವ** ಐಡಿ — ಎನ್ವಲಪ್‌ನ ವಿತರಣಾ `event_id` ಗಿಂತ ಭಿನ್ನವಾಗಿದೆ |
| `rule_id`, `rule_name` | UUID, string | ಸಕ್ರಿಯಗೊಂಡ ನಿಯಮ |
| `metric` | string | `success_rate`, `failure_rate`, `avg_score`, `call_volume`, ಅಥವಾ `suite_regression` |
| `comparator` | string | `lt`, `lte`, `gt`, ಅಥವಾ `gte` |
| `metric_value` | number | ನಿಯಮ ಸಕ್ರಿಯಗೊಂಡಾಗ ವಿಂಡೋದಾದ್ಯಂತದ ಮೆಟ್ರಿಕ್ ಮೌಲ್ಯ |
| `threshold` | number | ಕಾನ್ಫಿಗರ್ ಮಾಡಿದ ಮಿತಿ |
| `window_hours` | integer | ಕೊನೆಯ ಮೌಲ್ಯಮಾಪನ ವಿಂಡೋ |
| `fired_at` | timestamp | |

ನಿಯಮಗಳು, ಮೆಟ್ರಿಕ್‌ಗಳು, ಕೂಲ್‌ಡೌನ್‌ಗಳು ಮತ್ತು ಇಮೇಲ್ / Slack ಚಾನೆಲ್‌ಗಳನ್ನು ರಚಿಸಲು [ಎಚ್ಚರಿಕೆಗಳ ಮಾರ್ಗದರ್ಶಿ](/kn/guides/alerts) ನೋಡಿ.

---

## ಸಂಬಂಧಿತ

<CardGroup cols={2}>
  <Card title="telephony.incoming / web.incoming" icon="phone" href="/kn/webhooks/call-incoming">
    ನೀವು ಪ್ರತಿಕ್ರಿಯಿಸಬೇಕಾದ ತಡೆಯುವ ಒಳಬರುವ-ಕರೆ ಪೇಲೋಡ್.
  </Card>
  <Card title="telephony.complete / web.complete" icon="phone-slash" href="/kn/webhooks/call-complete">
    ಕರೆಯ ನಂತರದ ಟ್ರಾನ್ಸ್‌ಕ್ರಿಪ್ಟ್ ಮತ್ತು ಮೆಟ್ರಿಕ್‌ಗಳು.
  </Card>
  <Card title="ವೆಬ್‌ಹುಕ್ ಎಂಡ್‌ಪಾಯಿಂಟ್‌ಗಳು" icon="bolt" href="/kn/webhooks/endpoints">
    ಈ ಈವೆಂಟ್‌ಗಳ ಉಪವಿಭಾಗಕ್ಕೆ URL ಅನ್ನು ಸಬ್‌ಸ್ಕ್ರೈಬ್ ಮಾಡಿ.
  </Card>
  <Card title="ಫಂಕ್ಷನ್ ಸಾಧನಗಳು" icon="screwdriver-wrench" href="/kn/tools/overview">
    `telephony.tool` / `web.tool` ಈವೆಂಟ್‌ಗಳು ಹೇಗೆ ಉತ್ಪತ್ತಿಯಾಗುತ್ತವೆ.
  </Card>
</CardGroup>