Open in
ವೆಬ್ಹುಕ್ ಎಂಡ್ಪಾಯಿಂಟ್ಗಳು
ಪ್ರತಿ ಎಂಡ್ಪಾಯಿಂಟ್ಗೆ ಪ್ರತ್ಯೇಕ ಸೀಕ್ರೆಟ್ಗಳು ಮತ್ತು ಈವೆಂಟ್ ಫಿಲ್ಟರ್ಗಳೊಂದಿಗೆ ಹಲವು ವೆಬ್ಹುಕ್ URLಗಳನ್ನು ನಿರ್ವಹಿಸಿ.
ಎಂಡ್ಪಾಯಿಂಟ್-ಆಧಾರಿತ ವೆಬ್ಹುಕ್ ವ್ಯವಸ್ಥೆಯು ಪ್ರತಿ ಸಂಸ್ಥೆಗೆ ಬಹು ಗಮ್ಯಸ್ಥಾನಗಳನ್ನು ನೋಂದಾಯಿಸಲು ನಿಮಗೆ ಅನುಮತಿಸುತ್ತದೆ; ಪ್ರತಿಯೊಂದಕ್ಕೂ ತನ್ನದೇ ರಹಸ್ಯ, ತನ್ನದೇ ಸ್ಥಿತಿ ಮತ್ತು ಈವೆಂಟ್ ಪ್ರಕಾರಗಳ ಉಪವಿಭಾಗಕ್ಕೆ ತನ್ನದೇ ಚಂದಾದಾರಿಕೆ ಇರುತ್ತದೆ. ಎಲ್ಲಾ ಹೊಸ ಏಕೀಕರಣಗಳಿಗೆ ಇದು ಶಿಫಾರಸು ಮಾಡಲಾದ ಮಾದರಿಯಾಗಿದೆ.
ಹಿಂಬದಿ ಹೊಂದಾಣಿಕೆಗಾಗಿ ಉಳಿಸಲಾಗಿರುವ, ಆದರೆ ಪ್ರತಿ ಸಂಸ್ಥೆಗೆ ಕೇವಲ ಒಂದು URL ಅನ್ನು ಬೆಂಬಲಿಸುವ ಲೆಗಸಿ ಏಕ-URL ವೆಬ್ಹುಕ್ ಜೊತೆಗೆ ಹೋಲಿಸಿ.
ಎಂಡ್ಪಾಯಿಂಟ್ಗಳು
| ವಿಧಾನ | ಪಥ | ಅಗತ್ಯ ಪಾತ್ರ | ವಿವರಣೆ |
|---|---|---|---|
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}/rotate-secret | admin+ | ಸೈನಿಂಗ್ ಸೀಕ್ರೆಟ್ ಬದಲಾಯಿಸಿ |
POST | /v1/developer/webhook-endpoints/{endpoint_id}/test | admin+ | ಸೈನ್ ಮಾಡಲಾದ ಪರೀಕ್ಷಾ ಡೆಲಿವರಿ ಕಳುಹಿಸಿ |
GET | /v1/developer/webhook-deliveries | admin+ | ಇತ್ತೀಚಿನ ಎಂಡ್ಪಾಯಿಂಟ್ ಮತ್ತು ಲೆಗಸಿ ಡೆಲಿವರಿ ಫಲಿತಾಂಶಗಳನ್ನು ಪರಿಶೀಲಿಸಿ |
ಎಂಡ್ಪಾಯಿಂಟ್ ಆಬ್ಜೆಕ್ಟ್
{
"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",
"paused_at": null,
"pause_last_error": "",
"pause_undelivered_count": null,
"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 | ಸ್ಟ್ರಿಂಗ್ನ ಅರೇ | ಚಂದಾದಾರಗೊಂಡ ಈವೆಂಟ್ ವಿಧಗಳು (ಮಾನ್ಯ ಮೌಲ್ಯಗಳನ್ನು ನೋಡಿ). ಖಾಲಿ ಅರೇ ಸ್ಪಷ್ಟ-ಮಾತ್ರ ಈವೆಂಟ್ಗಳನ್ನು ಹೊರತುಪಡಿಸಿ ಎಲ್ಲಾ ಈವೆಂಟ್ಗಳಿಗೆ ಚಂದಾದಾರಗೊಳ್ಳುತ್ತದೆ (telephony.turn / web.turn / call.status_changed) |
status | ಸ್ಟ್ರಿಂಗ್ | active, disabled (ಕೈಯಾರೆ ವಿರಾಮಗೊಳಿಸಲಾಗಿದೆ), ಅಥವಾ failing (ಒಂದೇ ಒಂದು 2xx ಇಲ್ಲದೆ ವಿತರಣೆಯು ತನ್ನ 24 ಗಂಟೆಗಳ ಮರುಪ್ರಯತ್ನ ವೇಳಾಪಟ್ಟಿಯನ್ನು ಪೂರ್ಣಗೊಳಿಸಿದಾಗ ಸ್ವಯಂಚಾಲಿತವಾಗಿ ಹೊಂದಿಸಲಾಗುತ್ತದೆ) |
agent_id | ಪೂರ್ಣಾಂಕ | null | ಈ ಎಂಡ್ಪಾಯಿಂಟ್ನ ವ್ಯಾಪ್ತಿಯಲ್ಲಿರುವ ಏಜೆಂಟ್; null ಎಂದರೆ ಸಂಸ್ಥೆಯಾದ್ಯಂತ |
agent_name | ಸ್ಟ್ರಿಂಗ್ | null | ವ್ಯಾಪ್ತಿಯಲ್ಲಿರುವ ಏಜೆಂಟ್ನ ಹೆಸರು, ಅಥವಾ ಸಂಸ್ಥೆಯಾದ್ಯಂತದ ಎಂಡ್ಪಾಯಿಂಟ್ಗೆ null |
secret_hint | ಸ್ಟ್ರಿಂಗ್ | ಎಲಿಪ್ಸಿಸ್ನೊಂದಿಗೆ ಸಹಿ ಸೀಕ್ರೆಟ್ನ ಮೊದಲ 4 ಮತ್ತು ಕೊನೆಯ 4 ಅಕ್ಷರಗಳು (a1b2…9f0e) — ಸಂಪೂರ್ಣ ಮೌಲ್ಯವನ್ನು ಬಹಿರಂಗಪಡಿಸದೆ ನೀವು ಸ್ಥಳೀಯವಾಗಿ ಉಳಿಸಿದ ಸೀಕ್ರೆಟ್ಅನ್ನು ಅಡ್ಡ-ಉಲ್ಲೇಖಿಸಲು ಸಾಕಾಗುತ್ತದೆ |
paused_at | ಟೈಮ್ಸ್ಟ್ಯಾಂಪ್ | null | ThunderPhone ಎಂಡ್ಪಾಯಿಂಟ್ ಅನ್ನು failing ಗೆ ಹೊಂದಿಸಿದ ಸಮಯ. ಅದು active ಅಥವಾ disabled ಆಗಿರುವಾಗ null |
pause_last_error | ಸ್ಟ್ರಿಂಗ್ | ಎಂಡ್ಪಾಯಿಂಟ್ ವಿರಾಮಗೊಳಿಸಿದಾಗಿನ ಕೊನೆಯ ವಿತರಣಾ ದೋಷ, ಉದಾಹರಣೆಗೆ HTTP 503: Service Unavailable. failing ಅಲ್ಲದಿದ್ದರೆ ಖಾಲಿಯಾಗಿರುತ್ತದೆ |
pause_undelivered_count | ಪೂರ್ಣಾಂಕ | null | ಎಂಡ್ಪಾಯಿಂಟ್ನ ಕೊನೆಯ ಯಶಸ್ವಿ ವಿತರಣೆಯ ನಂತರ ವಿತರಿಸದ ಈವೆಂಟ್ಗಳು, ಅದನ್ನು ವಿರಾಮಗೊಳಿಸಿದಾಗ ಎಣಿಸಲಾಗುತ್ತದೆ |
created_at, updated_at | ಟೈಮ್ಸ್ಟ್ಯಾಂಪ್ |
ಮಾನ್ಯ ಈವೆಂಟ್ ವಿಧಗಳು
events ಅನ್ನು ಈ ನಿಖರ ಸೆಟ್ಗೆ ವಿರುದ್ಧವಾಗಿ ಪರಿಶೀಲಿಸಲಾಗುತ್ತದೆ — ಪಟ್ಟಿಯ ಹೊರಗಿನ ಮೌಲ್ಯಗಳು
400 ಅನ್ನು ಹಿಂತಿರುಗಿಸುತ್ತವೆ. ಪ್ರತಿ ವಿಧದ ಪೇಲೋಡ್ ಆಕಾರಕ್ಕಾಗಿ ಈವೆಂಟ್ ಕ್ಯಾಟಲಾಗ್ ನೋಡಿ.
telephony.incoming,telephony.complete,telephony.tool,telephony.turnweb.incoming,web.complete,web.tool,web.turnsms.sent,sms.failedsms.received(ಕಾಯ್ದಿರಿಸಲಾಗಿದೆ; ಇನ್ನೂ ಹೊರಸೂಸಲಾಗಿಲ್ಲ)scheduled.skipped,scheduled.failedcall.graded,call.data_extracted,call.transfer_completed,call.status_changedcampaign.completedissue.reported,issue.escalatedtest-call.completedalert.triggeredphone_number.spam_risk_changed
issue.escalated ಮತ್ತು phone_number.spam_risk_changed ಗೆ ಏಜೆಂಟ್ ಸಂದರ್ಭವಿಲ್ಲ ಮತ್ತು
ಅವುಗಳನ್ನು ಸಂಸ್ಥೆ-ವ್ಯಾಪಿ ಎಂಡ್ಪಾಯಿಂಟ್ಗಳಿಗೆ ಮಾತ್ರ ತಲುಪಿಸಲಾಗುತ್ತದೆ.
voice.ready ಮತ್ತು voice.failed ಅನ್ನು ಸ್ಪಷ್ಟವಾಗಿ ಆಯ್ಕೆಮಾಡಲು ಸಾಧ್ಯವಿಲ್ಲ. ಅವುಗಳನ್ನು ಸ್ವೀಕರಿಸಲು events: [] ಹೊಂದಿರುವ ಸಂಸ್ಥೆ-ವ್ಯಾಪಿ ಎಂಡ್ಪಾಯಿಂಟ್ ರಚಿಸಿ. ಖಾಲಿ ಈವೆಂಟ್ ಪಟ್ಟಿ, ಸ್ಪಷ್ಟವಾಗಿ ಆಯ್ಕೆಮಾಡಬೇಕಾದ telephony.turn, web.turn ಮತ್ತು call.status_changed ಹೊರತುಪಡಿಸಿ, ಬೆಂಬಲಿತ ಪ್ರತಿಯೊಂದು ಈವೆಂಟ್ ಅನ್ನು ಸ್ವೀಕರಿಸುತ್ತದೆ.
ಎಂಡ್ಪಾಯಿಂಟ್ ಸ್ಥಿತಿಗಳು
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"]ವಿನಂತಿ ಕ್ಷೇತ್ರಗಳು
| ಕ್ಷೇತ್ರ | ಪ್ರಕಾರ | ಅಗತ್ಯವಿದೆ | ವಿವರಣೆ |
|---|---|---|---|
label | ಸ್ಟ್ರಿಂಗ್ | ಹೌದು | 1–120 ಅಕ್ಷರಗಳು |
url | ಸ್ಟ್ರಿಂಗ್ | ಹೌದು | HTTPS URL (http ಅನ್ನು localhost / 127.0.0.1 ಗಾಗಿ ಮಾತ್ರ ಅನುಮತಿಸಲಾಗಿದೆ) |
events | ಅರೆ | ಇಲ್ಲ | ಖಾಲಿ/ಬಿಟ್ಟುಹೋದರೆ telephony.turn / web.turn / call.status_changed ಹೊರತುಪಡಿಸಿ ಎಲ್ಲ ಈವೆಂಟ್ಗಳಿಗೆ ಚಂದಾದಾರಿಕೆಯಾಗುತ್ತದೆ; ಇವುಗಳಿಗೆ ಸ್ಪಷ್ಟ ಚಂದಾದಾರಿಕೆ ಅಗತ್ಯವಿದೆ. ಮಾನ್ಯ ಈವೆಂಟ್ ಪ್ರಕಾರಗಳು ನಲ್ಲಿ ಪಟ್ಟಿ ಮಾಡಲಾದ ಮೌಲ್ಯಗಳನ್ನು ಬಳಸಬೇಕು; ನಕಲುಗಳನ್ನು ತೆಗೆದುಹಾಕಲಾಗುತ್ತದೆ |
agent_id | ಪೂರ್ಣಾಂಕ | null | ಇಲ್ಲ | ಈ ಸಂಸ್ಥೆಯಲ್ಲಿರುವ ಏಜೆಂಟ್ಗೆ ವಿತರಣೆಯನ್ನು ಸೀಮಿತಗೊಳಿಸಿ; ಸಂಸ್ಥೆ-ವ್ಯಾಪಿ ಎಂಡ್ಪಾಯಿಂಟ್ಗಾಗಿ ಬಿಟ್ಟುಬಿಡಿ ಅಥವಾ null ಬಳಸಿ |
ಎಂಡ್ಪಾಯಿಂಟ್ ಆಬ್ಜೆಕ್ಟ್ ಜೊತೆಗೆ
ಕಚ್ಚಾ ಸೈನಿಂಗ್ ಕೀಯನ್ನು ಹೊಂದಿರುವ ಹೆಚ್ಚುವರಿ ಮೇಲ್ಮಟ್ಟದ 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"]
}'| ಕ್ಷೇತ್ರ | ವಿಧ | ವಿವರಣೆ |
|---|---|---|
label | ಸ್ಟ್ರಿಂಗ್ | |
url | ಸ್ಟ್ರಿಂಗ್ | |
events | ಅರೇ | |
status | ಸ್ಟ್ರಿಂಗ್ | active ಅಥವಾ disabled. ಸರ್ವರ್ failing ಎಂದು ಗುರುತಿಸಿದ ಎಂಡ್ಪಾಯಿಂಟ್ ಅನ್ನು ಮರು-ಸಕ್ರಿಯಗೊಳಿಸಲು active ಹೊಂದಿಸಿ |
agent_id | ಇಂಟೀಜರ್ | ನಲ್ | ಎಂಡ್ಪಾಯಿಂಟ್ ಅನ್ನು ಸೀಮಿತಗೊಳಿಸಲು ಏಜೆಂಟ್ ಐಡಿಯನ್ನು ಹೊಂದಿಸಿ, ಅಥವಾ ಅದನ್ನು ಸಂಸ್ಥೆ-ವ್ಯಾಪಿಯಾಗಿಸಲು null ಹೊಂದಿಸಿ |
ನವೀಕರಿಸಲಾದ ಎಂಡ್ಪಾಯಿಂಟ್ ಆಬ್ಜೆಕ್ಟ್ ಜೊತೆಗೆ 200 OK ಅನ್ನು ಹಿಂತಿರುಗಿಸುತ್ತದೆ.
ಸಹಿ ರಹಸ್ಯವನ್ನು ಬದಲಾಯಿಸಿ
ಎಂಡ್ಪಾಯಿಂಟ್ನ ಸಹಿ ರಹಸ್ಯವನ್ನು ಬದಲಾಯಿಸಿ, ಉದಾಹರಣೆಗೆ ಅದು ಕಳೆದುಹೋಗಿದ್ದಾಗ ಅಥವಾ ಬಹಿರಂಗಗೊಂಡಿರಬಹುದಾದಾಗ. ನೀವು ಡ್ಯಾಶ್ಬೋರ್ಡ್ ಅನ್ನೂ ಬಳಸಬಹುದು: ಎಂಡ್ಪಾಯಿಂಟ್ ಅನ್ನು ಸಂಯೋಜನೆಗಳು → ವೆಬ್ಹುಕ್ಗಳು ಅಡಿಯಲ್ಲಿ ತೆರೆಯಿರಿ (ಸಂಸ್ಥೆಯಾದ್ಯಂತದ ಮತ್ತು ಏಜೆಂಟ್ ಎಂಡ್ಪಾಯಿಂಟ್ಗಳೆರಡೂ ಅಲ್ಲಿ ಪಟ್ಟಿ ಮಾಡಲ್ಪಟ್ಟಿರುತ್ತವೆ) ಮತ್ತು ತಿರುಗಿಸಿ ಆಯ್ಕೆಮಾಡಿ.
curl -X POST https://api.thunderphone.com/v1/developer/webhook-endpoints/c4d5e6f7-.../rotate-secret \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'| ಕ್ಷೇತ್ರ | ವಿಧ | ಅಗತ್ಯವಿದೆಯೇ | ವಿವರಣೆ |
|---|---|---|---|
include_copies | ಬೂಲಿಯನ್ | ಇಲ್ಲ | ಡೀಫಾಲ್ಟ್ true. ಇದೇ URL ಮತ್ತು ಇದೇ ಪ್ರಸ್ತುತ ರಹಸ್ಯವನ್ನು ಹೊಂದಿರುವ ನಿಮ್ಮ ಸಂಸ್ಥೆಯ ಇತರ ಎಂಡ್ಪಾಯಿಂಟ್ಗಳಿಗೂ ಹೊಸ ರಹಸ್ಯವನ್ನು ನೀಡುತ್ತದೆ; ಉದಾಹರಣೆಗೆ ಇತರ ಏಜೆಂಟ್ಗಳಲ್ಲಿರುವ ಈ ಎಂಡ್ಪಾಯಿಂಟ್ನ ಪ್ರತಿಗಳು. ಇದರಿಂದ ಒಂದು ರಿಸೀವರ್ ಒಂದೇ ರಹಸ್ಯದೊಂದಿಗೆ ಪರಿಶೀಲನೆಯನ್ನು ಮುಂದುವರಿಸಬಹುದು |
200 OK ಅನ್ನು ಹಿಂತಿರುಗಿಸುತ್ತದೆ:
{
"endpoint": { "id": "c4d5e6f7-...", "secret_hint": "7f3a…c21d", "...": "..." },
"secret": "7f3a90b2c4d5e6f708192a3b4c5d6e7f8091a2b3c4d5c21d",
"rotated_endpoint_ids": ["c4d5e6f7-..."]
}| ಕ್ಷೇತ್ರ | ವಿಧ | ವಿವರಣೆ |
|---|---|---|
endpoint | ಆಬ್ಜೆಕ್ಟ್ | ಅದರ ಹೊಸ secret_hint ಹೊಂದಿರುವ ಎಂಡ್ಪಾಯಿಂಟ್ ಆಬ್ಜೆಕ್ಟ್ |
secret | ಸ್ಟ್ರಿಂಗ್ | ಹೊಸ ಸಹಿ ರಹಸ್ಯ. ಈ ಪ್ರತಿಕ್ರಿಯೆಯಲ್ಲಿ ಮಾತ್ರ ಹಿಂತಿರುಗಿಸಲಾಗುತ್ತದೆ |
rotated_endpoint_ids | UUID ಗಳ ಸರಣಿ | ಈಗ ಹೊಸ ರಹಸ್ಯವನ್ನು ಬಳಸುವ ಪ್ರತಿಯೊಂದು ಎಂಡ್ಪಾಯಿಂಟ್ |
ಪರೀಕ್ಷಾ ವಿತರಣೆಯನ್ನು ಕಳುಹಿಸಿ
ಸಾಮಾನ್ಯ ವಿತರಣಾ ಪೈಪ್ಲೈನ್ ಬಳಸಿ ಒಂದು ಎಂಡ್ಪಾಯಿಂಟ್ಗೆ ಕೃತಕ webhook.test ಈವೆಂಟ್ ಕಳುಹಿಸಿ. ಇದರಲ್ಲಿ ಪ್ರಮಾಣಿತ JSON ಸೀರಿಯಲೈಸೇಶನ್, ಎರಡೂ ಸಹಿ ಹೆಡರ್ಗಳು, ವಿತರಣಾ ದಾಖಲೀಕರಣ ಮತ್ತು ಮರುಪ್ರಯತ್ನದ ಲೆಕ್ಕಪತ್ರ ಒಳಗೊಂಡಿರುತ್ತದೆ.
ಪರೀಕ್ಷೆಯು ಆಯ್ಕೆಮಾಡಿದ ಎಂಡ್ಪಾಯಿಂಟ್ನ 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
ಚಂದಾದಾರಿಕೆಗೆ ಸೇರಿಸಲಾಗುವುದಿಲ್ಲ. ಮೊದಲ ಪ್ರಯತ್ನ ವಿಫಲವಾದರೆ, ThunderPhone ಸುಮಾರು
ಒಂದು ನಿಮಿಷದ ನಂತರ ಅದನ್ನು ಒಮ್ಮೆ ಮರುಪ್ರಯತ್ನಿಸಿ ನಂತರ ನಿಲ್ಲಿಸುತ್ತದೆ; ವಿತರಣೆಯು ನಂತರ
ವಿತರಣೆಯ ದೋಷನಿವಾರಣೆ ಅಡಿಯಲ್ಲಿ status: "failed" ಎಂದು ತೋರಿಸುತ್ತದೆ.
ಪರೀಕ್ಷಾ ವಿತರಣೆಯು ಎಂಡ್ಪಾಯಿಂಟ್ ಅನ್ನು ಎಂದಿಗೂ failing ಎಂದು ಗುರುತಿಸುವುದಿಲ್ಲ.
ನೈಜ ಈವೆಂಟ್ ರಚನೆಯ ವಿರುದ್ಧ ಟ್ರಿಗರ್ ಅನ್ನು ಕಾನ್ಫಿಗರ್ ಮಾಡಲು, ಐಚ್ಛಿಕ
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 ವರ್ತನೆ ಉಳಿಯುತ್ತದೆ.
ಕರೆ-ಪೂರ್ಣ (telephony.complete, web.complete) ಮತ್ತು call.data_extracted
ಮಾದರಿಗಳು, ನೈಜ ಕರೆಗಳು ಮಾಡುವಂತೆಯೇ, ಸ್ಥಾನಪೂರಕ ಮೌಲ್ಯಗಳೊಂದಿಗೆ ಏಜೆಂಟ್ನ ಸ್ವಂತ ಡೇಟಾ-ಸಂಗ್ರಹಿಸಬೇಕಾದ ಕ್ಷೇತ್ರಗಳನ್ನು
extracted_data.fields ಅಡಿಯಲ್ಲಿ ಒಳಗೊಂಡಿರುತ್ತವೆ. ಯಾವುದೇ ಡೇಟಾವನ್ನು ಸಂಗ್ರಹಿಸದ ಏಜೆಂಟ್ಗಾಗಿ, ಕರೆ-ಪೂರ್ಣ ಮಾದರಿಯು
ನೈಜ ಕರೆಗಳು ಮಾಡುವಂತೆಯೇ extracted_data: null ಅನ್ನು ಕಳುಹಿಸುತ್ತದೆ ಮತ್ತು call.data_extracted
ಮಾದರಿಯು ಖಾಲಿ fields ಹೊಂದಿರುತ್ತದೆ (ಅಂತಹ ಏಜೆಂಟ್ಗೆ ನೈಜ ಕರೆಗಳು ಆ ಈವೆಂಟ್ ಅನ್ನು ಎಂದಿಗೂ ಕಳುಹಿಸುವುದಿಲ್ಲ).
ಏಜೆಂಟ್ನ ಕರೆ ಸಾರಾಂಶವನ್ನು ನಿಷ್ಕ್ರಿಯಗೊಳಿಸಿದಾಗ ಮಾದರಿಯ summary null ಆಗಿರುತ್ತದೆ. ಏಜೆಂಟ್ನ
ಎಂಡ್ಪಾಯಿಂಟ್ನಲ್ಲಿ ಮಾದರಿಯು ಆ ಏಜೆಂಟ್ ಅನ್ನು ಅನುಸರಿಸುತ್ತದೆ; ಸಂಸ್ಥೆ-ವ್ಯಾಪಿ ಎಂಡ್ಪಾಯಿಂಟ್ನಲ್ಲಿ,
ಒಬ್ಬ ಏಜೆಂಟ್ಗೆ ಅನುಗುಣವಾಗಿ ಅದನ್ನು ರೂಪಿಸಲು ಐಚ್ಛಿಕ agent_id ಅನ್ನು ಒದಗಿಸಿ ಅಥವಾ ಸಾಮಾನ್ಯ ಮಾದರಿಗಾಗಿ ಅದನ್ನು ಬಿಟ್ಟುಬಿಡಿ.
ಎಂಡ್ಪಾಯಿಂಟ್ ಅಳಿಸಿ
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 ದೋಷಗಳು ಪ್ರಮಾಣಪತ್ರ ಸರಪಳಿ, ಹೋಸ್ಟ್ಹೆಸರು, ಅಥವಾ ಅವಧಿ ಮುಗಿದಿರುವುದನ್ನು ಸೂಚಿಸುತ್ತವೆ.