---
title: "ವೆಬ್‌ಹುಕ್ ಎಂಡ್‌ಪಾಯಿಂಟ್‌ಗಳು"
description: "ಪ್ರತಿ ಎಂಡ್‌ಪಾಯಿಂಟ್‌ಗೆ ಪ್ರತ್ಯೇಕ ಸೀಕ್ರೆಟ್‌ಗಳು ಮತ್ತು ಈವೆಂಟ್ ಫಿಲ್ಟರ್‌ಗಳೊಂದಿಗೆ ಬಹು ವೆಬ್‌ಹುಕ್ URLಗಳನ್ನು ನಿರ್ವಹಿಸಿ."
---

ಎಂಡ್‌ಪಾಯಿಂಟ್-ಆಧಾರಿತ webhook ವ್ಯವಸ್ಥೆಯು ಪ್ರತಿ ಸಂಸ್ಥೆಗೆ **ಬಹು**
ಗಮ್ಯಸ್ಥಾನಗಳನ್ನು ನೋಂದಾಯಿಸಲು ನಿಮಗೆ ಅನುಮತಿಸುತ್ತದೆ; ಪ್ರತಿಯೊಂದಕ್ಕೂ ತನ್ನದೇ ಆದ ರಹಸ್ಯ,
ತನ್ನದೇ ಆದ ಸ್ಥಿತಿ ಮತ್ತು ಈವೆಂಟ್ ಪ್ರಕಾರಗಳ ಉಪವಿಭಾಗಕ್ಕೆ ತನ್ನದೇ ಆದ ಚಂದಾದಾರಿಕೆ ಇರುತ್ತದೆ. ಎಲ್ಲಾ
ಹೊಸ ಏಕೀಕರಣಗಳಿಗೆ ಇದು ಶಿಫಾರಸು ಮಾಡಲಾದ ಮಾದರಿಯಾಗಿದೆ.

