ThunderPhone v3 હવે લાઇવ છે.સેલ્ફ-સર્વ, 2¢/મિનિટથી.જાહેરાત વાંચો

Webhooks

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

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

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

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

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

નીચેના ઉદાહરણ payloads તેમના વાયર ક્રમમાં એન્ડપોઇન્ટ envelope દર્શાવે છે (કી અક્ષરક્રમમાં ગોઠવાયેલી છે: 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"
}
ફીલ્ડપ્રકારવર્ણન
agent_idinteger | nullએજન્ટ સોંપાયેલ હોય ત્યારે કૉલ સંભાળનાર એજન્ટ
agent_namestring | nullએજન્ટ સોંપાયેલ હોય ત્યારે કૉલ સંભાળનાર એજન્ટ
returning_callobjectનંબરએ છેલ્લા 30 દિવસમાં આ કૉલરને કૉલ કર્યો હોય ત્યારે જ હાજર: અગાઉના કૉલનું call_id, agent_id, started_at અને outcome. કૉલબૅક્સ જુઓ
sip_headersobjectકૉલ X-* અથવા User-to-User SIP હેડર્સ સાથે આવ્યો હોય ત્યારે જ હાજર (SIP સરનામાં અને મેન્યુઅલ SIP કનેક્શન્સ): હેડરનું નામ લોઅરકેસમાં → મૂલ્ય. SIP હેડર્સ જુઓ

telephony.complete

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

ક્ષેત્રપ્રકારવર્ણન
agent_idinteger | nullજ્યારે એજન્ટ સોંપાયેલ હોય, ત્યારે કૉલ સંભાળનાર એજન્ટ
agent_namestring | nullજ્યારે એજન્ટ સોંપાયેલ હોય, ત્યારે કૉલ સંભાળનાર એજન્ટ

telephony.tool

ટેલિફોની કૉલ ફંક્શન ટૂલને ઇન્વોક કરે પછી મોકલવામાં આવે છે. નૉન-બ્લોકિંગ ઑડિટ સૂચના — આ ઇવેન્ટ ડિલિવર થાય ત્યારે ટૂલ પહેલેથી એક્ઝિક્યુટ થઈ ચૂક્યું હોય છે; તેમાં તમારા પોતાના ફંક્શન ટૂલ્સ અને બિલ્ટ-ઇન send_sms ટૂલનો સમાવેશ થાય છે (અન્ય બિલ્ટ-ઇન, નોલેજ-બેઝ, એપ-કનેક્શન અથવા MCP ટૂલ્સનો નહીં). send_sms માટે arguments.to અને arguments.body બંને [REDACTED] હોય છે. કંપ્લીશન ટ્રાન્સક્રિપ્ટ્સ પણ તેમને રેડેક્ટ કરે છે; પ્રતિસાદના message_idનો ઉપયોગ કરીને સંસ્થા-સ્કોપ્ડ SMS રિસોર્સમાંથી સામગ્રી અને પ્રાપ્તકર્તા મેળવો.

{
  "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>"}.

ક્ષેત્રપ્રકારવર્ણન
agent_idinteger | nullજ્યારે એજન્ટ સોંપાયેલ હોય, ત્યારે કૉલ સંભાળનાર એજન્ટ
agent_namestring | nullજ્યારે એજન્ટ સોંપાયેલ હોય, ત્યારે કૉલ સંભાળનાર એજન્ટ

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"
}
ક્ષેત્રપ્રકારવર્ણન
agent_idinteger | nullજ્યારે એજન્ટ સોંપાયેલ હોય, ત્યારે કૉલ સંભાળનાર એજન્ટ
agent_namestring | nullજ્યારે એજન્ટ સોંપાયેલ હોય, ત્યારે કૉલ સંભાળનાર એજન્ટ
positionintegerકૉલ ઇતિહાસમાં ટર્નનો ઇન્ડેક્સ — ક્રમ માટે સ્થિર ઓળખ
rolestringassistant (એજન્ટનું ભાષણ) અથવા user (કૉલરનું ભાષણ)
textstringઇમિશન સમયે જાણીતી ટર્નની ટ્રાન્સક્રિપ્ટ ટેક્સ્ટ
entry_typestringઅંતર્ગત ઇતિહાસ એન્ટ્રી પ્રકાર: completion (એજન્ટ), અથવા user_turn / span (કૉલર)
start_ms, end_msintegerકૉલ શરૂ થયા પછી msમાં ઑડિયો ઑફસેટ્સ; ફક્ત ત્યારે હાજર હોય છે જ્યારે ઇમિશન સમયે પ્લેઆઉટ ટાઇમિંગ પહેલેથી જાણીતું હોય

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 ખાલી હોય છે.

ક્ષેત્રપ્રકારવર્ણન
agent_idinteger | nullજ્યારે એજન્ટ સોંપાયેલ હોય, ત્યારે કૉલ સંભાળનાર એજન્ટ
agent_namestring | nullજ્યારે એજન્ટ સોંપાયેલ હોય, ત્યારે કૉલ સંભાળનાર એજન્ટ

web.complete

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

ક્ષેત્રપ્રકારવર્ણન
agent_idinteger | nullજ્યારે એજન્ટ સોંપાયેલ હોય, ત્યારે કૉલ સંભાળનાર એજન્ટ
agent_namestring | nullજ્યારે એજન્ટ સોંપાયેલ હોય, ત્યારે કૉલ સંભાળનાર એજન્ટ

web.tool

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

ક્ષેત્રપ્રકારવર્ણન
agent_idinteger | nullજ્યારે એજન્ટ સોંપાયેલ હોય, ત્યારે કૉલ સંભાળનાર એજન્ટ
agent_namestring | nullજ્યારે એજન્ટ સોંપાયેલ હોય, ત્યારે કૉલ સંભાળનાર એજન્ટ

web.turn

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

ક્ષેત્રપ્રકારવર્ણન
agent_idinteger | nullજ્યારે એજન્ટ સોંપાયેલ હોય, ત્યારે કૉલ સંભાળનાર એજન્ટ
agent_namestring | nullજ્યારે એજન્ટ સોંપાયેલ હોય, ત્યારે કૉલ સંભાળનાર એજન્ટ

call.transfer_completed

