Webhook એન્ડપોઇન્ટ્સ

દરેક એન્ડપોઇન્ટ માટેના સિક્રેટ્સ અને ઇવેન્ટ ફિલ્ટર્સ સાથે અનેક webhook URLs મેનેજ કરો.

એન્ડપોઇન્ટ-આધારિત webhook સિસ્ટમ તમને દરેક સંસ્થા માટે બહુવિધ ગંતવ્યો નોંધવાની મંજૂરી આપે છે, જેમાં દરેકનું પોતાનું secret, પોતાની સ્થિતિ અને ઇવેન્ટ પ્રકારોના ઉપસેટ માટેનું પોતાનું subscription હોય છે. તમામ નવી ઇન્ટિગ્રેશન્સ માટે આ ભલામણ કરેલ મોડેલ છે.

લેગસી સિંગલ-URL webhook સાથે સરખામણી કરો, જે backward compatibility માટે જાળવી રાખવામાં આવ્યું છે, પરંતુ દરેક સંસ્થા માટે માત્ર એક 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 — જ્યારે એન્ડપોઇન્ટને ડિલિવરી એકપણ 2xx મેળવ્યા વિના તેની સંપૂર્ણ રિટ્રાય સૂચિ (24 કલાકમાં 8 પ્રયાસો) પૂર્ણ કરે ત્યારે આપમેળે સેટ થાય છે. નિષ્ફળ એન્ડપોઇન્ટને આગળ કોઈ ટ્રાફિક મળતો નથી. એન્ડપોઇન્ટ ઠીક થઈ જાય પછી, તેનું સ્ટેટસ 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"]

વિનંતી ફીલ્ડ્સ#

એન્ડપોઇન્ટ ઑબ્જેક્ટ સાથે 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 પરત કરે છે.

પરીક્ષણ ડિલિવરી મોકલો#

કેનોનિકલ JSON સિરિયલાઇઝેશન, X-ThunderPhone-Signature, ડિલિવરી રેકોર્ડિંગ અને પુનઃપ્રયાસ હિસાબી નોંધ સહિતની સામાન્ય ડિલિવરી પાઇપલાઇનનો ઉપયોગ કરીને એક એન્ડપોઇન્ટ પર કૃત્રિમ webhook.test ઇવેન્ટ મોકલો. પરીક્ષણ તેના 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 તપાસો. તે બંને વેબહૂક સિસ્ટમોના તાજેતરના પ્રયાસો દર્શાવે છે, જેમાં કૉલ id, URL ઓરિજિન, HTTP સ્થિતિ, પ્રયાસોની સંખ્યા, મંજૂરીસૂચિબદ્ધ નિષ્ફળતા શ્રેણી અને આગામી પુનઃપ્રયાસ સમય સામેલ છે. તે ક્યારેય ઇવેન્ટ પેલોડ, ટ્રાન્સક્રિપ્ટ, સંગ્રહિત ભૂલ લખાણ, પ્રતિસાદ બોડી અથવા URL પાથ પરત કરતું નથી.

તમે આ જ તાજેતરનો ઇતિહાસ એજન્ટ્સ → એજન્ટ પસંદ કરો → વેબહૂક્સ → તાજેતરની ડિલિવરીઓ માં પણ જોઈ શકો છો. પંક્તિઓ એન્ડપોઇન્ટ લેબલ અને સૌથી તાજેતરના પ્રયાસ દ્વારા ઉપયોગમાં લેવાયેલ URL ઓરિજિન દર્શાવે છે. આ અપરિવર્તનીય ઓડિટ લોગને બદલે ઓપરેશનલ સ્થિતિ છે: એન્ડપોઇન્ટ કાઢી નાખવાથી તેની ડિલિવરી પંક્તિઓ પણ કાઢી નાખવામાં આવે છે.

n8n 404 માટે, પહેલાં ખાતરી કરો કે વર્કફ્લો સક્રિય છે, POST સ્વીકારે છે અને ટેસ્ટ URLને બદલે પ્રોડક્શન વેબહૂક URL નો ઉપયોગ કરે છે. 401 અથવા 403 પ્રમાણીકરણ અથવા સિગ્નેચર માન્યતા તરફ સૂચવે છે; સમયસમાપ્તિ ગંતવ્ય વિલંબતા અથવા ઉપલબ્ધતા તરફ સૂચવે છે; TLS ભૂલો પ્રમાણપત્ર ચેઇન, હોસ્ટનામ અથવા સમાપ્તિ તરફ સૂચવે છે.

સંબંધિત#