ઇવેન્ટ્સ કેટલોગ

ThunderPhone દ્વારા મોકલાતા તમામ વેબહૂક ઇવેન્ટ પ્રકારો.

દરેક webhook બોડીમાં type ફીલ્ડ હોય છે, જેનું મૂલ્ય આ પેજ પરના ઇવેન્ટ પ્રકારોમાંનું એક હોય છે. જ્યારે તમે કોઈ એન્ડપોઇન્ટને સબ્સ્ક્રાઇબ કરો છો, ત્યારે events એરેમાં તમને જોઈતા ઇવેન્ટ પ્રકારો હોવા જોઈએ (અથવા દરેક વસ્તુને સબ્સ્ક્રાઇબ કરવા માટે તે ખાલી હોવો જોઈએ — પરંતુ પ્રતિ-ટર્ન ઇવેન્ટ્સ telephony.turn / web.turn સિવાય, જે માત્ર એવા એન્ડપોઇન્ટને જ પહોંચાડવામાં આવે છે જે તેમને સ્પષ્ટ રીતે નામ આપે છે).

આ ઇવેન્ટ્સ બે ડિલિવરી શૈલીઓ દ્વારા મોકલવામાં આવે છે:

• એન્ડપોઇન્ટ ડિલિવરીઝ હંમેશાં પુનઃપ્રયાસો સાથેની નોન-બ્લોકિંગ સૂચનાઓ હોય છે: કોઈપણ 2xx સાથે પ્રતિસાદ આપો; ડિડ્યુપ્લિકેશન માટે એન્વલપમાં event_id હોય છે.
• બ્લોકિંગ વિનિમયો માત્ર લેગસી સિંગલ-URL webhook પર ચાલે છે: telephony.incoming / web.incoming કન્ફિગરેશન વિનંતી (webhook-મોડ નંબર અને widget કી, 10 s ટાઇમઆઉટ) અને webhook-મોડ ટૂલ ડિસ્પેચ. તમારો પ્રતિસાદ લાઇવ કૉલને આકાર આપે છે.

નીચેના ઉદાહરણ પેલોડ્સ તેમના વાયર ક્રમમાં એન્ડપોઇન્ટ એન્વલપ દર્શાવે છે (કીઓ મૂળાક્ષર ક્રમમાં ગોઠવેલી છે: data, event_id, type); લેગસી ડિલિવરીઝમાં event_id વગર સમાન data હોય છે.

કૉલ ઇવેન્ટ્સ#

telephony.incoming#

ઇનબાઉન્ડ કૉલ તમારા કોઈ એક ફોન નંબર પર પહોંચે ત્યારે મોકલવામાં આવે છે. એન્ડપૉઇન્ટ ડિલિવરીઓ દરેક ઇનબાઉન્ડ કૉલ માટે મોકલાતી ફાયર-એન્ડ-ફર્ગેટ સૂચનાઓ છે, પછી ભલે નંબર એજન્ટ-કૉન્ફિગર કરેલો હોય કે વેબહૂક-કૉન્ફિગર કરેલો હોય. અસાઇન કરેલા એજન્ટ વિનાના નંબરોને લેગસી વેબહૂક પર વધારામાં બ્લૉકિંગ કૉન્ફિગરેશન વિનંતી મળે છે — સંપૂર્ણ વિનંતી / પ્રતિસાદ સ્કીમા માટે telephony.incoming / web.incoming જુઓ.

{
  "data": {
    "call_id": 987654321,
    "from_number": "+14155550199",
    "to_number": "+15551234567"
  },
  "event_id": "3f6b2ad0-1c9e-4a57-9f2b-8f6f0f9d2f11",
  "type": "telephony.incoming"
}

telephony.complete#

ઇનબાઉન્ડ અથવા આઉટબાઉન્ડ ટેલિફોની કૉલ સમાપ્ત થાય ત્યારે મોકલવામાં આવે છે. નૉન-બ્લૉકિંગ. ટ્રાન્સક્રિપ્ટ, ઉપલબ્ધ હોય ત્યારે રેકોર્ડિંગ URL અને બિલિંગ સારાંશનો સમાવેશ કરે છે. પેલોડ સ્કીમા માટે telephony.complete / web.complete જુઓ.

telephony.tool#