અંતિમ પરિણામ સાથે દરેક કોલ માટે એક વાર મોકલવામાં આવે છે કોલ ટ્રાન્સફરનું: કોલ્ડ ટ્રાન્સફર, અથવા એજન્ટ બહાર નીકળી જાય પછી વોર્મ ટ્રાન્સફર પાછળ છોડે તે બે વ્યક્તિઓ વચ્ચેનો બ્રિજ. નોન-બ્લોકિંગ છે અને ફક્ત એન્ડપોઇન્ટ્સ પર જ મોકલાય છે (લેગસી સિંગલ-URL webhook પર ક્યારેય નહીં). તે કોલના telephony.complete પછી આવે છે: કેરિયર કોલ સંભાળે અથવા ટ્રાન્સફર નિષ્ફળ જાય ત્યારે, અથવા ThunderPhone એ કોલને બ્રિજ કર્યો હોય ત્યારે બ્રિજ સમાપ્ત થાય પછી.

{
  "data": {
    "agent_id": 12,
    "agent_name": "Front desk",
    "bridge_kind": "cold_fallback",
    "bridge_seconds": 255,
    "bridge_total_cents": 5,
    "call_id": 987654321,
    "destination": "+15555550102",
    "sip_status": 403,
    "transfer_outcome": "bridged"
  },
  "event_id": "5b0f6c1e-9d2a-5e7b-8c4d-1a2b3c4d5e6f",
  "type": "call.transfer_completed"
}
ફીલ્ડપ્રકારવર્ણન
call_idપૂર્ણાંકજે કોલ ટ્રાન્સફર કરવામાં આવ્યો હતો
agent_idપૂર્ણાંક | nullએજન્ટ સોંપાયેલો હોય ત્યારે, કોલ સંભાળનાર એજન્ટ
agent_nameસ્ટ્રિંગ | nullએજન્ટ સોંપાયેલો હોય ત્યારે, કોલ સંભાળનાર એજન્ટ
transfer_outcomeસ્ટ્રિંગrefer_accepted: કેરિયરે કોલ સંભાળી લીધો. bridged: કેરિયરે કોલ્ડ ટ્રાન્સફર નકાર્યો હોવાથી અથવા વોર્મ ટ્રાન્સફરનો એજન્ટ બહાર નીકળી ગયો હોવાથી, ThunderPhone એ કૉલર અને ગંતવ્યને પોતે જોડાયેલા રાખ્યા. bridge_unanswered: કેરિયરે કોલ્ડ ટ્રાન્સફર નકાર્યો અને ગંતવ્યે ThunderPhone ના પોતાના કોલનો જવાબ આપ્યો નહીં. failed: ટ્રાન્સફર પૂર્ણ થયું નહીં અને કોલ સમાપ્ત થયો
destinationસ્ટ્રિંગ | nullજે નંબર પર કોલ ટ્રાન્સફર કરવામાં આવ્યો હતો
sip_statusપૂર્ણાંક | nullકેરિયરે કોલ્ડ ટ્રાન્સફર નકાર્યો ત્યારે તેની SIP સ્થિતિ: 403 (ઉદાહરણ તરીકે, કોલ ટ્રાન્સફર વિના Twilio trunk), 405 અથવા 501. કેરિયરે તેને નકાર્યો ન હોય ત્યારે null
bridge_kindસ્ટ્રિંગ | nullફક્ત bridged: cold_fallback (ThunderPhone એ જોડેલો નકારવામાં આવેલ કોલ્ડ ટ્રાન્સફર) અથવા warm (એજન્ટ નીકળી ગયા પછી વોર્મ ટ્રાન્સફરની બે વ્યક્તિઓ)
bridge_secondsપૂર્ણાંક | nullફક્ત bridged: ThunderPhone એ બિલ કરેલો બ્રિજ સમય, સેકન્ડમાં
bridge_total_centsપૂર્ણાંક | nullફક્ત bridged: કોઈપણ મફત કોલ ક્રેડિટ પછી બ્રિજનો USD સેન્ટ્સમાં ખર્ચ, જેનું બિલ કોલના billing_total_cents થી અલગ કરવામાં આવે છે

આ જ મૂલ્યો કોલ ઑબ્જેક્ટ પર transfer_outcome, transfer_destination, transfer_sip_status, transfer_bridge_kind, transfer_bridge_seconds અને transfer_bridge_total_cents તરીકે ઉપલબ્ધ છે. event_id દરેક ડિલિવરીમાં સમાન હોય છે એક કોલ માટે, તેથી પુનરાવર્તિત રિપોર્ટ ક્યારેય બીજું ઇવેન્ટ બનાવતો નથી.

call.billed

માપેલા વપરાશના આધારે બિલ કરાયેલા કૉલ માટે મોકલાય છે: જ્યારે તેનું શુલ્ક નિશ્ચિત થાય, કૉલ પૂરો થયાના થોડી મિનિટો પછી તેનો વપરાશ પ્રાપ્ત થાય ત્યારે, અને પછીથી આવેલ વપરાશ શુલ્ક વધારે ત્યારે ફરીથી. કૉલની telephony.complete / web.complete ઇવેન્ટમાં billing_pending: true અને null બિલિંગ ફીલ્ડ્સ હોય છે. અવરોધરહિત, અને ફક્ત એન્ડપોઇન્ટ્સ પર મોકલાય છે (જૂના એકલ-URL વેબહૂક પર ક્યારેય નહીં). કૉલ પૂરો થાય ત્યારે બિલ કરાયેલા કૉલનું બિલિંગ પૂર્ણતા ઇવેન્ટમાં હોય છે અને તેમને call.billed મળતું નથી.

ક્રમની કોઈ ખાતરી નથી: શુલ્ક સામાન્ય રીતે પૂર્ણતા ઇવેન્ટની રાહ જુએ છે, પરંતુ call.billed તે પહેલાં આવી શકે છે (પૂર્ણતા ઇવેન્ટ એક કલાક માટે અટકાવવામાં આવી હોય અથવા ડિલિવરી અલગ સમયે ફરીથી અજમાવવામાં આવી હોય), અને બે call.billed ઇવેન્ટ્સ ક્રમની બહાર આવી શકે છે. દરેક call_id માટે સૌથી વધુ billing_seq ધરાવતી ઇવેન્ટ રાખો.

