Open in
ਵੈੱਬਹੁੱਕ ਐਂਡਪੌਇੰਟਸ
ਹਰ ਐਂਡਪੌਇੰਟ ਲਈ ਵੱਖਰੇ ਸੀਕ੍ਰੇਟਸ ਅਤੇ ਇਵੈਂਟ ਫਿਲਟਰਾਂ ਨਾਲ ਕਈ ਵੈੱਬਹੁੱਕ URLs ਦਾ ਪ੍ਰਬੰਧਨ ਕਰੋ।
ਐਂਡਪੌਇੰਟ-ਆਧਾਰਿਤ webhook ਸਿਸਟਮ ਤੁਹਾਨੂੰ ਪ੍ਰਤੀ ਸੰਗਠਨ ਕਈ ਟਿਕਾਣੇ ਰਜਿਸਟਰ ਕਰਨ ਦਿੰਦਾ ਹੈ, ਹਰ ਇੱਕ ਦਾ ਆਪਣਾ ਸੀਕ੍ਰੇਟ, ਆਪਣੀ ਸਥਿਤੀ, ਅਤੇ ਇਵੈਂਟ ਕਿਸਮਾਂ ਦੇ ਇੱਕ ਉਪਸੈੱਟ ਲਈ ਆਪਣੀ ਸਬਸਕ੍ਰਿਪਸ਼ਨ ਹੁੰਦੀ ਹੈ। ਇਹ ਸਾਰੀਆਂ ਨਵੀਆਂ ਇੰਟੀਗ੍ਰੇਸ਼ਨਾਂ ਲਈ ਸਿਫ਼ਾਰਸ਼ੀ ਮਾਡਲ ਹੈ।
ਇਸਦੀ ਪੁਰਾਣੇ ਸਿੰਗਲ-URL webhook ਨਾਲ ਤੁਲਨਾ ਕਰੋ, ਜੋ ਪਿਛਲੀ ਅਨੁਕੂਲਤਾ ਲਈ ਰੱਖਿਆ ਗਿਆ ਹੈ ਪਰ ਪ੍ਰਤੀ ਸੰਗਠਨ ਸਿਰਫ਼ ਇੱਕ 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 | ਐਂਡਪੌਇੰਟ ID |
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 ਵਾਪਸ ਕਰਦੇ ਹਨ। ਹਰ ਕਿਸਮ ਦੀ payload ਬਣਤਰ ਲਈ ਇਵੈਂਟ ਕੈਟਾਲੌਗ ਵੇਖੋ।
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— ਜਦੋਂ ਐਂਡਪੌਇੰਟ ਨੂੰ ਡਿਲਿਵਰੀ ਆਪਣੀ ਪੂਰੀ ਰੀਟ੍ਰਾਈ ਸਮਾਂ-ਸਾਰਣੀ (24 ਘੰਟਿਆਂ ਵਿੱਚ 8 ਕੋਸ਼ਿਸ਼ਾਂ) ਖਤਮ ਕਰ ਦੇਵੇ ਅਤੇ ਕਦੇ ਵੀ 2xx ਨਾ ਮਿਲੇ, ਤਾਂ ਇਹ ਆਪਣੇ ਆਪ ਸੈੱਟ ਹੋ ਜਾਂਦਾ ਹੈ। ਫੇਲ ਹੋ ਰਹੇ ਐਂਡਪੌਇੰਟ ਨੂੰ ਅੱਗੇ ਕੋਈ ਟ੍ਰੈਫ਼ਿਕ ਨਹੀਂ ਮਿਲਦਾ। ਅਜਿਹਾ ਹੋਣ 'ਤੇ ਅਸੀਂ ਤੁਹਾਡੀ ਸੰਸਥਾ ਦੇ ਮਾਲਕਾਂ ਅਤੇ ਐਡਮਿਨਾਂ ਨੂੰ ਈਮੇਲ ਕਰਦੇ ਹਾਂ, ਅਤੇ ਡੈਸ਼ਬੋਰਡ ਰੋਕੇ ਹੋਏ ਐਂਡਪੌਇੰਟ ਨੂੰ ਮੁੜ-ਸਰਗਰਮ ਕਰੋ ਬਟਨ ਨਾਲ ਦਿਖਾਉਂਦਾ ਹੈ। ਐਂਡਪੌਇੰਟ ਠੀਕ ਹੋ ਜਾਣ 'ਤੇ,PATCHਰਾਹੀਂ ਇਸਦੀ ਸਥਿਤੀ ਮੁੜactiveਕਰੋ; ਜਿਨ੍ਹਾਂ ਡਿਲਿਵਰੀਆਂ ਦੀ ਰੀਟ੍ਰਾਈ ਸਮਾਂ-ਸਾਰਣੀ ਹਾਲੇ ਖਤਮ ਨਹੀਂ ਹੋਈ, ਉਹ ਉੱਥੋਂ ਹੀ ਮੁੜ ਸ਼ੁਰੂ ਹੋਣਗੀਆਂ ਜਿੱਥੇ ਰੁਕੀਆਂ ਸਨ।
ਐਂਡਪੌਇੰਟਾਂ ਦੀ ਸੂਚੀ
curl https://api.thunderphone.com/v1/developer/webhook-endpoints \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"ਐਂਡਪੌਇੰਟ ਆਬਜੈਕਟਾਂ ਦੀ array ਵਾਪਸ ਕਰਦਾ ਹੈ।
ਸਿਰਫ਼ ਉਸ ਏਜੰਟ ਲਈ ਸੀਮਿਤ ਐਂਡਪੌਇੰਟ ਵਾਪਸ ਕਰਨ ਲਈ ?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 ਵਰਤੋ |
ਐਂਡਪੌਇੰਟ ਆਬਜੈਕਟ ਦੇ ਨਾਲ 201 Created ਅਤੇ
ਇੱਕ ਵਾਧੂ ਸਿਖਰਲੇ-ਪੱਧਰ ਦੀ secret ਫੀਲਡ ਮਿਲਦੀ ਹੈ, ਜਿਸ ਵਿੱਚ ਕੱਚੀ ਸਾਈਨਿੰਗ ਕੁੰਜੀ ਹੁੰਦੀ ਹੈ — ਇੱਕ
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 ਵਾਪਸ ਮਿਲਦਾ ਹੈ।
ਸਾਈਨਿੰਗ ਸੀਕ੍ਰੇਟ ਰੋਟੇਟ ਕਰੋ
ਕਿਸੇ endpoint ਦਾ signing secret ਬਦਲੋ, ਉਦਾਹਰਨ ਲਈ ਜਦੋਂ ਇਹ ਗੁੰਮ ਹੋ ਗਿਆ ਹੋਵੇ ਜਾਂ ਲੀਕ ਹੋ ਸਕਦਾ ਹੋਵੇ। ਤੁਸੀਂ dashboard ਵੀ ਵਰਤ ਸਕਦੇ ਹੋ: endpoint ਨੂੰ ਇੰਟੀਗ੍ਰੇਸ਼ਨਜ਼ → ਵੈੱਬਹੁੱਕਸ ਹੇਠਾਂ ਖੋਲ੍ਹੋ (ਸੰਗਠਨ-ਪੱਧਰੀ ਅਤੇ ਏਜੰਟ endpoints ਦੋਵੇਂ ਉੱਥੇ ਸੂਚੀਬੱਧ ਹਨ) ਅਤੇ ਰੋਟੇਟ ਚੁਣੋ।
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 ਗਲਤੀਆਂ ਸਰਟੀਫਿਕੇਟ ਚੇਨ, ਹੋਸਟਨਾਮ ਜਾਂ ਮਿਆਦ ਪੁੱਗਣ ਵੱਲ ਇਸ਼ਾਰਾ ਕਰਦੀਆਂ ਹਨ।