ਵੈੱਬਹੁੱਕ ਐਂਡਪੌਇੰਟਸ

ਹਰ ਐਂਡਪੌਇੰਟ ਲਈ ਸੀਕ੍ਰੇਟਸ ਅਤੇ ਇਵੈਂਟ ਫਿਲਟਰਾਂ ਨਾਲ ਕਈ ਵੈੱਬਹੁੱਕ URLs ਦਾ ਪ੍ਰਬੰਧਨ ਕਰੋ।

ਐਂਡਪੌਇੰਟ-ਆਧਾਰਿਤ webhook ਸਿਸਟਮ ਤੁਹਾਨੂੰ ਹਰ ਸੰਸਥਾ ਲਈ ਕਈ ਟਿਕਾਣੇ ਰਜਿਸਟਰ ਕਰਨ ਦਿੰਦਾ ਹੈ, ਹਰੇਕ ਦਾ ਆਪਣਾ secret, ਆਪਣੀ ਸਥਿਤੀ, ਅਤੇ event ਕਿਸਮਾਂ ਦੇ ਇੱਕ ਉਪ-ਸਮੂਹ ਲਈ ਆਪਣੀ subscription ਹੁੰਦੀ ਹੈ। ਇਹ ਸਾਰੀਆਂ ਨਵੀਆਂ integrations ਲਈ ਸਿਫਾਰਸ਼ੀ ਮਾਡਲ ਹੈ।

ਇਸਦੀ ਤੁਲਨਾ ਪੁਰਾਣੇ ਇੱਕਲ-URL webhook ਨਾਲ ਕਰੋ, ਜੋ ਪਿੱਛੇ ਵੱਲ ਅਨੁਕੂਲਤਾ ਲਈ ਰੱਖਿਆ ਗਿਆ ਹੈ ਪਰ ਹਰ ਸੰਸਥਾ ਲਈ ਸਿਰਫ਼ ਇੱਕ URL ਦਾ ਸਮਰਥਨ ਕਰਦਾ ਹੈ।

ਐਂਡਪੌਇੰਟ#

ਐਂਡਪੌਇੰਟ ਆਬਜੈਕਟ#

{
  "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 — ਜਦੋਂ ਐਂਡਪੌਇੰਟ ਲਈ ਡਿਲਿਵਰੀ ਆਪਣਾ ਪੂਰਾ ਰੀਟ੍ਰਾਈ ਸ਼ਡਿਊਲ (24 ਘੰਟਿਆਂ ਵਿੱਚ 8 ਕੋਸ਼ਿਸ਼ਾਂ) ਵਰਤ ਲੈਂਦੀ ਹੈ ਅਤੇ ਇੱਕ ਵੀ 2xx ਪ੍ਰਾਪਤ ਨਹੀਂ ਕਰਦੀ, ਤਾਂ ਆਪਣੇ ਆਪ ਸੈੱਟ ਹੁੰਦਾ ਹੈ। ਫੇਲ ਹੋ ਰਿਹਾ ਐਂਡਪੌਇੰਟ ਅੱਗੇ ਕੋਈ ਟ੍ਰੈਫਿਕ ਪ੍ਰਾਪਤ ਨਹੀਂ ਕਰਦਾ। ਐਂਡਪੌਇੰਟ ਠੀਕ ਹੋ ਜਾਣ ਤੋਂ ਬਾਅਦ, ਇਸਦੀ ਸਥਿਤੀ ਨੂੰ 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"]

ਬੇਨਤੀ ਫ਼ੀਲਡ#

ਐਂਡਪੌਇੰਟ ਆਬਜੈਕਟ ਦੇ ਨਾਲ 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"]
  }'

ਅੱਪਡੇਟ ਕੀਤੇ ਐਂਡਪੌਇੰਟ ਆਬਜੈਕਟ ਨਾਲ 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 ਗਲਤੀਆਂ ਸਰਟੀਫਿਕੇਟ ਚੇਨ, ਹੋਸਟਨਾਮ ਜਾਂ ਮਿਆਦ ਪੁੱਗਣ ਵੱਲ ਸੰਕੇਤ ਕਰਦੀਆਂ ਹਨ।

ਸੰਬੰਧਿਤ#