{
  "data": {
    "adjustment_cents": null,
    "agent_id": 12,
    "agent_name": "Front desk",
    "billable_minutes": 3.0,
    "billing_seq": 1,
    "billing_total_cents": 10,
    "call_id": 987654321,
    "reason": "settled"
  },
  "event_id": "7c1d2e3f-4a5b-5c6d-8e7f-9a0b1c2d3e4f",
  "type": "call.billed"
}
ફીલ્ડપ્રકારવર્ણન
call_idપૂર્ણાંકજે કૉલનું બિલ કરવામાં આવ્યું હતું
agent_idપૂર્ણાંક | nullકૉલ હેન્ડલ કરનાર એજન્ટ, જ્યારે એજન્ટ સોંપવામાં આવ્યો હોય
agent_nameસ્ટ્રિંગ | nullકૉલ હેન્ડલ કરનાર એજન્ટ, જ્યારે એજન્ટ સોંપવામાં આવ્યો હોય
reasonસ્ટ્રિંગsettled: કૉલનું શુલ્ક. adjusted: શુલ્ક પછી આવેલ વપરાશથી થયેલો વધારો (શુલ્ક ક્યારેય ઘટાડવામાં આવતું નથી)
billing_seqપૂર્ણાંકશુલ્ક માટે 1, પછી દરેક વધારા માટે 2, 3, ... . પ્રાપ્ત થયેલામાંથી સૌથી વધુ મૂલ્ય કૉલનું વર્તમાન બિલિંગ છે
billable_minutesસંખ્યાબિલ કરાયેલી મિનિટો, સૌથી નજીકના ચોથા ભાગની મિનિટ સુધી રાઉન્ડ કરેલી
billing_total_centsપૂર્ણાંકકોઈપણ મફત કૉલ ક્રેડિટ બાદ અને adjusted વધારા સહિત, અત્યાર સુધી કૉલ માટે USD સેન્ટમાં વસૂલ કરાયેલી કુલ રકમ
adjustment_centsપૂર્ણાંક | nullફક્ત adjusted: કોઈપણ મફત કૉલ ક્રેડિટ બાદ, USD સેન્ટમાં આ વધારો

આ જ કુલ રકમો કૉલ ઑબ્જેક્ટ પર billable_minutes અને billing_total_cents તરીકે ઉપલબ્ધ છે. એક જ billing_seq ની દરેક ડિલિવરીમાં event_id સમાન હોય છે, તેથી પુનરાવર્તિત રિપોર્ટ ક્યારેય બીજી ઇવેન્ટ બનાવતો નથી.

call.status_changed

કૉલ ચાલુ હોય ત્યારે, તે જ્યારે પણ નવા તબક્કે પહોંચે ત્યારે મોકલવામાં આવે છે: ThunderPhone ડાયલ કરવાનું શરૂ કરે, વ્યક્તિ અથવા તેમનો ફોન જવાબ આપે, એજન્ટ વૉઇસમેઇલ સુધી પહોંચે, અથવા એજન્ટને હોલ્ડ પર મૂકવામાં આવે અને હોલ્ડમાંથી પાછો લેવામાં આવે. કૉલને અનુસરતી ચૅટ થ્રેડમાં લાઇવ કૉલની પ્રગતિ બતાવવા માટે તેનો ઉપયોગ કરો, ઉદાહરણ તરીકે "ડાયલ થઈ રહ્યું છે…", "જવાબ અપાયો", "હોલ્ડ પર" અને "4 મિનિટ પછી હોલ્ડમાંથી બહાર". આ બિન-અવરોધક છે અને ફક્ત એન્ડપૉઇન્ટ્સ પર જ ડિલિવર થાય છે (લેગસી એક-URL વેબહૂક પર ક્યારેય નહીં).

{
  "data": {
    "agent_id": 12,
    "agent_name": "Front desk",
    "call_id": 987654321,
    "direction": "outbound",
    "hold_seconds": 240,
    "occurred_at": "2026-11-07T17:04:12.418Z",
    "status": "off_hold"
  },
  "event_id": "2f6a1c9e-3b7d-5e8f-9a0b-4c5d6e7f8a9b",
  "type": "call.status_changed"
}
ક્ષેત્રપ્રકારવર્ણન
call_idપૂર્ણાંકકૉલ
agent_idપૂર્ણાંક | nullએજન્ટ સોંપવામાં આવ્યો હોય ત્યારે, કૉલ સંભાળનાર એજન્ટ
agent_nameસ્ટ્રિંગ | nullએજન્ટ સોંપવામાં આવ્યો હોય ત્યારે, કૉલ સંભાળનાર એજન્ટ
directionસ્ટ્રિંગકૉલ ઑબ્જેક્ટમાં દર્શાવ્યા મુજબ કૉલની દિશા
statusસ્ટ્રિંગકૉલ જે તબક્કે પહોંચ્યો; નીચેનું ટેબલ જુઓ
occurred_atટાઇમસ્ટૅમ્પતે ક્યારે થયું
hold_secondsપૂર્ણાંક | nullફક્ત off_hold: હોલ્ડ કેટલા સેકન્ડ ચાલ્યો. અન્ય દરેક સ્થિતિ માટે null
statusક્યારે મોકલવામાં આવે છે
dialingઆઉટબાઉન્ડ કૉલ્સ: ThunderPhone કૉલ લગાવી રહ્યું છે. કૉલ નકારી શકે તેવી દરેક ચકાસણી પસાર થયા પછી, ડાયલ કૅરિયર પાસે જાય તેની તરત પહેલાં મોકલવામાં આવે છે. ડૅશબોર્ડમાંથી શરૂ કરાયેલા ટેસ્ટ કૉલ્સ માટે તે મોકલવામાં આવતું નથી
answeredઆઉટબાઉન્ડ કૉલ્સ: કૅરિયરે કૉલનો જવાબ અપાયો હોવાનું જાણાવ્યું. વૉઇસમેઇલ બૉક્સ અથવા કૉલ સ્ક્રીનર જવાબ આપે તે પણ જવાબ અપાયો ગણાય છે, તેથી પછી voicemail આવી શકે છે. ThunderPhoneને જવાબની જાણ ફક્ત કૉલ-સમાપ્તિ રિપોર્ટમાંથી થાય ત્યારે, કૉલ સમાપ્ત થતાં answered મોકલવામાં આવે છે
voicemailઆઉટબાઉન્ડ કૉલ્સ: એજન્ટ વૉઇસમેઇલ બૉક્સ સુધી પહોંચ્યો છે અને એજન્ટના voicemail_action મુજબ પોતાનો સંદેશ છોડી રહ્યો છે અથવા કૉલ કાપી રહ્યો છે. મેઇલબૉક્સની પુષ્ટિ થાય ત્યારે મોકલવામાં આવે છે (તેના બીપથી, અથવા જવાબ ન મળવાથી), પ્રથમ અનુમાન પર નહીં
on_holdએજન્ટને હોલ્ડ પર મૂકવામાં આવ્યો છે અને તે મૌન રીતે રાહ જોઈ રહ્યો છે (wait_on_hold ટૂલ)
off_holdવ્યક્તિ ફરી લાઇન પર આવી છે અને એજન્ટ ફરી વાત કરી રહ્યો છે. hold_seconds હોલ્ડ કેટલો સમય ચાલ્યો તે દર્શાવે છે

