Webhook எண்ட்பாயிண்ட்கள்

ஒவ்வொரு எண்ட்பாயிண்டிற்குமான ரகசியங்கள் மற்றும் நிகழ்வு வடிப்பான்களுடன் பல webhook URL-களை நிர்வகிக்கவும்.

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

பின்னோக்கி இணக்கத்தன்மைக்காக வைத்திருக்கும், ஆனால் ஒவ்வொரு நிறுவனத்திற்கும் ஒரு URL-ஐ மட்டுமே ஆதரிக்கும் பழைய ஒற்றை-URL webhook-உடன் ஒப்பிடுக.

எண்ட்பாயிண்ட்கள்#

எண்ட்பாயிண்ட் பொருள்#

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

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

events இந்தத் துல்லியமான தொகுப்புடன் சரிபார்க்கப்படுகிறது — பட்டியலுக்கு வெளியே உள்ள மதிப்புகள் 400 ஐ வழங்கும். ஒவ்வொரு வகையின் payload வடிவத்திற்கும் நிகழ்வுகளின் பட்டியலை பார்க்கவும்.

• 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 ஆக மாற்றுங்கள்; மீண்டும் முயற்சி அட்டவணை இன்னும் முடிவடையாத டெலிவரிகள், நிறுத்திய இடத்திலிருந்து தொடரும்.

எண்ட்பாயிண்ட்களைப் பட்டியலிடுங்கள்#

curl https://api.thunderphone.com/v1/developer/webhook-endpoints \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

எண்ட்பாயிண்ட் பொருள்களின் வரிசையை வழங்கும். அந்த ஏஜென்ட்டிற்கு வரம்பிடப்பட்ட எண்ட்பாயிண்ட்களை மட்டும் பெற ?agent_id=42 ஐ அனுப்புங்கள்.

ஏஜென்ட்-வரம்பிடப்பட்ட எண்ட்பாயிண்ட்கள்#

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

ஒரு எண்ட்பாயிண்ட்டை உருவாக்கவும்#

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"]
  }'

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"]

கோரிக்கை புலங்கள்#

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

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

ஒரு எண்ட்பாயிண்ட்டைப் புதுப்பிக்கவும்#

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"]
  }'

புதுப்பிக்கப்பட்ட எண்ட்பாயிண்ட் ஆப்ஜெக்டுடன் 200 OK வழங்கப்படும்.

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

நியமமான டெலிவரி பைப்லைனைப் பயன்படுத்தி ஒரு எண்ட்பாயிண்ட்டுக்கு செயற்கையான webhook.test நிகழ்வை அனுப்புங்கள். இதில் முறையான JSON வரிசைப்படுத்தல், X-ThunderPhone-Signature, டெலிவரி பதிவு மற்றும் மீண்டும் முயற்சிக்கும் கண்காணிப்பு ஆகியவை அடங்கும். தேர்ந்தெடுக்கப்பட்ட எண்ட்பாயிண்ட்டின் events வடிகட்டியைப் பொருட்படுத்தாமல் சோதனை அதையே இலக்காகக் கொள்கிறது.

curl -X POST https://api.thunderphone.com/v1/developer/webhook-endpoints/c4d5e6f7-.../test \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

எண்ட்பாயிண்ட் பின்வருவது போன்ற ஒரு உறையைப் பெறும்:

{
  "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 ஆகியவற்றைச் சரிபார்க்கவும்:

{
  "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-ஐப் பயன்படுத்தும்.

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, செல்லுபடியாகும் நிகழ்வு வகைகள் இலிருந்து எந்த மதிப்பையும் ஏற்கும். இதை விடுத்தால் பொதுவான webhook.test செயல்பாடு தொடரும்.

ஒரு எண்ட்பாயிண்ட்டை நீக்குங்கள்#

curl -X DELETE https://api.thunderphone.com/v1/developer/webhook-endpoints/c4d5e6f7-... \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

204 No Content-ஐத் திருப்பியளிக்கும். URL-க்கான டெலிவரி உடனடியாக நிறுத்தப்படும்; நடப்பிலுள்ள மீண்டும் முயற்சிகள் கைவிடப்படும்.

டெலிவரிகளை பிழைத்திருத்துங்கள்#

ஒரு வெப்ஹுக் அனுப்பப்படவில்லை என்று முடிவுசெய்வதற்கு முன், GET /v1/developer/webhook-deliveries-ஐச் சரிபார்க்கவும். அழைப்பு ஐடி, URL தோற்றம், HTTP நிலை, முயற்சி எண்ணிக்கை, அனுமதிப்பட்டியல் தோல்வி வகை மற்றும் அடுத்த மீண்டும் முயற்சிக்கும் நேரம் உட்பட, இரண்டு வெப்ஹுக் அமைப்புகளிலிருந்தும் சமீபத்திய முயற்சிகளை இது காட்டும். நிகழ்வு பேலோடு, டிரான்ஸ்கிரிப்ட், சேமிக்கப்பட்ட பிழை உரை, பதில் உடல் அல்லது URL பாதையை இது ஒருபோதும் திருப்பியளிக்காது.

அதே சமீபத்திய வரலாற்றை ஏஜென்ட்கள் → ஒரு ஏஜென்ட்டைத் தேர்ந்தெடுக்கவும் → வெப்ஹுக்குகள் → சமீபத்திய டெலிவரிகள் என்பதிலும் பார்க்கலாம். சமீபத்திய முயற்சி பயன்படுத்திய எண்ட்பாயிண்ட் லேபிளையும் URL தோற்றத்தையும் வரிசைகள் காட்டும். இது மாற்றமுடியாத ஆடிட் பதிவாக இல்லாமல் செயல்பாட்டு நிலையாகும்: ஒரு எண்ட்பாயிண்ட்டை நீக்குவது அதன் டெலிவரி வரிசைகளையும் நீக்கும்.

n8n 404-க்கு, முதலில் வொர்க்ஃப்ளோ செயலில் உள்ளதா, POST-ஐ ஏற்கிறதா, மற்றும் சோதனை URL-க்குப் பதிலாக தயாரிப்பு வெப்ஹுக் URL-ஐப் பயன்படுத்துகிறதா என்பதை உறுதிப்படுத்தவும். 401 அல்லது 403 அங்கீகாரம் அல்லது கையொப்பச் சரிபார்ப்பைக் குறிக்கிறது; நேரமுடிவுகள் இலக்கு தாமதம் அல்லது கிடைப்புத்தன்மையைக் குறிக்கின்றன; TLS பிழைகள் சான்றிதழ் சங்கிலி, ஹோஸ்ட்பெயர் அல்லது காலாவதியைக் குறிக்கின்றன.

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