ThunderPhone v3 ഇപ്പോൾ ലൈവാണ്.സ്വയം തുടങ്ങാം — 2¢/മിനിറ്റ് മുതൽ.പ്രഖ്യാപനം വായിക്കുക

Webhooks

Webhook എൻഡ്‌പോയിന്റുകൾ

ഓരോ എൻഡ്‌പോയിന്റിനുമുള്ള സീക്രട്ടുകളും ഇവന്റ് ഫിൽട്ടറുകളും ഉപയോഗിച്ച് ഒന്നിലധികം webhook URL-ുകൾ നിയന്ത്രിക്കുക.

എൻഡ്‌പോയിന്റ് അടിസ്ഥാനമാക്കിയുള്ള webhook സംവിധാനം, ഓരോ ഓർഗനൈസേഷനും സ്വന്തം secret, സ്വന്തം status, ഇവന്റ് തരങ്ങളുടെ ഒരു ഉപസെറ്റിലേക്കുള്ള സ്വന്തം subscription എന്നിവയുള്ള ഒന്നിലധികം ലക്ഷ്യസ്ഥാനങ്ങൾ രജിസ്റ്റർ ചെയ്യാൻ നിങ്ങളെ അനുവദിക്കുന്നു. എല്ലാ പുതിയ ഇന്റഗ്രേഷനുകൾക്കും ശുപാർശ ചെയ്യുന്ന മോഡൽ ഇതാണ്.

പിന്നോട്ടുള്ള അനുയോജ്യതയ്ക്കായി നിലനിർത്തിയിട്ടുള്ളതും ഓരോ ഓർഗിനും ഒരു URL മാത്രം പിന്തുണയ്ക്കുന്നതുമായ ലെഗസി single-URL webhook-മായി താരതമ്യം ചെയ്യുക.

എൻഡ്‌പോയിന്റുകൾ

രീതിപാത്ത്ആവശ്യമായ റോൾവിവരണം
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എൻഡ്‌പോയിന്റ് ഐഡി
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സ്ട്രിംഗ്എലിപ്സിസോടുകൂടിയ (a1b2…9f0e) സൈനിംഗ് സീക്രട്ടിന്റെ ആദ്യ 4-ഉം അവസാന 4-ഉം പ്രതീകങ്ങൾ — പൂർണ്ണ മൂല്യം വെളിപ്പെടുത്താതെ നിങ്ങൾ പ്രാദേശികമായി സംരക്ഷിച്ച സീക്രട്ടുമായി ക്രോസ്-റഫറൻസ് ചെയ്യാൻ മതിയാകും
paused_atടൈംസ്റ്റാമ്പ് | nullThunderPhone എൻഡ്‌പോയിന്റിനെ 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.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 — എൻഡ്‌പോയിന്റിലേക്കുള്ള ഒരു ഡെലിവറിക്ക് 2xx ലഭിക്കാതെ അതിന്റെ മുഴുവൻ റീട്രൈ ഷെഡ്യൂളും (24 മണിക്കൂറിനുള്ളിൽ 8 ശ്രമങ്ങൾ) പൂർത്തിയാകുമ്പോൾ സ്വയമേവ സജ്ജമാക്കപ്പെടും. പരാജയപ്പെടുന്ന എൻഡ്‌പോയിന്റിലേക്ക് പിന്നീട് ട്രാഫിക് ലഭിക്കില്ല. ഇത് സംഭവിക്കുമ്പോൾ നിങ്ങളുടെ സ്ഥാപനത്തിലെ ഉടമകൾക്കും അഡ്മിൻമാർക്കും ഞങ്ങൾ ഇമെയിൽ അയക്കും; ഡാഷ്ബോർഡിൽ താൽക്കാലികമായി നിർത്തിയ എൻഡ്‌പോയിന്റ് Re-activate ബട്ടണോടെ കാണിക്കും. എൻഡ്‌പോയിന്റ് പരിഹരിച്ചുകഴിഞ്ഞാൽ, 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 ഉപയോഗിക്കുക

എൻഡ്‌പോയിന്റ് ഒബ്ജക്റ്റ്-നൊപ്പം, അസംസ്കൃത സൈനിംഗ് കീ അടങ്ങിയ അധിക ഉയർന്നതല 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
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എൻഡ്‌പോയിന്റ് പരിമിതപ്പെടുത്താൻ ഒരു ഏജന്റ് id സജ്ജമാക്കുക, അല്ലെങ്കിൽ ഓർഗനൈസേഷൻ-വ്യാപകമാക്കാൻ null സജ്ജമാക്കുക

