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

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

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

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

எண்ட்பாயிண்ட் ஆப்ஜெக்ட்

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

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

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

• telephony.incoming, telephony.complete, telephony.tool
• web.incoming, web.complete, web.tool
• call.graded
• issue.reported
• test-call.completed
• alert.triggered

எண்ட்பாயிண்ட் நிலைகள்

• active — டெலிவரிகள் வழக்கம்போல் நடைபெறும்.
• disabled — PATCH மூலம் கைமுறையாக இடைநிறுத்தப்பட்டது. கோரிக்கைகள் எதுவும் அனுப்பப்படாது. disabled எண்ட்பாயிண்ட்டின் நிலையை நாங்கள் ஒருபோதும் மாற்றமாட்டோம்; அதை மீண்டும் active-ஆக மாற்றுவது எப்போதும் உங்கள் முடிவாகும்.
• failing — எண்ட்பாயிண்ட்டுக்கான ஒரு டெலிவரி அதன் முழு மீண்டும் முயற்சி அட்டவணையை (24 மணி நேரத்தில் 8 முயற்சிகள்) ஒரு 2xx கூட பெறாமல் முடித்தால் தானாக அமைக்கப்படும். தோல்வியுறும் எண்ட்பாயிண்ட் மேலும் எந்த டிராஃபிக்கையும் பெறாது. எண்ட்பாயிண்ட் சரிசெய்யப்பட்டதும், அதன் நிலையை மீண்டும் active-ஆக PATCH செய்யவும்; மீண்டும் முயற்சி அட்டவணை இன்னும் முடிவடையாத டெலிவரிகள், விட்ட இடத்திலிருந்து தொடரும்.

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

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

எண்ட்பாயிண்ட் ஆப்ஜெக்ட்களின் array-ஐத் திருப்பி அனுப்பும்.

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

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 திருப்பியளிக்கிறது.

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

கேனானிக்கல் JSON சீரியலைசேஷன், X-ThunderPhone-Signature, டெலிவரி பதிவு மற்றும் மீண்டும் முயற்சிக்கும் கண்காணிப்பு உட்பட, வழக்கமான டெலிவரி பைப்லைனைப் பயன்படுத்தி ஒரு எண்ட்பாயிண்ட்டுக்கு செயற்கையான webhook.test நிகழ்வை அனுப்பவும். சோதனை, தேர்ந்தெடுக்கப்பட்ட எண்ட்பாயிண்ட்டின் 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 சந்தாவில் சேர்க்க முடியாது. முதல் முயற்சி தோல்வியடைந்தால், டெலிவரி வழக்கமான நிகழ்வு டெலிவரிகளுக்கான அதே மீண்டும் முயற்சி அட்டவணையைப் பின்பற்றும்.

எண்ட்பாயிண்ட்டை நீக்கவும்

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

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

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