ટેલિફોની કૉલ ફંક્શન ટૂલ ઇન્વોક કરે પછી મોકલવામાં આવે છે. નૉન-બ્લૉકિંગ ઑડિટ સૂચના — આ ઇવેન્ટ ડિલિવર થાય ત્યારે ટૂલ પહેલેથી ચલાવવામાં આવી ચૂકી હોય છે; તેમાં તમારી પોતાની ફંક્શન ટૂલ્સનો સમાવેશ થાય છે (બિલ્ટ-ઇન, નૉલેજ-બેઝ, એપ-કનેક્શન અથવા MCP ટૂલ્સનો નહીં).

{
  "data": {
    "arguments": { "date": "2026-04-21" },
    "call_id": 987654321,
    "from_number": "+14155550199",
    "response": {
      "response": { "available_slots": ["9:00 AM", "2:00 PM"] },
      "status": 200
    },
    "to_number": "+15551234567",
    "tool_name": "search_appointments"
  },
  "event_id": "1f0a7c3e-52d4-4a0e-8f4b-b1a6a1c0d9e2",
  "type": "telephony.tool"
}

response ચલાવેલું પરિણામ છે: સફળતા પર {"status": <http status>, "response": <your endpoint's JSON>}, અથવા નિષ્ફળતા પર {"status": <status>, "error": "<message>"}.

telephony.turn#

ટેલિફોની કૉલ ચાલુ હોય ત્યારે, દરેક બોલચાલ-ધારક ટર્ન માટે તે થાય તેમ એકવાર મોકલવામાં આવે છે — એજન્ટના બોલાયેલા પ્રતિસાદો અને કૉલરના ટ્રાન્સક્રાઇબ થયેલા ટર્ન્સ. પોલિંગ કરવાને બદલે સાદા વેબહૂક દ્વારા તમને લાઇવ વાતચીત અનુસરવા દે છે GET /v1/calls/{call_id}/transcript. નૉન-બ્લૉકિંગ.

{
  "data": {
    "call_id": 987654321,
    "entry_type": "completion",
    "from_number": "+14155550199",
    "position": 7,
    "role": "assistant",
    "start_ms": 15200,
    "text": "How many employees does your company have?",
    "to_number": "+15551234567"
  },
  "event_id": "8d3f5a2c-7b1e-4c9a-b6d0-2e4f6a8c0d1e",
  "type": "telephony.turn"
}

web.incoming#

telephony.incoming નું વેબ-ચેનલ સમકક્ષ, જે વેબ વિજેટ સેશન અથવા બિલ્ડર માઇક ટેસ્ટ કૉલ શરૂ થાય ત્યારે મોકલવામાં આવે છે. દરેક વેબ સેશન માટે એન્ડપૉઇન્ટ ડિલિવરીઓ ફાયર-એન્ડ-ફર્ગેટ હોય છે. mode="webhook" માં પબ્લિશેબલ કીઝને લેગસી વેબહૂક પર વધારામાં બ્લૉકિંગ કૉન્ફિગરેશન વિનંતી મળે છે — તે બ્લૉકિંગ વિનંતીનું સ્વરૂપ અલગ હોય છે (origin_domain, publishable_key_prefix; કોઈ ફોન નંબર નહીં). જુઓ telephony.incoming / web.incoming.

{
  "data": {
    "call_id": 987654322,
    "from_number": "web",
    "origin_domain": "https://example.com",
    "publishable_key_prefix": "pk_live_a1b2",
    "to_number": "+15551234567"
  },
  "event_id": "9a2b4c6d-8e0f-4a1b-9c2d-3e4f5a6b7c8d",
  "type": "web.incoming"
}

from_number હંમેશાં લિટરલ "web" હોય છે. વેબહૂક-મોડ વિજેટ સેશન્સ માટે to_number ખાલી હોય છે (સેશનનો એજન્ટ નંબર કૉન્ફિગરેશન પછી અસાઇન થાય છે); બિલ્ડર માઇક ટેસ્ટ કૉલ્સ માટે origin_domain અને publishable_key_prefix ખાલી હોય છે.

web.complete#

telephony.complete નું વેબ-ચેનલ સમકક્ષ, જેમાં વેબ વિજેટ કૉલ્સ (direction: "web") અને બિલ્ડર માઇક ટેસ્ટ કૉલ્સ (direction: "test") સામેલ છે. નૉન-બ્લૉકિંગ. origin_domain સહિત telephony.complete જેવું જ પેલોડ સ્વરૂપ, જેમાં from_number "web" પર સેટ હોય છે.

web.tool#

telephony.tool નું વેબ-ચેનલ સમકક્ષ. data માં from_number / to_number ને બદલે origin_domain હોય છે.

web.turn#

telephony.turn નું વેબ-ચેનલ સમકક્ષ, જેમાં વેબ વિજેટ કૉલ્સ અને બિલ્ડર માઇક ટેસ્ટ કૉલ્સ સામેલ છે. સમાન પેલોડ સ્વરૂપ, જેમાં from_number / to_number ને બદલે origin_domain હોય છે. telephony.turn ની જેમ, તેને સ્પષ્ટ સબ્સ્ક્રિપ્શન જરૂરી છે — તે ખાલી events એરે મારફતે ક્યારેય ડિલિવર થતું નથી.

અવાજ ઇવેન્ટ્સ#

કસ્ટમ અવાજ બનાવવાની પ્રક્રિયા અસુમેળ છે. આ બિન-અવરોધક ઇવેન્ટ્સ તમને પોલિંગ કરવાને બદલે અંતિમ પરિણામ પર પ્રતિસાદ આપવા દે છે ક્લોન વિગતો એન્ડપોઇન્ટ.

voice.ready અને voice.failed ફક્ત events: [] ધરાવતા સમગ્ર સંસ્થાના એન્ડપોઇન્ટ પર જ પહોંચાડવામાં આવે છે. તેમને સ્પષ્ટ ઇવેન્ટ ફિલ્ટર્સ તરીકે પસંદ કરી શકાતા નથી.

voice.ready#

કસ્ટમ અવાજની પ્રક્રિયા પૂર્ણ થાય અને તેને એજન્ટને સોંપી શકાય ત્યારે મોકલવામાં આવે છે.

{
  "data": {
    "voice": {
      "created_at": "2026-07-30T14:12:08.317Z",
      "display_name": "Support voice",
      "failure_reason": "",
      "gender": "female",
      "id": "cv_2f6f90b0e9a34ee8b39be7d1",
      "language": "en",
      "name": "custom:cv_2f6f90b0e9a34ee8b39be7d1",
      "status": "ready",
      "updated_at": "2026-07-30T14:13:31.605Z"
    }
  },
  "event_id": "2d5f0a61-e9b5-4a3c-b684-29d7d9e4b214",
  "type": "voice.ready"
}

voice.failed#

કસ્ટમ અવાજની પ્રક્રિયામાં કાયમી નિષ્ફળતા આવે ત્યારે મોકલવામાં આવે છે.

{
  "data": {
    "reason": "audio sample could not be processed",
    "voice": {
      "created_at": "2026-07-30T14:12:08.317Z",
      "display_name": "Support voice",
      "failure_reason": "audio sample could not be processed",
      "gender": "female",
      "id": "cv_2f6f90b0e9a34ee8b39be7d1",
      "language": "en",
      "name": "custom:cv_2f6f90b0e9a34ee8b39be7d1",
      "status": "failed",
      "updated_at": "2026-07-30T14:13:31.605Z"
    }
  },
  "event_id": "3493e985-1a75-4f77-a10a-e74af440cd31",
  "type": "voice.failed"
}

ગુણવત્તા ઇવેન્ટ્સ#

call.graded#

કૉલ માટે AI ગ્રેડિંગ રન પૂર્ણ થાય ત્યારે મોકલવામાં આવે છે. નૉન-બ્લૉકિંગ.

{
  "data": {
    "call_id": 987654321,
    "grade": {
      "call_outcome": "success",
      "created_at": "2026-04-20T18:25:11.002Z",
      "detected_issues": [],
      "graded_at": "2026-04-20T18:25:11.002Z",
      "grader_model": "heuristic-v1",
      "id": 5512,
      "score": 92,
      "status": "completed",
      "summary": "Caller asked about their policy and got a full answer…"
    }
  },
  "event_id": "7c1d2e3f-4a5b-4c6d-8e9f-0a1b2c3d4e5f",
  "type": "call.graded"
}

call.data_extracted#

telephony.complete / web.complete પછીના વિલંબિત રીટ્રાય સહિત, અથવા POST /v1/calls/{call_id}/extract દ્વારા મેન્યુઅલ રીતે ફરી રન કર્યા પછી, સ્ટ્રક્ચર્ડ ડેટા એક્સ્ટ્રેક્શન સફળતાપૂર્વક પૂર્ણ થાય ત્યારે મોકલવામાં આવે છે. નૉન-બ્લૉકિંગ.

બ્લૉકિંગ એક્સ્ટ્રેક્શન મોડમાં, પૂર્ણતા ઇવેન્ટ સામાન્ય રીતે 75-સેકન્ડના એક્સ્ટ્રેક્શન બજેટ કરતાં વધુ રાહ જોતી નથી. જો એક્સ્ટ્રેક્શન વર્કર પ્રક્રિયા ખોવાઈ જાય, તો પ્રોડક્શન ફાઇનલાઇઝેશન ડ્રેન (દર પાંચ મિનિટે) બીજો એક્સ્ટ્રેક્શન પ્રયાસ શરૂ કરે તે પહેલાં જેનું blocking_deadline_at પસાર થઈ ગયું હોય તેવી પૂર્ણતા રિલીઝ કરે છે. પછીથી મળેલી સફળતા આ ઇવેન્ટ તરીકે અલગથી મોકલવામાં આવે છે.

{
  "data": {
    "call_id": 987654321,
    "agent_id": 12,
    "agent_name": "Acme intake",
    "extracted_data": {
      "status": "completed",
      "fields": {
        "customer_name": "Alex Morgan",
        "appointment_date": "2026-04-23"
      },
      "evidence": {
        "customer_name": {
          "quote": "My name is Alex Morgan",
          "speaker_role": "caller",
          "turn_index": 4
        },
        "appointment_date": {
          "quote": "April 23 works for me",
          "speaker_role": "caller",
          "turn_index": 7
        }
      },
      "verification": "verified",
      "field_reasons": {},
      "schema_version": "92850758e231a3c95a..."
    },
    "extracted_at": "2026-04-20T18:25:11.002Z",
    "model": "gemini-2.5-flash"
  },
  "event_id": "4d79ef1d-c2b1-4ed6-85b8-8326bd2895ef",
  "type": "call.data_extracted"
}

campaign.completed#

કૅમ્પેઇન running થી completed પર જાય ત્યારે એક વખત મોકલવામાં આવે છે, ભલે તેનું શેડ્યૂલ સમાપ્ત થયું હોય અથવા બધા સંપર્કો ટર્મિનલ સ્થિતિએ પહોંચી ગયા હોય. રનર રીટ્રાય બીજી ઇવેન્ટ મોકલતા નથી. આ સંસ્થા-સ્તરની લાઇફસાયકલ ઇવેન્ટ ફક્ત સંસ્થા-સ્કોપવાળા એન્ડપૉઇન્ટ્સ પર મોકલવામાં આવે છે, એજન્ટ-સ્કોપવાળા એન્ડપૉઇન્ટ્સ પર નહીં. નૉન-બ્લૉકિંગ.

{
  "data": {
    "campaign_id": "3f6b2c9e-2a0d-4c63-b6d6-a708dc98f403",
    "name": "May win-back",
    "agent_id": 12,
    "status": "completed",
    "started_at": "2026-04-20T17:00:00Z",
    "completed_at": "2026-04-20T18:25:11Z",
    "counts": {
      "contacts_total": 150,
      "completed": 121,
      "failed": 11,
      "no_answer": 18,
      "remaining": 0
    }
  },
  "event_id": "8d8f52ce-6b46-423f-9dde-cea0b91ec135",
  "type": "campaign.completed"
}

ચાર પરિણામ ગણતરીઓ અલગ છે અને તેમનો સરવાળો contacts_total જેટલો થાય છે: completed માં સફળ સંપર્કો હોય છે; no_answer માં એવા ટર્મિનલ નિષ્ફળ/સમાપ્ત સંપર્કો હોય છે જેમનું અંતિમ પરિણામ કોઈ જવાબ ન મળવો હતું; failed માં અન્ય તમામ ટર્મિનલ નિષ્ફળ/સમાપ્ત સંપર્કો હોય છે; અને remaining માં પેન્ડિંગ, શેડ્યૂલ કરેલા અથવા હાલમાં કૉલ થઈ રહેલા સંપર્કો હોય છે. રીટ્રાયની રાહ જોતો સંપર્ક remaining હોય છે, ભલે તેનો સૌથી તાજેતરનો પ્રયાસ કોઈ જવાબ ન મળવો હોય. એક વખતના પૂર્ણતા સ્નૅપશૉટ પહેલાં ચાલુ કૉલ્સનું સમાધાન કરવામાં આવે છે. started_at કૉન્ફિગર કરેલો કૅમ્પેઇન પ્રારંભ સમય છે, અથવા પ્રારંભ કૉન્ફિગર ન હોય ત્યારે કૅમ્પેઇન બનાવવાનો સમય છે.

issue.reported#

જ્યારે સમસ્યા રિપોર્ટ બનાવવામાં આવે ત્યારે મોકલવામાં આવે છે — કાં તો ડૅશબોર્ડમાંથી વપરાશકર્તા દ્વારા નોંધાવવામાં આવેલ (source: "user") અથવા કૉલ ગ્રેડિંગ દ્વારા આપમેળે બનાવવામાં આવેલ (source: "system"). નૉન-બ્લૉકિંગ.

{
  "data": {
    "call_id": 987654321,
    "issue_report": {
      "created_at": "2026-04-20T18:25:11.002Z",
      "description": "Five-second silence before responding to the main question.",
      "id": 4321,
      "severity": "warning",
      "source": "system",
      "status": "open",
      "title": "Agent paused too long"
    }
  },
  "event_id": "5e6f7a8b-9c0d-4e1f-8a2b-3c4d5e6f7a8b",
  "type": "issue.reported"
}

issue.escalated#

જ્યારે સમસ્યા પેટર્ન સ્ટાફ સમીક્ષા માટે ThunderPhone ને મોકલવામાં આવે ત્યારે મોકલવામાં આવે છે: ThunderPhone ને રિપોર્ટ કરો પછી, અથવા જ્યારે Fix with AI ગ્રાહક-પક્ષનો ઉકેલ પુષ્ટિ ન કરી શકે અને સમસ્યાને આપમેળે રૂટ કરે. ફક્ત સમગ્ર સંસ્થાવાળા એન્ડપૉઇન્ટ્સને જ આ ઇવેન્ટ મળે છે.

{
  "data": {
    "automatic": false,
    "cluster_id": "7ac2844c-2df0-4fa8-a560-7378da649e19",
    "escalation_id": "ec99f52b-c8c0-41dd-a4f2-dd8a07b10894",
    "status": "open"
  },
  "event_id": "d8f8f420-7a42-45ba-bcf1-b747f9bbecda",
  "type": "issue.escalated"
}

આ સૂચના છે, પુરાવા બંડલ નથી. સમસ્યા પેટર્ન સાથે તેનો સંબંધ સ્થાપિત કરવા માટે cluster_id નો ઉપયોગ કરો. ThunderPhone ને રિપોર્ટ કરો જુઓ.

ટેસ્ટ કૉલ ઇવેન્ટ્સ#

test-call.completed#

જ્યારે ટેસ્ટ કૉલ રન અંતિમ સ્થિતિ પર પહોંચે — completed અથવા failed, જેમાં એવા રન પણ સામેલ છે જે શરૂ કરતી વખતે નિષ્ફળ ગયા હોય અને ક્યારેય કૉલ જનરેટ ન કર્યો હોય — ત્યારે મોકલવામાં આવે છે. અવરોધરહિત. બેચ CI રનને તમારી ચેટ/સૂચના સિસ્ટમ્સ સાથે જોડવા માટે ઉપયોગી.

{
  "data": {
    "test_call_run": {
      "call_id": 987654321,
      "completed_at": "2026-04-20T18:25:04.822Z",
      "error_message": "",
      "id": 7110,
      "status": "completed",
      "target_id": 12,
      "target_type": "agent"
    }
  },
  "event_id": "2b3c4d5e-6f7a-4b8c-9d0e-1f2a3b4c5d6e",
  "type": "test-call.completed"
}

ચેતવણી ઇવેન્ટ્સ#

alert.triggered#

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

{
  "data": {
    "comparator": "lt",
    "event_id": "b8e6a1d4-2c3f-4a5b-9c8d-7e6f5a4b3c2d",
    "fired_at": "2026-04-20T18:00:00+00:00",
    "metric": "success_rate",
    "metric_value": 71.4,
    "rule_id": "d2c3b4a5-6f7e-4d8c-9b0a-1c2d3e4f5a6b",
    "rule_name": "Success rate below 80%",
    "threshold": 80.0,
    "window_hours": 24
  },
  "event_id": "4d5e6f7a-8b9c-4d0e-9f1a-2b3c4d5e6f7a",
  "type": "alert.triggered"
}

નિયમો, મેટ્રિક્સ, કૂલડાઉન અને ઇમેઇલ / Slack ચૅનલો બનાવવા માટે ચેતવણીઓ માર્ગદર્શિકા જુઓ.

સંબંધિત#