દરેક કૉલ દરેક સ્થિતિ વધુમાં વધુ એક વાર મોકલે છે, સિવાય કે on_hold અને off_hold, જે દરેક હોલ્ડ માટે એક વાર મોકલવામાં આવે છે. હોલ્ડ પર રાહ જોતો સામાન્ય આઉટબાઉન્ડ કૉલ dialing, answered, on_hold, off_hold, અને પછી કૉલ સમાપ્ત થાય ત્યારે telephony.complete મોકલે છે.

રિંગિંગની જાણ કરવામાં આવતી નથી: કેરિયર રિંગિંગનો સંકેત આપે છે કે નહીં તે વિશ્વસનીય રીતે નિર્ભર રહેવા માટે ખૂબ બદલાય છે. જે થોડી voicemail_action: "prompt" કૉલ્સમાં ThunderPhoneને બદલે એજન્ટનો prompt મેઇલબોક્સ પર શું કરવું તે નક્કી કરે છે, તેમાં કોઈ voicemail સ્થિતિ મોકલવામાં આવતી નથી; telephony.complete પરનું answered_by હજી પણ voicemail દર્શાવે છે. payloadમાં કોઈ ટ્રાન્સક્રિપ્ટ, ફોન નંબર અથવા વેરિએબલ્સ હોતા નથી, તેથી જે કૉલ્સનું રેકોર્ડિંગ બંધ હોય તેમના માટે પણ call.status_changed મોકલવામાં આવે છે.


SMS ઇવેન્ટ્સ

SMS ઇવેન્ટ્સ સંસ્થાના કનેક્ટેડ Twilio અથવા Telnyx એકાઉન્ટ દ્વારા મોકલાયેલા સંદેશાઓનું વર્ણન કરે છે. સંદેશાનો મુખ્ય ભાગ સામેલ નથી અને to રેડેક્ટ કરવામાં આવે છે.
સામગ્રી અથવા પ્રાપ્તકર્તાની જરૂર હોય ત્યારે સંસ્થા-સ્કોપવાળો સંદેશો GET /v1/sms/{message_id} પરથી મેળવો. source એ api, agent_tool, followup અથવા pre_call (કૉલ કરતાં પહેલાં કેમ્પેઇનનો ટેક્સ્ટ) હોય છે, જેમ કે સંદેશા ઑબ્જેક્ટ માં છે.

દરેક SMS ઇવેન્ટમાં scheduled_send_id હોય છે: જે નિર્ધારિત મોકલણ માટે ટેક્સ્ટ મોકલવામાં આવ્યો હતો તેનું id, અથવા જે ટેક્સ્ટ નિર્ધારિત ન હતો તેના માટે null. નિર્ધારિત ટેક્સ્ટમાં source "scheduled" હોય છે.

sms.sent

જ્યારે ગ્રાહકનું કેરિયર આઉટબાઉન્ડ SMS વિનંતી સ્વીકારે ત્યારે મોકલાય છે. આ હેન્ડસેટ ડિલિવરી રસીદ નથી.

{
  "data": {
    "accepted_at": "2026-09-19T15:42:10.113Z",
    "agent_id": 12,
    "call_id": 987654321,
    "created_at": "2026-09-19T15:42:09.901Z",
    "direction": "outbound",
    "error_code": null,
    "error_message": null,
    "from_number": "+15551234567",
    "id": "313a3117-827b-46e9-a01a-ac1493838724",
    "provider": "twilio",
    "provider_id": "SM0123456789abcdef0123456789abcdef",
    "scheduled_send_id": null,
    "segment_count": 1,
    "source": "agent_tool",
    "status": "accepted",
    "to": "[REDACTED]"
  },
  "event_id": "0ae347b4-1716-45bb-9a0e-b52373586e37",
  "type": "sms.sent"
}

sms.failed

સ્થાયી કેરિયર અસ્વીકાર પછી, અસ્થાયી પુનઃપ્રયાસો સમાપ્ત થયા પછી, પરિણામ નિશ્ચિત રીતે અજ્ઞાત હોય ત્યારે, અથવા Twilio સ્વીકૃત સંદેશ વિતરિત ન થયો હોવાનું અથવા નિષ્ફળ ગયાનું જણાવે ત્યારે મોકલવામાં આવે છે. છેલ્લા કિસ્સામાં સંદેશનું sms.sent પહેલેથી જ મોકલાઈ ચૂક્યું હોય છે અને status "accepted" જ રહે છે. error_code એક સ્થિર ThunderPhone કોડ છે અને error_message ઉપલબ્ધ હોય ત્યારે ગ્રાહકે કરવાની કાર્યવાહી દર્શાવે છે. status: "unknown" નો અર્થ છે કે કેરિયરે કદાચ SMS સ્વીકાર્યો હોય; કેરિયર લૉગમાં તેનું સમાધાન કરો, કારણ કે ThunderPhone તેને આપમેળે ફરીથી મોકલશે નહીં.

sms.received

ઇનબાઉન્ડ SMS સપોર્ટ માટે આરક્ષિત છે. વર્તમાન રિલીઝમાં કોઈ sms.received ઇવેન્ટ્સ ઉત્સર્જિત થતા નથી. ઇનબાઉન્ડ કેરિયર webhook રૂપરેખાંકન અને સહી ચકાસણી અલગથી ઉપલબ્ધ કરાવવામાં આવશે.


નિર્ધારિત ઇવેન્ટ્સ

બહાર ન જતા નિર્ધારિત મોકલાણો આમાંથી એક ઇવેન્ટ ટ્રિગર કરે છે. બહાર જતું મોકલાણ તેના બદલે સામાન્ય ઇવેન્ટ્સ ટ્રિગર કરે છે: ટેક્સ્ટ માટે sms.* ઇવેન્ટ્સમાં scheduled_send_id સેટ હોય છે, કૉલ માટે કૉલ ઇવેન્ટ્સમાં તેના telephony.complete પર scheduled_send_id હોય છે. બંને બિન-અવરોધક છે. જ્યારે મોકલાણમાં એજન્ટ હોય, ત્યારે તે એજન્ટ માટેના એજન્ટ-સ્કોપવાળા એન્ડપૉઇન્ટ્સ પણ તેમને પ્રાપ્ત કરે છે.