ಹಿಂದಿನ ಆವೃತ್ತಿಗಳ ಹೊಂದಾಣಿಕೆಗಾಗಿ ಉಳಿಸಿಕೊಂಡಿರುವ, ಆದರೆ ಪ್ರತಿ ಸಂಸ್ಥೆಗೆ ಕೇವಲ ಒಂದು URL ಅನ್ನು ಮಾತ್ರ
ಬೆಂಬಲಿಸುವ [ಹಳೆಯ ಏಕ-URL webhook](/api-reference/organizations#legacy-single-url-webhook) ಜೊತೆಗೆ ಹೋಲಿಸಿ.

## ಎಂಡ್‌ಪಾಯಿಂಟ್‌ಗಳು

| ವಿಧಾನ | ಮಾರ್ಗ | ಅಗತ್ಯವಿರುವ ಪಾತ್ರ | ವಿವರಣೆ |
|--------|------|---------------|-------------|
| `GET` | `/v1/developer/webhook-endpoints` | `admin+` | ಎಂಡ್‌ಪಾಯಿಂಟ್‌ಗಳನ್ನು ಪಟ್ಟಿ ಮಾಡಿ |
| `POST` | `/v1/developer/webhook-endpoints` | `admin+` | ಎಂಡ್‌ಪಾಯಿಂಟ್ ರಚಿಸಿ |
| `PATCH` | `/v1/developer/webhook-endpoints/{endpoint_id}` | `admin+` | ಲೇಬಲ್ / URL / ಈವೆಂಟ್‌ಗಳು / ಸ್ಥಿತಿಯನ್ನು ನವೀಕರಿಸಿ |
| `DELETE` | `/v1/developer/webhook-endpoints/{endpoint_id}` | `admin+` | ಎಂಡ್‌ಪಾಯಿಂಟ್ ಅಳಿಸಿ |
| `POST` | `/v1/developer/webhook-endpoints/{endpoint_id}/test` | `admin+` | ಸಹಿ ಮಾಡಲಾದ ಪರೀಕ್ಷಾ ವಿತರಣೆಯನ್ನು ಕಳುಹಿಸಿ |
| `GET` | `/v1/developer/webhook-deliveries` | `admin+` | ಇತ್ತೀಚಿನ ಎಂಡ್‌ಪಾಯಿಂಟ್ ಮತ್ತು ಹಳೆಯ ವಿತರಣಾ ಫಲಿತಾಂಶಗಳನ್ನು ಪರಿಶೀಲಿಸಿ |

## ಎಂಡ್‌ಪಾಯಿಂಟ್ ಆಬ್ಜೆಕ್ಟ್

```json
{
  "id": "c4d5e6f7-...",
  "label": "Production — Call events",
  "url": "https://example.com/thunderphone/hook",
  "events": ["telephony.incoming", "telephony.complete"],
  "status": "active",
  "agent_id": 42,
  "agent_name": "Support Agent",
  "secret_hint": "a1b2…9f0e",
  "created_at": "2026-04-20T18:24:10.113Z",
  "updated_at": "2026-04-20T18:24:10.113Z"
}
```

| ಕ್ಷೇತ್ರ | ವಿಧ | ವಿವರಣೆ |
|-------|------|-------------|
| `id` | UUID | ಎಂಡ್‌ಪಾಯಿಂಟ್ ಐಡಿ |
| `label` | ಸ್ಟ್ರಿಂಗ್ | ಪ್ರದರ್ಶನ ಹೆಸರು, 1–120 ಅಕ್ಷರಗಳು |
| `url` | ಸ್ಟ್ರಿಂಗ್ | HTTPS URL; ಅಭಿವೃದ್ಧಿಗಾಗಿ `http://localhost` ಗೆ ಅನುಮತಿ ಇದೆ |
| `events` | ಸ್ಟ್ರಿಂಗ್‌ನ ಅರೇ | ಚಂದಾದಾರರಾಗಿರುವ ಈವೆಂಟ್ ವಿಧಗಳು ([ಮಾನ್ಯ ಮೌಲ್ಯಗಳನ್ನು](#valid-event-types) ನೋಡಿ). ಖಾಲಿ ಅರೇ ಸ್ಪಷ್ಟವಾಗಿ ಮಾತ್ರ ಆಯ್ಕೆಮಾಡಬಹುದಾದ ಪ್ರತಿ-ತಿರುವಿನ ಈವೆಂಟ್‌ಗಳಾದ (`telephony.turn` / `web.turn`) ಹೊರತುಪಡಿಸಿ ಎಲ್ಲ ಈವೆಂಟ್‌ಗಳಿಗೆ ಚಂದಾದಾರರಾಗುತ್ತದೆ |
| `status` | ಸ್ಟ್ರಿಂಗ್ | `active`, `disabled` (ಕೈಯಾರೆ ವಿರಾಮಗೊಳಿಸಲಾಗಿದೆ), ಅಥವಾ `failing` (ಒಂದು ವಿತರಣೆಯು ಒಂದೇ ಒಂದು 2xx ಸಹ ಪಡೆಯದೆ ತನ್ನ 24 ಗಂಟೆಗಳ ಮರುಪ್ರಯತ್ನ ವೇಳಾಪಟ್ಟಿಯನ್ನು ಮುಗಿಸಿದಾಗ ಸ್ವಯಂಚಾಲಿತವಾಗಿ ಹೊಂದಿಸಲಾಗುತ್ತದೆ) |
| `agent_id` | ಪೂರ್ಣಾಂಕ \| ಶೂನ್ಯ | ಈ ಎಂಡ್‌ಪಾಯಿಂಟ್ ವ್ಯಾಪ್ತಿಗೊಳಪಟ್ಟಿರುವ ಏಜೆಂಟ್; `null` ಎಂದರೆ ಸಂಸ್ಥೆಯಾದ್ಯಂತ |
| `agent_name` | ಸ್ಟ್ರಿಂಗ್ \| ಶೂನ್ಯ | ವ್ಯಾಪ್ತಿಗೊಳಪಟ್ಟ ಏಜೆಂಟ್‌ನ ಹೆಸರು, ಅಥವಾ ಸಂಸ್ಥೆಯಾದ್ಯಂತದ ಎಂಡ್‌ಪಾಯಿಂಟ್‌ಗೆ `null` |
| `secret_hint` | ಸ್ಟ್ರಿಂಗ್ | ಸಹಿ ರಹಸ್ಯದ ಮೊದಲ 4 ಮತ್ತು ಕೊನೆಯ 4 ಅಕ್ಷರಗಳು ಹಾಗೂ ಎಲಿಪ್ಸಿಸ್ (`a1b2…9f0e`) — ಸಂಪೂರ್ಣ ಮೌಲ್ಯವನ್ನು ಬಹಿರಂಗಪಡಿಸದೆ ನೀವು ಸ್ಥಳೀಯವಾಗಿ ಉಳಿಸಿದ ರಹಸ್ಯವನ್ನು ಅಡ್ಡ-ಉಲ್ಲೇಖಿಸಲು ಸಾಕಷ್ಟು |
| `created_at`, `updated_at` | ಸಮಯಮುದ್ರೆ | |

<Note>
  ಎಂಡ್‌ಪಾಯಿಂಟ್‌ನ ಸಂಪೂರ್ಣ `secret` ರಚನೆಯ ಸಮಯದಲ್ಲಿ **ಒಮ್ಮೆ ಮಾತ್ರ** ಹಿಂತಿರುಗಿಸಲಾಗುತ್ತದೆ ಮತ್ತು
  ಮತ್ತೆ ಎಂದಿಗೂ ಅಲ್ಲ. ಅದನ್ನು ಸುರಕ್ಷಿತವಾಗಿ ಸಂಗ್ರಹಿಸಿ — ಅದು ಕಳೆದುಹೋದರೆ, ಎಂಡ್‌ಪಾಯಿಂಟ್ ಅನ್ನು ಅಳಿಸಿ
  ಮತ್ತು ಮರುರಚಿಸಿ.
</Note>

### ಮಾನ್ಯ ಈವೆಂಟ್ ವಿಧಗಳು

`events` ಅನ್ನು ಈ ನಿಖರವಾದ ಗುಂಪಿನ ವಿರುದ್ಧ ಪರಿಶೀಲಿಸಲಾಗುತ್ತದೆ — ಪಟ್ಟಿಯ ಹೊರಗಿನ ಮೌಲ್ಯಗಳು
`400` ಅನ್ನು ಹಿಂತಿರುಗಿಸುತ್ತವೆ. ಪ್ರತಿ ವಿಧದ ಪೇಲೋಡ್ ರಚನೆಗಾಗಿ [ಈವೆಂಟ್ ಕ್ಯಾಟಲಾಗ್](/kn/webhooks/events) ನೋಡಿ.

- `telephony.incoming`, `telephony.complete`, `telephony.tool`, `telephony.turn`
- `web.incoming`, `web.complete`, `web.tool`, `web.turn`
- `call.graded`, `call.data_extracted`
- `campaign.completed`
- `issue.reported`, `issue.escalated`
- `test-call.completed`
- `alert.triggered`

`issue.escalated` ಗೆ ಏಜೆಂಟ್ ಸಂದರ್ಭವಿಲ್ಲ ಮತ್ತು ಅದನ್ನು ಸಂಸ್ಥೆಯಾದ್ಯಂತದ
ಎಂಡ್‌ಪಾಯಿಂಟ್‌ಗಳಿಗೆ ಮಾತ್ರ ತಲುಪಿಸಲಾಗುತ್ತದೆ.

`voice.ready` ಮತ್ತು `voice.failed` ಅನ್ನು ಸ್ಪಷ್ಟವಾಗಿ ಆಯ್ಕೆಮಾಡಲು ಸಾಧ್ಯವಿಲ್ಲ. ಅವುಗಳನ್ನು ಸ್ವೀಕರಿಸಲು,
`events: []` ಜೊತೆಗೆ ಸಂಸ್ಥೆಯಾದ್ಯಂತದ ಎಂಡ್‌ಪಾಯಿಂಟ್ ರಚಿಸಿ. ಖಾಲಿ ಈವೆಂಟ್ ಪಟ್ಟಿ `telephony.turn` ಮತ್ತು
`web.turn` ಹೊರತುಪಡಿಸಿ, ಬೆಂಬಲಿತ ಪ್ರತಿಯೊಂದು ಈವೆಂಟ್ ಅನ್ನು ಸ್ವೀಕರಿಸುತ್ತದೆ; ಅವುಗಳನ್ನು ಸ್ಪಷ್ಟವಾಗಿ ಆಯ್ಕೆಮಾಡಬೇಕು.

### ಎಂಡ್‌ಪಾಯಿಂಟ್ ಸ್ಥಿತಿಗಳು

- `active` — ವಿತರಣೆಗಳು ಸಾಮಾನ್ಯವಾಗಿ ನಡೆಯುತ್ತವೆ.
- `disabled` — `PATCH` ಮೂಲಕ ಕೈಯಾರೆ ವಿರಾಮಗೊಳಿಸಲಾಗಿದೆ. ಯಾವುದೇ ವಿನಂತಿಗಳನ್ನು ಕಳುಹಿಸಲಾಗುವುದಿಲ್ಲ. ನಾವು
  `disabled` ಎಂಡ್‌ಪಾಯಿಂಟ್‌ನ ಸ್ಥಿತಿಯನ್ನು ಎಂದಿಗೂ ಬದಲಾಯಿಸುವುದಿಲ್ಲ; ಅದನ್ನು ಮರಳಿ
  `active` ಗೆ ಬದಲಾಯಿಸುವುದು ಯಾವಾಗಲೂ ನಿಮ್ಮ ನಿರ್ಧಾರ.
- `failing` — ಎಂಡ್‌ಪಾಯಿಂಟ್‌ಗೆ ವಿತರಣೆಯೊಂದು 2xx ಪಡೆಯದೆ ತನ್ನ ಸಂಪೂರ್ಣ ಮರುಪ್ರಯತ್ನ
  ವೇಳಾಪಟ್ಟಿಯನ್ನು (24 ಗಂಟೆಗಳಲ್ಲಿ 8 ಪ್ರಯತ್ನಗಳು) ಮುಗಿಸಿದಾಗ ಸ್ವಯಂಚಾಲಿತವಾಗಿ ಹೊಂದಿಸಲಾಗುತ್ತದೆ.
  ವಿಫಲವಾಗುತ್ತಿರುವ ಎಂಡ್‌ಪಾಯಿಂಟ್ ಯಾವುದೇ ಮುಂದಿನ ಟ್ರಾಫಿಕ್ ಸ್ವೀಕರಿಸುವುದಿಲ್ಲ.
  ಎಂಡ್‌ಪಾಯಿಂಟ್ ಸರಿಪಡಿಸಿದ ನಂತರ, ಅದರ ಸ್ಥಿತಿಯನ್ನು `PATCH` ಮೂಲಕ ಮರಳಿ `active` ಗೆ ಬದಲಾಯಿಸಿ;
  ಮರುಪ್ರಯತ್ನ ವೇಳಾಪಟ್ಟಿ ಇನ್ನೂ ಮುಗಿಯದ ವಿತರಣೆಗಳು ನಿಲ್ಲಿಸಿದ ಸ್ಥಳದಿಂದಲೇ ಪುನರಾರಂಭಗೊಳ್ಳುತ್ತವೆ.

---

## ಎಂಡ್‌ಪಾಯಿಂಟ್‌ಗಳ ಪಟ್ಟಿ

<CodeGroup>
```bash cURL
curl https://api.thunderphone.com/v1/developer/webhook-endpoints \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"
```
</CodeGroup>

[ಎಂಡ್‌ಪಾಯಿಂಟ್ ಆಬ್ಜೆಕ್ಟ್‌ಗಳ](#endpoint-object) ಅರೇಯನ್ನು ಹಿಂತಿರುಗಿಸುತ್ತದೆ.
ಆ ಏಜೆಂಟ್‌ಗೆ ವ್ಯಾಪ್ತಿಗೊಳಪಟ್ಟ ಎಂಡ್‌ಪಾಯಿಂಟ್‌ಗಳನ್ನು ಮಾತ್ರ ಹಿಂತಿರುಗಿಸಲು `?agent_id=42` ಅನ್ನು ಕಳುಹಿಸಿ.

### ಏಜೆಂಟ್-ವ್ಯಾಪ್ತಿಯ ಎಂಡ್‌ಪಾಯಿಂಟ್‌ಗಳು

ಸಂಸ್ಥೆಯಾದ್ಯಂತದ ಎಂಡ್‌ಪಾಯಿಂಟ್‌ಗಳು ಹೊಂದಿಕೆಯಾಗುವ ಪ್ರತಿಯೊಂದು ಈವೆಂಟ್ ಅನ್ನು ಸ್ವೀಕರಿಸುತ್ತವೆ. `agent_id` ಹೊಂದಿರುವ
ಎಂಡ್‌ಪಾಯಿಂಟ್ ಆ ಏಜೆಂಟ್ ನಿರ್ವಹಿಸಿದ ಕರೆಗಳಿಗೆ ಸಂಬಂಧಿಸಿದ ಹೊಂದಿಕೆಯಾಗುವ ಈವೆಂಟ್‌ಗಳನ್ನು ಮಾತ್ರ ಸ್ವೀಕರಿಸುತ್ತದೆ;
`alert.triggered` ನಂತಹ ಏಜೆಂಟ್ ಸಂದರ್ಭವಿಲ್ಲದ ಈವೆಂಟ್‌ಗಳು ಅದನ್ನು ಎಂದಿಗೂ ತಲುಪುವುದಿಲ್ಲ. ನೀವು ಈ
ಎಂಡ್‌ಪಾಯಿಂಟ್‌ಗಳನ್ನು ಏಜೆಂಟ್ ಬಿಲ್ಡರ್‌ನ **ವೆಬ್‌ಹುಕ್‌ಗಳು** ವಿಭಾಗದಿಂದಲೂ ರಚಿಸಬಹುದು ಮತ್ತು ನಿರ್ವಹಿಸಬಹುದು.

---

## ಎಂಡ್‌ಪಾಯಿಂಟ್ ರಚಿಸಿ

<CodeGroup>
```bash cURL
curl -X POST https://api.thunderphone.com/v1/developer/webhook-endpoints \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "label":  "Production — Call events",
    "url":    "https://example.com/thunderphone/hook",
    "events": ["telephony.incoming", "telephony.complete"]
  }'
```

```python Python
result = requests.post(
    "https://api.thunderphone.com/v1/developer/webhook-endpoints",
    headers={"Authorization": "Bearer sk_live_YOUR_API_KEY"},
    json={
        "label":  "Production — Call events",
        "url":    "https://example.com/thunderphone/hook",
        "events": ["telephony.incoming", "telephony.complete"],
    },
).json()
secret = result["secret"]
endpoint_id = result["id"]
```
</CodeGroup>

### ವಿನಂತಿ ಕ್ಷೇತ್ರಗಳು

| ಕ್ಷೇತ್ರ | ವಿಧ | ಅಗತ್ಯವಿದೆ | ವಿವರಣೆ |
|-------|------|----------|-------------|
| `label` | ಸ್ಟ್ರಿಂಗ್ | ಹೌದು | 1–120 ಅಕ್ಷರಗಳು |
| `url` | ಸ್ಟ್ರಿಂಗ್ | ಹೌದು | HTTPS URL (`http` ಅನ್ನು `localhost` / `127.0.0.1` ಗೆ ಮಾತ್ರ ಅನುಮತಿಸಲಾಗಿದೆ) |
| `events` | ಅರೇ | ಇಲ್ಲ | ಖಾಲಿ ಅಥವಾ ಬಿಟ್ಟುಬಿಟ್ಟರೆ `telephony.turn` / `web.turn` ಹೊರತುಪಡಿಸಿ ಎಲ್ಲ ಈವೆಂಟ್‌ಗಳಿಗೆ ಚಂದಾದಾರರಾಗುತ್ತದೆ; ಇವುಗಳಿಗೆ ಸ್ಪಷ್ಟ ಚಂದಾದಾರಿಕೆ ಅಗತ್ಯವಿದೆ. [ಮಾನ್ಯ ಈವೆಂಟ್ ವಿಧಗಳು](#valid-event-types) ನಲ್ಲಿ ಪಟ್ಟಿ ಮಾಡಿರುವ ಮೌಲ್ಯಗಳನ್ನು ಬಳಸಬೇಕು; ನಕಲುಗಳನ್ನು ತೆಗೆದುಹಾಕಲಾಗುತ್ತದೆ |
| `agent_id` | ಇಂಟೀಜರ್ \| ನಲ್ | ಇಲ್ಲ | ಈ ಸಂಸ್ಥೆಯಲ್ಲಿನ ಏಜೆಂಟ್‌ಗೆ ವಿತರಣೆಯನ್ನು ಸೀಮಿತಗೊಳಿಸಿ; ಸಂಸ್ಥೆಯಾದ್ಯಂತದ ಎಂಡ್‌ಪಾಯಿಂಟ್‌ಗಾಗಿ ಬಿಟ್ಟುಬಿಡಿ ಅಥವಾ `null` ಬಳಸಿ |

[ಎಂಡ್‌ಪಾಯಿಂಟ್ ಆಬ್ಜೆಕ್ಟ್](#endpoint-object) ಜೊತೆಗೆ ಮೂಲ ಸಹಿ ಕೀಲಿಯನ್ನು ಹೊಂದಿರುವ ಹೆಚ್ಚುವರಿ ಮೇಲ್ಮಟ್ಟದ `secret` ಕ್ಷೇತ್ರದೊಂದಿಗೆ `201 Created` ಅನ್ನು ಹಿಂತಿರುಗಿಸುತ್ತದೆ — ಇದು 48-ಅಕ್ಷರಗಳ ಹೆಕ್ಸ್ ಸ್ಟ್ರಿಂಗ್ ಆಗಿದೆ:

```json
{
  "id": "c4d5e6f7-…",
  "label": "Production — Call events",
  "url": "https://example.com/thunderphone/hook",
  "events": ["telephony.incoming", "telephony.complete"],
  "status": "active",
  "secret_hint": "a1b2…9f0e",
  "created_at": "2026-04-20T18:24:10.113Z",
  "updated_at": "2026-04-20T18:24:10.113Z",
  "secret": "a1b2c37e08d94f5b16a2c8d90e7f3a4b5c6d7e8f90a19f0e"
}
```

<Warning>
  `secret` ಅನ್ನು **ರಚಿಸುವಾಗ ಮಾತ್ರ** ಹಿಂತಿರುಗಿಸಲಾಗುತ್ತದೆ. ನಂತರದ `GET` ಪ್ರತಿಕ್ರಿಯೆಗಳು
  `secret_hint` ಅನ್ನು ಮಾತ್ರ ಒಳಗೊಂಡಿರುತ್ತವೆ. ಪ್ರತಿಕ್ರಿಯೆಯನ್ನು ಮುಚ್ಚುವ ಮೊದಲು ಪೂರ್ಣ ಮೌಲ್ಯವನ್ನು ನಿಮ್ಮ ಸೀಕ್ರೆಟ್
  ನಿರ್ವಾಹಕಕ್ಕೆ ನಕಲಿಸಿ.
</Warning>

---

## ಎಂಡ್‌ಪಾಯಿಂಟ್ ನವೀಕರಿಸಿ

<CodeGroup>
```bash cURL
curl -X PATCH https://api.thunderphone.com/v1/developer/webhook-endpoints/c4d5e6f7-... \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "label":  "Production — Call + Grade events",
    "events": ["telephony.incoming", "telephony.complete", "call.graded"]
  }'
```
</CodeGroup>

| ಕ್ಷೇತ್ರ | ವಿಧ | ವಿವರಣೆ |
|-------|------|-------------|
| `label` | ಸ್ಟ್ರಿಂಗ್ | |
| `url` | ಸ್ಟ್ರಿಂಗ್ | |
| `events` | ಅರೇ | |
| `status` | ಸ್ಟ್ರಿಂಗ್ | `active` ಅಥವಾ `disabled`. ಸರ್ವರ್ `failing` ಎಂದು ಗುರುತಿಸಿದ ಎಂಡ್‌ಪಾಯಿಂಟ್ ಅನ್ನು ಮರುಸಕ್ರಿಯಗೊಳಿಸಲು `active` ಹೊಂದಿಸಿ |
| `agent_id` | ಇಂಟೀಜರ್ \| ನಲ್ | ಎಂಡ್‌ಪಾಯಿಂಟ್ ಅನ್ನು ಸೀಮಿತಗೊಳಿಸಲು ಏಜೆಂಟ್ ಐಡಿ ಹೊಂದಿಸಿ, ಅಥವಾ ಅದನ್ನು ಸಂಸ್ಥೆಯಾದ್ಯಂತ ಲಭ್ಯವಾಗಿಸಲು `null` ಹೊಂದಿಸಿ |

ನವೀಕರಿಸಿದ [ಎಂಡ್‌ಪಾಯಿಂಟ್ ಆಬ್ಜೆಕ್ಟ್](#endpoint-object) ಜೊತೆಗೆ `200 OK` ಅನ್ನು ಹಿಂತಿರುಗಿಸುತ್ತದೆ.

---

## ಪರೀಕ್ಷಾ ವಿತರಣೆಯನ್ನು ಕಳುಹಿಸಿ

ಕ್ಯಾನಾನಿಕಲ್ JSON ಸೀರಿಯಲೈಜೇಶನ್,
`X-ThunderPhone-Signature`, ವಿತರಣೆಯ ದಾಖಲೆ, ಮತ್ತು ಮರುಪ್ರಯತ್ನದ ಲೆಕ್ಕಪತ್ರವನ್ನು ಒಳಗೊಂಡಂತೆ, ಸಾಮಾನ್ಯ
ವಿತರಣಾ ಪೈಪ್‌ಲೈನ್ ಬಳಸಿ ಒಂದು ಎಂಡ್‌ಪಾಯಿಂಟ್‌ಗೆ ಸಂಶ್ಲೇಷಿತ `webhook.test` ಈವೆಂಟ್ ಕಳುಹಿಸಿ.
ಪರೀಕ್ಷೆಯು ಆಯ್ಕೆಮಾಡಿದ ಎಂಡ್‌ಪಾಯಿಂಟ್‌ನ `events` ಫಿಲ್ಟರ್ ಅನ್ನು ಲೆಕ್ಕಿಸದೆ ಅದನ್ನೇ ಗುರಿಯಾಗಿರಿಸುತ್ತದೆ.

<CodeGroup>
```bash cURL
curl -X POST https://api.thunderphone.com/v1/developer/webhook-endpoints/c4d5e6f7-.../test \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"
```
</CodeGroup>

ಎಂಡ್‌ಪಾಯಿಂಟ್ ಈ ರೀತಿಯ ಎನ್ವಲಪ್ ಅನ್ನು ಸ್ವೀಕರಿಸುತ್ತದೆ:

```json
{
  "data": {
    "message": "ThunderPhone webhook test",
    "sent_at": "2026-07-17T20:12:34.567890+00:00"
  },
  "event_id": "2ad6507c-7d19-4498-9b2d-7e8f944ab5a1",
  "type": "webhook.test"
}
```

ಗಮ್ಯಸ್ಥಾನವು ದೋಷವನ್ನು ಹಿಂತಿರುಗಿಸಿದರೂ, ಮೊದಲ ಪ್ರಯತ್ನದ ನಂತರ API `200 OK` ಅನ್ನು ಹಿಂತಿರುಗಿಸುತ್ತದೆ.
ವಿತರಣೆಯ ಫಲಿತಾಂಶಕ್ಕಾಗಿ `success`, `status`, `response_code`, ಮತ್ತು `error` ಅನ್ನು ಪರಿಶೀಲಿಸಿ:

```json
{
  "success": true,
  "event_id": "2ad6507c-7d19-4498-9b2d-7e8f944ab5a1",
  "event_type": "webhook.test",
  "status": "delivered",
  "response_code": 204,
  "error": ""
}
```

`webhook.test` ಸಂಶ್ಲೇಷಿತವಾಗಿದ್ದು, ಎಂಡ್‌ಪಾಯಿಂಟ್‌ನ `events`
ಚಂದಾದಾರಿಕೆಗೆ ಸೇರಿಸಲು ಸಾಧ್ಯವಿಲ್ಲ. ಮೊದಲ ಪ್ರಯತ್ನ ವಿಫಲವಾದರೆ, ವಿತರಣೆಯು ಸಾಮಾನ್ಯ ಈವೆಂಟ್ ವಿತರಣೆಗಳಂತೆಯೇ
ಅದೇ ಮರುಪ್ರಯತ್ನ ವೇಳಾಪಟ್ಟಿಯನ್ನು ಅನುಸರಿಸುತ್ತದೆ.

ನಿಜವಾದ ಈವೆಂಟ್ ಆಕಾರಕ್ಕೆ ವಿರುದ್ಧವಾಗಿ ಟ್ರಿಗರ್ ಅನ್ನು ಕಾನ್ಫಿಗರ್ ಮಾಡಲು, ಐಚ್ಛಿಕ
`event_type` ಅನ್ನು ರವಾನಿಸಿ. ವಿತರಣೆಯು ಇನ್ನೂ ಸಂಶ್ಲೇಷಿತವಾಗಿರುತ್ತದೆ ಮತ್ತು `"sample": true` ಅನ್ನು ಒಳಗೊಂಡಿರುತ್ತದೆ;
ಕರೆ-ಸಂಬಂಧಿತ ಮಾದರಿಗಳು `call_id: 0` ಮತ್ತು `agent_id: 0` ಅನ್ನು ಬಳಸುತ್ತವೆ.

```bash
curl -X POST https://api.thunderphone.com/v1/developer/webhook-endpoints/c4d5e6f7-.../test \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event_type":"call.graded"}'
```

`event_type`, [ಮಾನ್ಯ ಈವೆಂಟ್ ವಿಧಗಳು](#valid-event-types)ಯಲ್ಲಿನ ಯಾವುದೇ ಮೌಲ್ಯವನ್ನು ಸ್ವೀಕರಿಸುತ್ತದೆ.
ಅದನ್ನು ಬಿಟ್ಟುಬಿಟ್ಟರೆ ಸಾಮಾನ್ಯ `webhook.test` ವರ್ತನೆ ಉಳಿಯುತ್ತದೆ.

---

## ಎಂಡ್‌ಪಾಯಿಂಟ್ ಅಳಿಸಿ

<CodeGroup>
```bash cURL
curl -X DELETE https://api.thunderphone.com/v1/developer/webhook-endpoints/c4d5e6f7-... \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"
```
</CodeGroup>

`204 No Content` ಅನ್ನು ಹಿಂತಿರುಗಿಸುತ್ತದೆ. URL ಗೆ ವಿತರಣೆಯು ತಕ್ಷಣ ನಿಲ್ಲುತ್ತದೆ;
ಪ್ರಗತಿಯಲ್ಲಿರುವ ಮರುಪ್ರಯತ್ನಗಳನ್ನು ತ್ಯಜಿಸಲಾಗುತ್ತದೆ.

---

## ವಿತರಣೆಗಳನ್ನು ಡೀಬಗ್ ಮಾಡಿ

ವೆಬ್‌ಹುಕ್ ಕಳುಹಿಸಲಾಗಿಲ್ಲ ಎಂದು ತೀರ್ಮಾನಿಸುವ ಮೊದಲು,
[`GET /v1/developer/webhook-deliveries`](/api-reference/webhook-deliveries) ಅನ್ನು ಪರಿಶೀಲಿಸಿ.
ಇದು ಕರೆ ಐಡಿ,
URL ಮೂಲ, HTTP ಸ್ಥಿತಿ, ಪ್ರಯತ್ನಗಳ ಎಣಿಕೆ, ಅನುಮತಿಸಿದ ವಿಫಲತಾ ವರ್ಗ, ಮತ್ತು ಮುಂದಿನ
ಮರುಪ್ರಯತ್ನ ಸಮಯವನ್ನು ಒಳಗೊಂಡಂತೆ ಎರಡೂ ವೆಬ್‌ಹುಕ್ ವ್ಯವಸ್ಥೆಗಳ ಇತ್ತೀಚಿನ ಪ್ರಯತ್ನಗಳನ್ನು ತೋರಿಸುತ್ತದೆ. ಇದು ಎಂದಿಗೂ ಈವೆಂಟ್ ಪೇಲೋಡ್, ಟ್ರಾನ್ಸ್‌ಕ್ರಿಪ್ಟ್, ಸಂಗ್ರಹಿಸಿದ ದೋಷ ಪಠ್ಯ,
ಪ್ರತಿಕ್ರಿಯೆಯ ಬಾಡಿ, ಅಥವಾ URL ಪಥವನ್ನು ಹಿಂತಿರುಗಿಸುವುದಿಲ್ಲ.

**ಏಜೆಂಟ್‌ಗಳು → ಏಜೆಂಟ್ ಆಯ್ಕೆಮಾಡಿ → ವೆಬ್‌ಹುಕ್‌ಗಳು →
ಇತ್ತೀಚಿನ ವಿತರಣೆಗಳು** ನಲ್ಲಿಯೂ ಇದೇ ಇತ್ತೀಚಿನ ಇತಿಹಾಸವನ್ನು ನೋಡಬಹುದು. ಸಾಲುಗಳು ಎಂಡ್‌ಪಾಯಿಂಟ್ ಲೇಬಲ್ ಮತ್ತು ಇತ್ತೀಚಿನ
ಪ್ರಯತ್ನವು ಬಳಸಿದ URL ಮೂಲವನ್ನು ತೋರಿಸುತ್ತವೆ. ಇದು ಬದಲಿಸಲಾಗದ ಆಡಿಟ್ ಲಾಗ್‌ಗಿಂತ ಕಾರ್ಯಾಚರಣೆಯ ಸ್ಥಿತಿಯಾಗಿದೆ: ಎಂಡ್‌ಪಾಯಿಂಟ್ ಅಳಿಸುವುದು
ಅದರ ವಿತರಣಾ ಸಾಲುಗಳನ್ನೂ ಅಳಿಸುತ್ತದೆ.

n8n `404` ಗಾಗಿ, ಮೊದಲು ವರ್ಕ್‌ಫ್ಲೋ ಸಕ್ರಿಯವಾಗಿದೆಯೇ, `POST` ಅನ್ನು ಸ್ವೀಕರಿಸುತ್ತದೆಯೇ, ಮತ್ತು
ಪರೀಕ್ಷಾ URL ಬದಲಿಗೆ ಉತ್ಪಾದನಾ ವೆಬ್‌ಹುಕ್ URL ಅನ್ನು ಬಳಸುತ್ತದೆಯೇ ಎಂದು ದೃಢೀಕರಿಸಿ. `401` ಅಥವಾ `403` ಎಂದರೆ
ದೃಢೀಕರಣ ಅಥವಾ ಸಿಗ್ನೇಚರ್ ಮೌಲ್ಯೀಕರಣದ ಸಮಸ್ಯೆ; ಕಾಲಾವಧಿ ಮೀರಿಕೆಗಳು ಗಮ್ಯಸ್ಥಾನದ ವಿಳಂಬ
ಅಥವಾ ಲಭ್ಯತೆಯನ್ನು ಸೂಚಿಸುತ್ತವೆ; TLS ದೋಷಗಳು ಪ್ರಮಾಣಪತ್ರ ಸರಣಿ, ಹೋಸ್ಟ್‌ನಾಮ, ಅಥವಾ ಮುಕ್ತಾಯವನ್ನು ಸೂಚಿಸುತ್ತವೆ.

---

## ಸಂಬಂಧಿತ

<CardGroup cols={2}>
  <Card title="ಈವೆಂಟ್‌ಗಳ ಕ್ಯಾಟಲಾಗ್" icon="list" href="/kn/webhooks/events">
    ನೀವು ಚಂದಾದಾರರಾಗಬಹುದಾದ `events` ಮೌಲ್ಯಗಳ ಸಂಪೂರ್ಣ ಪಟ್ಟಿ.
  </Card>
  <Card title="ವೆಬ್‌ಹುಕ್‌ಗಳ ಅವಲೋಕನ" icon="bolt" href="/kn/webhooks/overview">
    ಸಿಗ್ನೇಚರ್ ಪರಿಶೀಲನೆ ಮತ್ತು ವಿತರಣಾ ಅರ್ಥವ್ಯವಸ್ಥೆ.
  </Card>
</CardGroup>