---
title: "Webhook எண்ட்பாயிண்ட்கள்"
description: "ஒவ்வொரு எண்ட்பாயிண்டிற்குமான ரகசியங்கள் மற்றும் நிகழ்வு வடிப்பான்களுடன் பல webhook 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 | எண்ட்பாயிண்ட் id |
| `label` | string | காட்சிப் பெயர், 1–120 எழுத்துகள் |
| `url` | string | HTTPS URL; டெவலப்மெண்ட்டிற்கு `http://localhost` அனுமதிக்கப்படுகிறது |
| `events` | string-களின் வரிசை | சந்தா பெற்ற நிகழ்வு வகைகள் ([செல்லுபடியான மதிப்புகள்](#valid-event-types) பார்க்கவும்). காலி வரிசை, வெளிப்படையாக மட்டுமே தேர்ந்தெடுக்கக்கூடிய ஒவ்வொரு-டர்ன் நிகழ்வுகளான (`telephony.turn` / `web.turn`) தவிர அனைத்து நிகழ்வுகளுக்கும் சந்தா பெறும் |
| `status` | string | `active`, `disabled` (கைமுறையாக இடைநிறுத்தப்பட்டது), அல்லது `failing` (ஒரு டெலிவரி ஒரு 2xx-ஐயும் பெறாமல் அதன் 24 மணி நேர மீண்டும் முயற்சி அட்டவணையை முடித்துவிட்டால் தானாக அமைக்கப்படும்) |
| `agent_id` | integer \| null | இந்த எண்ட்பாயிண்ட் வரம்பிடப்பட்டுள்ள ஏஜென்ட்; `null` என்பது நிறுவனம் முழுவதையும் குறிக்கும் |
| `agent_name` | string \| null | வரம்பிடப்பட்ட ஏஜென்ட்டின் பெயர் அல்லது நிறுவனம் முழுவதுமான எண்ட்பாயிண்ட்டிற்கு `null` |
| `secret_hint` | string | கையொப்ப ரகசியத்தின் முதல் 4 மற்றும் கடைசி 4 எழுத்துகள், நடுவில் முப்புள்ளியுடன் (`a1b2…9f0e`) — முழு மதிப்பை வெளிப்படுத்தாமல், நீங்கள் உள்ளூரில் சேமித்த ரகசியத்துடன் ஒப்பிடுவதற்கு போதுமானது |
| `created_at`, `updated_at` | timestamp | |

<Note>
  எண்ட்பாயிண்ட்டின் முழு `secret`, உருவாக்கும்போது **ஒருமுறை** மட்டுமே வழங்கப்படும்;
  அதன் பிறகு ஒருபோதும் வழங்கப்படாது. அதை பாதுகாப்பாகச் சேமியுங்கள் — அதை இழந்தால்,
  எண்ட்பாயிண்ட்டை நீக்கி மீண்டும் உருவாக்குங்கள்.
</Note>

### செல்லுபடியான நிகழ்வு வகைகள்

`events` இந்தத் துல்லியமான தொகுப்புடன் சரிபார்க்கப்படுகிறது — பட்டியலுக்கு வெளியே உள்ள
மதிப்புகள் `400` ஐ வழங்கும். ஒவ்வொரு வகையின் payload வடிவத்திற்கும்
[நிகழ்வுகளின் பட்டியலை](/ta/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` | string | ஆம் | 1–120 எழுத்துகள் |
| `url` | string | ஆம் | HTTPS URL (`localhost` / `127.0.0.1`க்கு மட்டும் `http` அனுமதிக்கப்படும்) |
| `events` | array | இல்லை | காலியாகவோ விடுபட்டோ இருந்தால், வெளிப்படையான சந்தா தேவைப்படும் `telephony.turn` / `web.turn` தவிர மற்ற அனைத்து நிகழ்வுகளுக்கும் சந்தா சேர்க்கப்படும். [செல்லுபடியான நிகழ்வு வகைகள்](#valid-event-types) பட்டியலிலுள்ள மதிப்புகளையே பயன்படுத்த வேண்டும்; நகல்கள் நீக்கப்படும் |
| `agent_id` | integer \| null | இல்லை | இந்த நிறுவனத்தில் உள்ள ஒரு ஏஜென்ட்டுக்கு டெலிவரியை வரம்பிடவும்; நிறுவனம் முழுவதற்குமான எண்ட்பாயிண்ட்டுக்கு விடுபடுத்தவும் அல்லது `null` பயன்படுத்தவும் |

[எண்ட்பாயிண்ட் ஆப்ஜெக்ட்](#endpoint-object) உடன் கூடுதலாக, மூல கையொப்ப விசையைக் கொண்ட மேல்நிலை `secret` புலத்துடன் `201 Created` வழங்கப்படும் — இது 48-எழுத்து hex சரம்:

```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` | string | |
| `url` | string | |
| `events` | array | |
| `status` | string | `active` அல்லது `disabled`. சர்வர் `failing` எனக் குறித்த எண்ட்பாயிண்ட்டை மீண்டும் செயல்படுத்த `active` என அமைக்கவும் |
| `agent_id` | integer \| null | எண்ட்பாயிண்ட்டை வரம்பிட ஒரு ஏஜென்ட் id அமைக்கவும் அல்லது அதை நிறுவனம் முழுவதற்குமானதாக மாற்ற `null` அமைக்கவும் |

புதுப்பிக்கப்பட்ட [எண்ட்பாயிண்ட் ஆப்ஜெக்டுடன்](#endpoint-object) `200 OK` வழங்கப்படும்.

---

## சோதனை டெலிவரியை அனுப்புங்கள்

நியமமான டெலிவரி பைப்லைனைப் பயன்படுத்தி ஒரு எண்ட்பாயிண்ட்டுக்கு செயற்கையான `webhook.test` நிகழ்வை அனுப்புங்கள். இதில் முறையான JSON வரிசைப்படுத்தல்,
`X-ThunderPhone-Signature`, டெலிவரி பதிவு மற்றும் மீண்டும் முயற்சிக்கும் கண்காணிப்பு ஆகியவை அடங்கும்.
தேர்ந்தெடுக்கப்பட்ட எண்ட்பாயிண்ட்டின் `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="/ta/webhooks/events">
    நீங்கள் சந்தா செய்யக்கூடிய முழுமையான `events` மதிப்புகளின் பட்டியல்.
  </Card>
  <Card title="வெப்ஹுக்குகள் கண்ணோட்டம்" icon="bolt" href="/ta/webhooks/overview">
    கையொப்பச் சரிபார்ப்பு மற்றும் டெலிவரி அர்த்தவியல்.
  </Card>
</CardGroup>