પેલોડમાં ફક્ત ids, સ્ટેટસ અને સમય હોય છે: ક્યારેય ટેક્સ્ટનું બૉડી અથવા કૉલના વેરિએબલ્સ કે કૉન્ટેક્સ્ટ નહીં, અને to રેડેક્ટ કરવામાં આવે છે. બાકીની માહિતી માટે GET /v1/scheduled/{id} મેળવો.

scheduled.skipped

જ્યારે કોઈ મોકલાણ ઇરાદાપૂર્વક મોકલવામાં આવતું નથી ત્યારે મોકલાય છે. reason expired હોય છે (તે expires_at પહેલાં બહાર જઈ શક્યું નહીં), opted_out (નંબર ઓપ્ટ-આઉટ સૂચિમાં છે, જેમાં મોકલાણ બનાવ્યા પછી ઉમેરાયેલ નંબર પણ સામેલ છે), quiet_hours (પ્રાપ્તકર્તાના સમય ઝોનમાં તે સવારે 8 વાગ્યાથી રાત્રે 9 વાગ્યાની બહાર ડ્યૂ થયું), sender_not_ready (ટેક્સ્ટનો નંબર હવે મોકલી શકતો નથી) અથવા outbound_tcpa_unconfirmed (સંસ્થાની TCPA પુષ્ટિ નોંધાય તે પહેલાં કૉલ ડ્યૂ થયો).

{
  "data": {
    "agent_id": null,
    "created_at": "2026-11-01T18:02:11.204Z",
    "detail": "The send could not go out before its expires_at, so it was not sent late.",
    "expires_at": "2026-11-03T17:30:00Z",
    "external_id": "appointment-4815",
    "from_number": "+15551234567",
    "id": "6f1c0b8e-3a52-4c1f-9a0b-2f4f7d8a91c3",
    "reason": "expired",
    "send_at": "2026-11-03T17:00:00Z",
    "source": "api",
    "status": "skipped",
    "to": "[REDACTED]",
    "type": "sms"
  },
  "event_id": "2b0f6c43-74c9-4d43-a1f4-0d6a2f8e51a7",
  "type": "scheduled.skipped"
}

scheduled.failed

ThunderPhone એ મોકલવાનો પ્રયાસ કર્યો હોય અને તે મોકલાઈ ન હોય ત્યારે મોકલવામાં આવે છે. reason એ મોકલવાની પોતાની ભૂલ છે: ટેક્સ્ટ માટે carrier_rejected જેવા SMS ભૂલ કોડ, અથવા કૉલ નકારવાનો કે નિષ્ફળતાનો કારણ, જેમ કે બ્લૉક કરેલા ગંતવ્યનો નિયમ (ઉદાહરણ તરીકે premium_rate) અથવા agent_deleted. પેલોડમાં scheduled.skipped જેવા જ ફીલ્ડ્સ હોય છે.

ફીલ્ડપ્રકારવર્ણન
idstringનિર્ધારિત મોકલવાનો id
typestringsms અથવા call
statusstringskipped અથવા failed
reasonstringઉપર મુજબ શા માટે; મોકલવાના status_reason જેવું જ મૂલ્ય
detailstringવાંચી શકાય તેવું સ્પષ્ટીકરણ
sourcestringમોકલવાનું શેના દ્વારા બનાવાયું: api
external_idstring | nullમોકલવા માટે તમારી કી, અથવા null
from_numberstringમોકલવાનો નંબર
tostringહંમેશાં "[REDACTED]"
agent_idinteger | nullકૉલ્સ: એજન્ટ; ટેક્સ્ટ્સ: null
send_at, expires_at, created_attimestampISO 8601

