ವೆಬ್‌ಹುಕ್ ಎಂಡ್‌ಪಾಯಿಂಟ್‌ಗಳು

ಪ್ರತಿ ಎಂಡ್‌ಪಾಯಿಂಟ್‌ಗೆ ಪ್ರತ್ಯೇಕ ಸೀಕ್ರೆಟ್‌ಗಳು ಮತ್ತು ಈವೆಂಟ್ ಫಿಲ್ಟರ್‌ಗಳೊಂದಿಗೆ ಬಹು ವೆಬ್‌ಹುಕ್ 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 ಅನ್ನು ಹಿಂತಿರುಗಿಸುತ್ತವೆ. ಪ್ರತಿ ವಿಧದ ಪೇಲೋಡ್ ರಚನೆಗಾಗಿ ಈವೆಂಟ್ ಕ್ಯಾಟಲಾಗ್ ನೋಡಿ.

• 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-ಅಕ್ಷರಗಳ ಹೆಕ್ಸ್ ಸ್ಟ್ರಿಂಗ್ ಆಗಿದೆ:

{
  "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 ಚಂದಾದಾರಿಕೆಗೆ ಸೇರಿಸಲು ಸಾಧ್ಯವಿಲ್ಲ. ಮೊದಲ ಪ್ರಯತ್ನ ವಿಫಲವಾದರೆ, ವಿತರಣೆಯು ಸಾಮಾನ್ಯ ಈವೆಂಟ್ ವಿತರಣೆಗಳಂತೆಯೇ ಅದೇ ಮರುಪ್ರಯತ್ನ ವೇಳಾಪಟ್ಟಿಯನ್ನು ಅನುಸರಿಸುತ್ತದೆ.

ನಿಜವಾದ ಈವೆಂಟ್ ಆಕಾರಕ್ಕೆ ವಿರುದ್ಧವಾಗಿ ಟ್ರಿಗರ್ ಅನ್ನು ಕಾನ್ಫಿಗರ್ ಮಾಡಲು, ಐಚ್ಛಿಕ 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 ದೋಷಗಳು ಪ್ರಮಾಣಪತ್ರ ಸರಣಿ, ಹೋಸ್ಟ್‌ನಾಮ, ಅಥವಾ ಮುಕ್ತಾಯವನ್ನು ಸೂಚಿಸುತ್ತವೆ.

ಸಂಬಂಧಿತ#