ThunderPhone v3 ਹੁਣ ਲਾਈਵ ਹੈ।ਸੈਲਫ਼-ਸਰਵਿਸ—2¢/ਮਿੰਟ ਤੋਂ।ਐਲਾਨ ਪੜ੍ਹੋ

Webhooks

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

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

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

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

ਐਂਡਪੌਇੰਟ

ਢੰਗਪਾਥਲੋੜੀਂਦੀ ਭੂਮਿਕਾਵੇਰਵਾ
GET/v1/developer/webhook-endpointsadmin+ਐਂਡਪੌਇੰਟਾਂ ਦੀ ਸੂਚੀ ਦਿਖਾਓ
POST/v1/developer/webhook-endpointsadmin+ਇੱਕ ਐਂਡਪੌਇੰਟ ਬਣਾਓ
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-secretadmin+ਸਾਈਨਿੰਗ ਸੀਕ੍ਰੇਟ ਬਦਲੋ
POST/v1/developer/webhook-endpoints/{endpoint_id}/testadmin+ਸਾਈਨ ਕੀਤੀ ਟੈਸਟ ਡਿਲਿਵਰੀ ਭੇਜੋ
GET/v1/developer/webhook-deliveriesadmin+ਹਾਲੀਆ ਐਂਡਪੌਇੰਟ ਅਤੇ ਪੁਰਾਣੀਆਂ ਡਿਲਿਵਰੀਆਂ ਦੇ ਨਤੀਜਿਆਂ ਦੀ ਜਾਂਚ ਕਰੋ

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

{
  "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"
}
ਫੀਲਡਕਿਸਮਵੇਰਵਾ
idUUIDਐਂਡਪੌਇੰਟ 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.turn
  • web.incoming, web.complete, web.tool, web.turn
  • sms.sent, sms.failed
  • sms.received (ਰਾਖਵਾਂ; ਹਾਲੇ ਜਾਰੀ ਨਹੀਂ ਕੀਤਾ ਗਿਆ)
  • scheduled.skipped, scheduled.failed
  • call.graded, call.data_extracted, call.transfer_completed, call.status_changed
  • campaign.completed
  • issue.reported, issue.escalated
  • test-call.completed
  • alert.triggered
  • phone_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
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
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"]
  }'
Python
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
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
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_idsUUID ਦੀ ਐਰੇਹਰ ਉਹ ਐਂਡਪੌਇੰਟ ਜੋ ਹੁਣ ਨਵਾਂ ਸੀਕ੍ਰੇਟ ਵਰਤਦਾ ਹੈ

ਟੈਸਟ ਡਿਲਿਵਰੀ ਭੇਜੋ

ਸਧਾਰਣ ਡਿਲਿਵਰੀ ਪਾਈਪਲਾਈਨ ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਇੱਕ ਐਂਡਪੌਇੰਟ ਨੂੰ ਸਿੰਥੈਟਿਕ webhook.test ਇਵੈਂਟ ਭੇਜੋ, ਜਿਸ ਵਿੱਚ ਕੈਨੋਨਿਕਲ JSON ਸੀਰੀਅਲਾਈਜ਼ੇਸ਼ਨ, ਦੋਵੇਂ ਸਿਗਨੇਚਰ ਹੈਡਰ, ਡਿਲਿਵਰੀ ਰਿਕਾਰਡਿੰਗ ਅਤੇ ਰੀਟ੍ਰਾਈ ਬੁੱਕਕੀਪਿੰਗ ਸ਼ਾਮਲ ਹਨ। ਟੈਸਟ ਆਪਣੇ events ਫਿਲਟਰ ਦੀ ਪਰਵਾਹ ਕੀਤੇ ਬਿਨਾਂ ਚੁਣੇ ਹੋਏ ਐਂਡਪੌਇੰਟ ਨੂੰ ਨਿਸ਼ਾਨਾ ਬਣਾਉਂਦਾ ਹੈ।

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


ਸੰਬੰਧਿਤ