વૉઇસ ઇવેન્ટ્સ

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

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"
}
ફીલ્ડપ્રકારવર્ણન
voice.idસ્ટ્રિંગકસ્ટમ વૉઇસનો જાહેર ID
voice.nameસ્ટ્રિંગcustom:<public_id> સ્વરૂપમાં એજન્ટ વૉઇસ મૂલ્ય
voice.display_nameસ્ટ્રિંગસંસ્થા-દૃશ્યમાન વૉઇસ નામ
voice.languageસ્ટ્રિંગક્લોનનો એકમાત્ર ભાષા કોડ
voice.genderસ્ટ્રિંગmale, female, અથવા ખાલી સ્ટ્રિંગ
voice.statusસ્ટ્રિંગvoice.ready માટે ready; voice.failed માટે failed
voice.failure_reasonસ્ટ્રિંગસફળતા પર ખાલી; નિષ્ફળતા પર પ્રક્રિયા નિષ્ફળતાની વિગત
voice.created_at, voice.updated_atટાઇમસ્ટેમ્પISO 8601 ટાઇમસ્ટેમ્પ્સ
reasonસ્ટ્રિંગનિષ્ફળતાની વિગત; માત્ર 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…"
    },
    "report": null
  },
  "event_id": "7c1d2e3f-4a5b-4c6d-8e9f-0a1b2c3d4e5f",
  "type": "call.graded"
}
ફીલ્ડપ્રકારવર્ણન
agent_idinteger | nullકૉલ સંભાળનાર એજન્ટ, જ્યારે કોઈ એજન્ટ અસાઇન કરાયેલ હોય
agent_namestring | nullકૉલ સંભાળનાર એજન્ટ, જ્યારે કોઈ એજન્ટ અસાઇન કરાયેલ હોય
grade.idintegerગ્રેડ id
grade.scoreinteger | null0–100
grade.call_outcomestringsuccess, failure, unknown, અથવા no_conversation
grade.summarystringએક-ફકરાનો સારાંશ
grade.detected_issuesarrayગ્રેડર દ્વારા મળેલી સમસ્યાની સ્ટ્રિંગ્સ
grade.statusstringહંમેશા completed — ફક્ત પૂર્ણ થયેલા રન જ ઉત્સર્જિત થાય છે
grade.grader_modelstringપરિણામ આપનાર ગ્રેડર: ઝડપી કામચલાઉ ગ્રેડ માટે heuristic-v1 (અથવા અન્ય ThunderPhone નિયમ-આધારિત ગ્રેડર), સંપૂર્ણ ગ્રેડ માટે thunderphone-grader. આ ThunderPhone લેબલ છે, AI મોડેલનું નામ નથી
grade.graded_at, grade.created_attimestamp
reportobject | nullગ્રાહકને દેખાતો કૉલ રિપોર્ટ: પરિણામ લેબલ, ધ્યાન જરૂરી છે તે ફ્લૅગ અને કારણ, કૉલર, એક-લાઇન સારાંશ, કૉલર અનુભવ. પ્રારંભિક હ્યુરિસ્ટિક ગ્રેડમાં તે null અથવા pending રિપોર્ટ હોય છે, જેના ફીલ્ડ્સ પ્લેસહોલ્ડર હોય છે; સંપૂર્ણ ગ્રેડની ઇવેન્ટમાં પૂર્ણ થયેલો રિપોર્ટ હોય છે

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": "thunderphone-extractor",
    "summary": "Alex Morgan called to book a follow-up visit and confirmed Thursday, April 23."
  },
  "event_id": "4d79ef1d-c2b1-4ed6-85b8-8326bd2895ef",
  "type": "call.data_extracted"
}
ફીલ્ડપ્રકારવર્ણન
agent_idપૂર્ણાંક | nullસોંપાયેલ હોય ત્યારે કૉલ સંભાળનાર એજન્ટ
agent_nameસ્ટ્રિંગ | nullસોંપાયેલ હોય ત્યારે કૉલ સંભાળનાર એજન્ટ
summaryસ્ટ્રિંગ | nullએજન્ટમાં કૉલ સારાંશ જનરેટ કરો ચાલુ હોય ત્યારે પૂર્ણ થયેલ કૉલ સારાંશ, જેથી મોડું એક્સ્ટ્રેક્શન ઇવેન્ટ પૂર્ણતા વિન્ડો ચૂકી ગયેલો સારાંશ પણ પહોંચાડે છે; અન્યથા null. સારાંશ ધરાવતા પરંતુ એક્સ્ટ્રેક્શન ફીલ્ડ વિનાના એજન્ટો ક્યારેય આ ઇવેન્ટ મોકલતા નથી: મોડો સારાંશ GET /v1/calls/{call_id} માંથી વાંચો
extracted_data.statusસ્ટ્રિંગઆ ઇવેન્ટ માટે હંમેશા completed
extracted_data.fieldsઑબ્જેક્ટરૂપરેખાંકિત એક્સ્ટ્રેક્શન ફીલ્ડ કીઓ દ્વારા કી કરાયેલા મૂલ્યો; અનુપલબ્ધ મૂલ્યો null છે
extracted_data.evidenceઑબ્જેક્ટએક્સ્ટ્રેક્શન ફીલ્ડ દ્વારા કી કરાયેલ પુરાવો. નૉન-નલ મૂલ્યમાં ચોક્કસ માળખાકીય રીતે ચકાસાયેલ અવતરણ (વધુમાં વધુ 1,000 અક્ષરો), speaker_role (caller અથવા agent), અને turn_index હોય છે; મોડેલ દ્વારા પરત કરાયેલા લાંબા અવતરણો ટૂંકા કરવાને બદલે નકારવામાં આવે છે, અને જ્યારે તેનું ફીલ્ડ null હોય ત્યારે પુરાવો null હોય છે
extracted_data.verificationસ્ટ્રિંગદરેક ઉમેદવાર ફીલ્ડ માટે સ્વતંત્ર પુરાવા પાસ દ્વારા ચોક્કસ એક માન્ય નિર્ણય પરત કરવામાં આવ્યો હોય ત્યારે જ verified. unavailable નો અર્થ છે કે પાસ નિષ્ફળ ગયો, સમય સમાપ્ત થયો, પૂરતું બજેટ ન હતું, અથવા ખોટું રચાયેલ કે આંશિક આઉટપુટ પરત કર્યું. સંપૂર્ણપણે અનુપલબ્ધ પાસ ગ્રાહક સમીક્ષા માટે માળખાકીય રીતે આધારિત મૂલ્યો જાળવી રાખે છે. આંશિક આઉટપુટ માટે, માન્ય નિર્ણયો લાગુ કરવામાં આવે છે અને ચોક્કસ એક માન્ય નિર્ણય વિનાના દરેક ઉમેદવારને નલ કરવામાં આવે છે
extracted_data.field_reasonsઑબ્જેક્ટમાળખાકીય આધાર અથવા સ્વતંત્ર ચકાસક દ્વારા નલ કરાયેલા ફીલ્ડ્સ દ્વારા કી કરાયેલા કારણો
extracted_data.schema_versionસ્ટ્રિંગઆ એક્સ્ટ્રેક્શન માટે ઉપયોગમાં લેવાયેલી ચોક્કસ ફીલ્ડ સ્કીમાનો હૅશ
extracted_atટાઇમસ્ટૅમ્પISO 8601 પૂર્ણતા સમય
modelસ્ટ્રિંગહંમેશા thunderphone-extractor: એક્સ્ટ્રેક્શન મોડેલ માટેનું ThunderPhone લેબલ, AI મોડેલનું નામ નહીં

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,
      "skipped": 4,
      "remaining": 0
    }
  },
  "event_id": "8d8f52ce-6b46-423f-9dde-cea0b91ec135",
  "type": "campaign.completed"
}

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

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"
}
ફીલ્ડપ્રકારવર્ણન
agent_idinteger | nullજ્યારે એજન્ટ અસાઇન કરાયેલ હોય ત્યારે કૉલ હેન્ડલ કરનાર એજન્ટ
agent_namestring | nullજ્યારે એજન્ટ અસાઇન કરાયેલ હોય ત્યારે કૉલ હેન્ડલ કરનાર એજન્ટ
issue_report.severitystringcritical, warning, અથવા info
issue_report.statusstringopen અથવા resolved
issue_report.sourcestringuser (ડૅશબોર્ડમાંથી ફાઇલ કરેલ) અથવા system (ગ્રેડિંગ દ્વારા બનાવેલ)

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"
}
ફીલ્ડપ્રકારવર્ણન
automaticbooleanઆપમેળે એસ્કેલેશન માટે true; મેન્યુઅલ એસ્કેલેશન માટે false
cluster_idUUIDએસ્કેલેટ કરેલ સમસ્યા પેટર્ન
escalation_idUUIDએસ્કેલેશન રેકોર્ડ
statusstringઇવેન્ટ મોકલાય ત્યારે open