അപ്ഡേറ്റ് ചെയ്ത എൻഡ്‌പോയിന്റ് ഒബ്ജക്റ്റ്-നൊപ്പം 200 OK മടക്കിനൽകുന്നു.


സൈനിംഗ് സീക്രട്ട് പുതുക്കുക

ഒരു എൻഡ്‌പോയിന്റിന്റെ സൈനിംഗ് സീക്രട്ട് മാറ്റിസ്ഥാപിക്കുക, ഉദാഹരണത്തിന് അത് നഷ്ടപ്പെട്ടാലോ ചോർന്നിരിക്കാമെന്നു തോന്നിയാലോ. ഡാഷ്‌ബോർഡും ഉപയോഗിക്കാം: എൻഡ്‌പോയിന്റ് ഇന്റഗ്രേഷനുകൾ → വെബ്‌ഹുക്കുകൾ എന്നതിന് കീഴിൽ തുറക്കുക (ഓർഗനൈസേഷൻ-വ്യാപകവും ഏജന്റ് എൻഡ്‌പോയിന്റുകളും അവിടെ പട്ടികപ്പെടുത്തിയിരിക്കുന്നു), തുടർന്ന് റൊട്ടേറ്റ് തിരഞ്ഞെടുക്കുക.

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_copiesbooleanഇല്ലസ്ഥിരസ്ഥിതിയായി true. ഇതേ URL-ഉം ഇതേ നിലവിലെ സീക്രട്ടും ഉള്ള നിങ്ങളുടെ ഓർഗനൈസേഷനിലെ മറ്റ് എൻഡ്‌പോയിന്റുകൾക്കും, മറ്റ് ഏജന്റുകളിലെ ഈ എൻഡ്‌പോയിന്റിന്റെ പകർപ്പുകൾ പോലുള്ളവയ്ക്കും, പുതിയ സീക്രട്ട് നൽകുന്നു, അതുവഴി ഒരു റിസീവറിന് ഒരൊറ്റ സീക്രട്ടുപയോഗിച്ച് പരിശോധന തുടരാം

200 OK മടക്കിനൽകുന്നു:

{
  "endpoint": { "id": "c4d5e6f7-...", "secret_hint": "7f3a…c21d", "...": "..." },
  "secret": "7f3a90b2c4d5e6f708192a3b4c5d6e7f8091a2b3c4d5c21d",
  "rotated_endpoint_ids": ["c4d5e6f7-..."]
}
ഫീൽഡ്തരംവിവരണം
endpointobjectപുതിയ secret_hint ഉള്ള എൻഡ്‌പോയിന്റ് ഒബ്ജക്റ്റ്
secretstringപുതിയ സൈനിംഗ് സീക്രട്ട്. ഈ പ്രതികരണത്തിൽ മാത്രമാണ് മടക്കിനൽകുന്നത്
rotated_endpoint_idsUUID-കളുടെ arrayഇപ്പോൾ പുതിയ സീക്രട്ട് ഉപയോഗിക്കുന്ന ഓരോ എൻഡ്‌പോയിന്റും

ഒരു ടെസ്റ്റ് ഡെലിവറി അയയ്ക്കുക

സാധാരണ ഡെലിവറി പൈപ്പ്‌ലൈൻ ഉപയോഗിച്ച്, കാനോണിക്കൽ JSON സീരിയലൈസേഷൻ, രണ്ട് സിഗ്നേച്ചർ ഹെഡറുകൾ, ഡെലിവറി റെക്കോർഡിംഗ്, റീട്രൈ കണക്കെടുപ്പ് എന്നിവ ഉൾപ്പെടെ, ഒരു എൻഡ്‌പോയിന്റിലേക്ക് കൃത്രിമ webhook.test ഇവന്റ് അയയ്ക്കുക.
തിരഞ്ഞെടുത്ത എൻഡ്‌പോയിന്റിന്റെ 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 പിശകുകൾ സർട്ടിഫിക്കറ്റ് ചെയിൻ, ഹോസ്റ്റ്നെയിം, അല്ലെങ്കിൽ കാലഹരണപ്പെടൽ എന്നിവയെ സൂചിപ്പിക്കുന്നു.


ബന്ധപ്പെട്ടവ