આ નોટિફિકેશન છે, પુરાવા બંડલ નથી. તેને સમસ્યા પેટર્ન સાથે સંબંધિત કરવા માટે 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"
}
ફીલ્ડપ્રકારવર્ણન
agent_idinteger | nullજ્યારે એજન્ટ અસાઇન કરવામાં આવ્યો હોય ત્યારે કૉલ હેન્ડલ કરનાર એજન્ટ
agent_namestring | nullજ્યારે એજન્ટ અસાઇન કરવામાં આવ્યો હોય ત્યારે કૉલ હેન્ડલ કરનાર એજન્ટ
test_call_run.target_typestringagent અથવા phone_number
test_call_run.target_idintegerરન દ્વારા લક્ષિત એજન્ટ id અથવા ફોન-નંબર id, જે target_type સાથે મેળ ખાતી હોય
test_call_run.statusstringcompleted અથવા failed
test_call_run.call_idinteger | nullકૉલ કરવામાં આવે તે પહેલાં રન નિષ્ફળ જાય ત્યારે null
test_call_run.error_messagestringસફળતા પર ખાલી

એલર્ટ ઇવેન્ટ્સ

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"
}
ફીલ્ડપ્રકારવર્ણન
event_id (માં data)UUIDએલર્ટ ટ્રિગરિંગ id — એન્વલપના ડિલિવરી event_idથી અલગ
rule_id, rule_nameUUID, stringટ્રિગર થયેલો નિયમ
metricstringsuccess_rate, failure_rate, avg_score, call_volume, અથવા suite_regression
comparatorstringlt, lte, gt, અથવા gte
metric_valuenumberનિયમ ટ્રિગર થયો ત્યારે વિન્ડોમાં મેટ્રિકનું મૂલ્ય
thresholdnumberકન્ફિગર કરેલી થ્રેશોલ્ડ
window_hoursintegerપાછલી મૂલ્યાંકન વિન્ડો
fired_attimestamp

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


ફોન નંબર ઇવેન્ટ્સ

phone_number.spam_risk_changed

સ્પામ-લેબલ મોનિટરિંગ (ચૂકવવાપાત્ર એડ-ઓન, સપોર્ટ દ્વારા વિનંતી પર) મોનિટર કરેલા નંબરનું સ્પામ જોખમ medium અથવા high સુધી વધતું જુએ ત્યારે મોકલાય છે (lowમાંથી, હજી કોઈ રીડિંગ ન હોય ત્યારે, અથવા mediumમાંથી high સુધી). અવરોધરહિત. ફ્લેગ થયેલો નંબર ફ્લેગ જ રહે તો ફરી મોકલાતો નથી; જે low સુધી પુનઃપ્રાપ્ત થાય અને પછી ફ્લેગ થાય તે મોકલાય છે. ઇવેન્ટમાં કોઈ એજન્ટ કોન્ટેક્સ્ટ નથી, તેથી ફક્ત સંસ્થા-વ્યાપી એન્ડપોઇન્ટ્સને જ તે મળે છે. સંસ્થાના માલિકો અને એડમિન્સને પણ ઇમેઇલ મળે છે.

{
  "data": {
    "checked_at": "2026-10-21T14:41:07+00:00",
    "phone_number": "+13125550100",
    "phone_number_id": 412,
    "previous_spam_risk": "low",
    "scores": {
      "connection": 31,
      "engagement": 40,
      "maturity": 82,
      "sentiment": 22
    },
    "spam_category": "Telemarketer",
    "spam_risk": "high"
  },
  "event_id": "6f1c2d3e-4b5a-4c6d-8e7f-9a0b1c2d3e4f",
  "type": "phone_number.spam_risk_changed"
}
ફીલ્ડપ્રકારવર્ણન
phone_numberસ્ટ્રિંગનંબર, E.164 ફોર્મેટમાં
phone_number_idઇન્ટિજર | nullPhone Numbersમાં તેનું id
spam_riskસ્ટ્રિંગmedium અથવા high
previous_spam_riskસ્ટ્રિંગ | nullછેલ્લા રીડિંગનું જોખમ; પ્રથમ રીડિંગ પહેલાં null
spam_categoryસ્ટ્રિંગ | nullકેરિયર્સ બતાવી શકે તેવું લેબલ, જેમ કે Telemarketer અથવા Survey. તેને ફ્રી ટેક્સ્ટ તરીકે ગણો
scoresઑબ્જેક્ટદરેક 0 થી 100, અથવા પૂરતું કૉલ વોલ્યુમ ન થાય ત્યાં સુધી null: maturity (નંબર કેટલો સ્થાપિત છે), connection (લોકો જવાબ આપે છે કે નહીં), engagement (તેઓ કૉલ પર રહે છે કે નહીં), sentiment (તેઓ તેને બ્લોક કરે છે કે રિપોર્ટ કરે છે)
checked_atટાઇમસ્ટૅમ્પThunderPhoneએ પરિણામ ક્યારે વાંચ્યું

સ્થળાંતરણ ઇવેન્ટ્સ

migration.call.complete

જે કૉલ POST /v1/migrations/{id}/calls દ્વારા કરવામાં આવ્યો હોય તે સમાપ્ત થાય ત્યારે મોકલવામાં આવે છે, પછી તે કોઈપણ પ્લેટફોર્મે લીધો હોય. આ અવરોધરહિત છે. કૉલ સમાપ્ત થયા પછી લગભગ 5 મિનિટ સુધીમાં તે આવે છે. data માં telephony.complete ના દરેક ફીલ્ડ ઉપરાંત migration બ્લોક હોય છે. ThunderPhone દ્વારા કરવામાં આવેલ કૉલ પણ એ જ call_id સાથે, સામાન્ય રીતે, telephony.complete મોકલે છે. બીજા પ્લેટફોર્મે લીધેલા કૉલ માટે answered_by null હોય છે. બીજા પ્લેટફોર્મ પરનો એવો કૉલ જે 2 કલાક પછી પણ સમાપ્ત ન થયો હોય, અથવા જેનું માઇગ્રેશન પહેલાં પૂર્ણ થયું હોય કે તેની કી ખોવાઈ ગઈ હોય, તેને status: "unknown" અને કોઈ ટ્રાન્સક્રિપ્ટ વિના મોકલવામાં આવે છે.

{
  "data": {
    "agent_id": 42,
    "agent_name": "Front desk",
    "answered_by": null,
    "billable_minutes": null,
    "billing_total_cents": null,
    "call_id": null,
    "direction": "outbound",
    "duration_seconds": 94,
    "end_reason": "user_hangup",
    "end_time": "2026-10-06T17:01:34+00:00",
    "extracted_data": null,
    "from_number": "+15551234567",
    "migration": {
      "arm": "vendor",
      "id": "5f0c2a9e-7b1d-4c3e-8a6f-2d9e1b4c7a30",
      "metadata": {
        "lead_id": "8812"
      },
      "routing_id": "9b2f8c1e-4d3a-4f6b-8e2d-1a7c5b9e0f34",
      "vendor": "retell",
      "vendor_call_id": "call_6a1f0e",
      "vendor_cost_usd": "0.1240"
    },
    "product": "",
    "recording_mode": "vendor",
    "recording_url": "https://…",
    "start_time": "2026-10-06T17:00:00+00:00",
    "status": "completed",
    "summary": "The callee booked a table for two on Thursday.",
    "thunderphone_retained_call_content": true,
    "to_number": "+14155552671",
    "transcripts": [
      {
        "content": "Hi Ada, this is Rosa's calling about your booking.",
        "role": "agent"
      },
      {
        "content": "Yes, Thursday works.",
        "role": "user"
      }
    ],
    "transfer_number": null,
    "unresolved_variables": [],
    "variables": {
      "first_name": "Ada"
    },
    "voice": ""
  },
  "event_id": "7c1e2f3a-4b5c-4d6e-8f7a-9b0c1d2e3f4a",
  "type": "migration.call.complete"
}
ફીલ્ડપ્રકારવર્ણન
migration.idUUIDસ્થળાંતરણ
migration.routing_idUUIDરૂટ કરાયેલ કૉલ, જે તમે કૉલ કરતાં સમયે મેળવ્યો હતો
migration.armstringours (ThunderPhone એ કૉલ કર્યો) અથવા vendor (અન્ય પ્લેટફોર્મે કર્યો)
migration.vendorstringretell, vapi, elevenlabs, અથવા bland
migration.vendor_call_idstring | nullઅન્ય પ્લેટફોર્મનો કૉલ આઈડી; ours માટે null
migration.metadataobjectકૉલ કરતાં સમયે તમે મોકલેલ metadata
migration.vendor_cost_usdstring | nullઅન્ય પ્લેટફોર્મે ઉપલબ્ધ કરાવ્યું હોય ત્યારે, તેણે જણાવેલ કૉલનો ખર્ચ
call_idinteger | nullThunderPhone કૉલ આઈડી; vendor માટે null
statusstringvendor માટે: કૉલ પ્રાપ્તકર્તાએ વાત કરી હોય ત્યારે completed, ન કરી હોય ત્યારે failed, ઉપર મુજબ unknown. ours માટે: telephony.complete મુજબ

vendor કૉલ માટે ThunderPhone પાસે બિલિંગ અથવા એક્સ્ટ્રેક્શન ડેટા હોતો નથી: billable_minutes, billing_total_cents અને extracted_data null હોય છે, product અને voice ખાલી હોય છે, recording_mode vendor હોય છે, અને અન્ય પ્લેટફોર્મે લિંક આપી હોય ત્યારે recording_url તેની લિંક હોય છે.

migration.rollback

જ્યારે માઇગ્રેશનનો ક્રમશઃ સ્વિચ દરેક કૉલને આપમેળે બીજા પ્લેટફોર્મ પર પાછો ખસેડે ત્યારે મોકલવામાં આવે છે: 15 મિનિટમાં 3 કૉલ ThunderPhone સાથે કનેક્ટ કરવામાં નિષ્ફળ ગયા, ThunderPhone પર મોકલાયેલા 2 કૉલ એજન્ટે જવાબ આપતા પહેલાં સમાપ્ત થયા, અથવા ThunderPhoneનો કાર્ય પરિણામ દર રૂપરેખાંકિત અંતર કરતાં બીજા પ્લેટફોર્મના દરથી વધુ નીચે ગયો. અવરોધરહિત, દરેક રોલબેક દીઠ એકવાર. ત્યારબાદ, ThunderPhoneનો હિસ્સો 0% હોય છે અને કોઈ વ્યક્તિ એજન્ટના માઇગ્રેશન ટૅબમાં તેને ફરી શરૂ ન કરે ત્યાં સુધી માઇગ્રેશન થોભાવાયેલું રહે છે. પેલોડમાં કોઈ ફોન નંબર, ટ્રાન્સક્રિપ્ટ અથવા કૉલ ID હોતા નથી.

{
  "data": {
    "agent_id": 42,
    "agent_name": "Front desk",
    "dropped": 0,
    "migration_id": "5f0c2a9e-7b1d-4c3e-8a6f-2d9e1b4c7a30",
    "ours": {
      "graded": 20,
      "success_rate": 0.8
    },
    "ours_failed": 3,
    "ours_percent": 0,
    "previous_percent": 25,
    "reason": "ours_failed_burst",
    "rolled_back_at": "2026-10-10T12:05:00+00:00",
    "step": 1,
    "theirs": {
      "graded": 20,
      "success_rate": 0.8
    },
    "vendor": "retell"
  },
  "event_id": "3d1f6b2a-8c4e-5a7b-9d0e-2f1a3b4c5d6e",
  "type": "migration.rollback"
}
ક્ષેત્રપ્રકારવર્ણન
migration_idUUIDમાઇગ્રેશન
vendorસ્ટ્રિંગretell, vapi, elevenlabs, અથવા bland
reasonસ્ટ્રિંગours_failed_burst (15 મિનિટમાં 3 નિષ્ફળ કનેક્શન), dropped_calls (30 મિનિટમાં એજન્ટે જવાબ આપતા પહેલાં સમાપ્ત થયેલા 2 કૉલ), અથવા rate_gap (દરેક બાજુએ ઓછામાં ઓછા rollback_min_calls મૂલ્યાંકિત કૉલ્સમાં કાર્ય પરિણામ દરનું અંતર)
previous_percentપૂર્ણાંકરોલબેક પહેલાં ThunderPhoneનો કૉલ્સમાં હિસ્સો
ours_percentપૂર્ણાંકહંમેશા 0
stepપૂર્ણાંક | nullતે જે શેડ્યૂલ પગલા પર હતું (0-આધારિત)
ours / theirsઑબ્જેક્ટ | nullવર્તમાન પગલામાં મૂલ્યાંકિત કૉલ્સ અને તેમનો સફળતા દર; જ્યારે પગલામાં ખૂબ ઓછા કૉલ્સ હોય ત્યારે theirs છેલ્લા 30 દિવસનો હોઈ શકે છે. કોઈ ન હોય ત્યારે null
ours_failedપૂર્ણાંકછેલ્લા 15 મિનિટમાં ગણાયેલા નિષ્ફળ કનેક્શન
droppedપૂર્ણાંકછેલ્લા 30 મિનિટમાં ડ્રૉપ થયેલા તરીકે ગણાયેલા કૉલ્સ
rolled_back_atટાઇમસ્ટેમ્પ

સંબંધિત