Open in
ઇવેન્ટ્સ કેટલોગ
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_id | integer | null | એજન્ટ સોંપાયેલ હોય ત્યારે કૉલ સંભાળનાર એજન્ટ |
agent_name | string | null | એજન્ટ સોંપાયેલ હોય ત્યારે કૉલ સંભાળનાર એજન્ટ |
returning_call | object | નંબરએ છેલ્લા 30 દિવસમાં આ કૉલરને કૉલ કર્યો હોય ત્યારે જ હાજર: અગાઉના કૉલનું call_id, agent_id, started_at અને outcome. કૉલબૅક્સ જુઓ |
sip_headers | object | કૉલ X-* અથવા User-to-User SIP હેડર્સ સાથે આવ્યો હોય ત્યારે જ હાજર (SIP સરનામાં અને મેન્યુઅલ SIP કનેક્શન્સ): હેડરનું નામ લોઅરકેસમાં → મૂલ્ય. SIP હેડર્સ જુઓ |
telephony.complete
જ્યારે ઇનબાઉન્ડ અથવા આઉટબાઉન્ડ ટેલિફોની કૉલ સમાપ્ત થાય ત્યારે મોકલવામાં આવે છે. નૉન-બ્લોકિંગ. તેમાં ટ્રાન્સક્રિપ્ટ, ઉપલબ્ધ હોય ત્યારે રેકોર્ડિંગ URL અને બિલિંગ સારાંશનો સમાવેશ થાય છે. પેલોડ સ્કીમા માટે telephony.complete / web.complete જુઓ.
| ક્ષેત્ર | પ્રકાર | વર્ણન |
|---|---|---|
agent_id | integer | null | જ્યારે એજન્ટ સોંપાયેલ હોય, ત્યારે કૉલ સંભાળનાર એજન્ટ |
agent_name | string | 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_id | integer | null | જ્યારે એજન્ટ સોંપાયેલ હોય, ત્યારે કૉલ સંભાળનાર એજન્ટ |
agent_name | string | 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_id | integer | null | જ્યારે એજન્ટ સોંપાયેલ હોય, ત્યારે કૉલ સંભાળનાર એજન્ટ |
agent_name | string | null | જ્યારે એજન્ટ સોંપાયેલ હોય, ત્યારે કૉલ સંભાળનાર એજન્ટ |
position | integer | કૉલ ઇતિહાસમાં ટર્નનો ઇન્ડેક્સ — ક્રમ માટે સ્થિર ઓળખ |
role | string | assistant (એજન્ટનું ભાષણ) અથવા user (કૉલરનું ભાષણ) |
text | string | ઇમિશન સમયે જાણીતી ટર્નની ટ્રાન્સક્રિપ્ટ ટેક્સ્ટ |
entry_type | string | અંતર્ગત ઇતિહાસ એન્ટ્રી પ્રકાર: completion (એજન્ટ), અથવા user_turn / span (કૉલર) |
start_ms, end_ms | integer | કૉલ શરૂ થયા પછી 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_id | integer | null | જ્યારે એજન્ટ સોંપાયેલ હોય, ત્યારે કૉલ સંભાળનાર એજન્ટ |
agent_name | string | null | જ્યારે એજન્ટ સોંપાયેલ હોય, ત્યારે કૉલ સંભાળનાર એજન્ટ |
web.complete
telephony.completeનું વેબ-ચેનલ સમકક્ષ, જે વેબ વિજેટ કૉલ્સ (direction: "web") અને બિલ્ડર માઇક ટેસ્ટ કૉલ્સ (direction: "test")ને આવરી લે છે. નૉન-બ્લોકિંગ. telephony.complete જેવો જ પેલોડ આકાર, ઉપરાંત origin_domain, જેમાં from_numberને "web" પર સેટ કરવામાં આવે છે.
| ક્ષેત્ર | પ્રકાર | વર્ણન |
|---|---|---|
agent_id | integer | null | જ્યારે એજન્ટ સોંપાયેલ હોય, ત્યારે કૉલ સંભાળનાર એજન્ટ |
agent_name | string | null | જ્યારે એજન્ટ સોંપાયેલ હોય, ત્યારે કૉલ સંભાળનાર એજન્ટ |
web.tool
telephony.toolનું વેબ-ચેનલ સમકક્ષ. dataમાં from_number / to_numberના બદલે origin_domain હોય છે.
| ક્ષેત્ર | પ્રકાર | વર્ણન |
|---|---|---|
agent_id | integer | null | જ્યારે એજન્ટ સોંપાયેલ હોય, ત્યારે કૉલ સંભાળનાર એજન્ટ |
agent_name | string | null | જ્યારે એજન્ટ સોંપાયેલ હોય, ત્યારે કૉલ સંભાળનાર એજન્ટ |
web.turn
telephony.turnનું વેબ-ચેનલ સમકક્ષ, જે વેબ વિજેટ કૉલ્સ અને બિલ્ડર માઇક ટેસ્ટ કૉલ્સને આવરી લે છે. સમાન પેલોડ આકાર, જેમાં from_number / to_numberના બદલે origin_domain હોય છે. telephony.turnની જેમ, તેને સ્પષ્ટ સબ્સ્ક્રિપ્શન જરૂરી છે — તે ખાલી events એરે દ્વારા ક્યારેય ડિલિવર થતું નથી.
| ક્ષેત્ર | પ્રકાર | વર્ણન |
|---|---|---|
agent_id | integer | null | જ્યારે એજન્ટ સોંપાયેલ હોય, ત્યારે કૉલ સંભાળનાર એજન્ટ |
agent_name | string | 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 જેવા જ
ફીલ્ડ્સ હોય છે.
| ફીલ્ડ | પ્રકાર | વર્ણન |
|---|---|---|
id | string | નિર્ધારિત મોકલવાનો id |
type | string | sms અથવા call |
status | string | skipped અથવા failed |
reason | string | ઉપર મુજબ શા માટે; મોકલવાના status_reason જેવું જ મૂલ્ય |
detail | string | વાંચી શકાય તેવું સ્પષ્ટીકરણ |
source | string | મોકલવાનું શેના દ્વારા બનાવાયું: api |
external_id | string | null | મોકલવા માટે તમારી કી, અથવા null |
from_number | string | મોકલવાનો નંબર |
to | string | હંમેશાં "[REDACTED]" |
agent_id | integer | null | કૉલ્સ: એજન્ટ; ટેક્સ્ટ્સ: null |
send_at, expires_at, created_at | timestamp | ISO 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_id | integer | null | કૉલ સંભાળનાર એજન્ટ, જ્યારે કોઈ એજન્ટ અસાઇન કરાયેલ હોય |
agent_name | string | null | કૉલ સંભાળનાર એજન્ટ, જ્યારે કોઈ એજન્ટ અસાઇન કરાયેલ હોય |
grade.id | integer | ગ્રેડ id |
grade.score | integer | null | 0–100 |
grade.call_outcome | string | success, failure, unknown, અથવા no_conversation |
grade.summary | string | એક-ફકરાનો સારાંશ |
grade.detected_issues | array | ગ્રેડર દ્વારા મળેલી સમસ્યાની સ્ટ્રિંગ્સ |
grade.status | string | હંમેશા completed — ફક્ત પૂર્ણ થયેલા રન જ ઉત્સર્જિત થાય છે |
grade.grader_model | string | પરિણામ આપનાર ગ્રેડર: ઝડપી કામચલાઉ ગ્રેડ માટે heuristic-v1 (અથવા અન્ય ThunderPhone નિયમ-આધારિત ગ્રેડર), સંપૂર્ણ ગ્રેડ માટે thunderphone-grader. આ ThunderPhone લેબલ છે, AI મોડેલનું નામ નથી |
grade.graded_at, grade.created_at | timestamp | |
report | object | 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_id | integer | null | જ્યારે એજન્ટ અસાઇન કરાયેલ હોય ત્યારે કૉલ હેન્ડલ કરનાર એજન્ટ |
agent_name | string | null | જ્યારે એજન્ટ અસાઇન કરાયેલ હોય ત્યારે કૉલ હેન્ડલ કરનાર એજન્ટ |
issue_report.severity | string | critical, warning, અથવા info |
issue_report.status | string | open અથવા resolved |
issue_report.source | string | user (ડૅશબોર્ડમાંથી ફાઇલ કરેલ) અથવા 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"
}| ફીલ્ડ | પ્રકાર | વર્ણન |
|---|---|---|
automatic | boolean | આપમેળે એસ્કેલેશન માટે true; મેન્યુઅલ એસ્કેલેશન માટે false |
cluster_id | UUID | એસ્કેલેટ કરેલ સમસ્યા પેટર્ન |
escalation_id | UUID | એસ્કેલેશન રેકોર્ડ |
status | string | ઇવેન્ટ મોકલાય ત્યારે 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_id | integer | null | જ્યારે એજન્ટ અસાઇન કરવામાં આવ્યો હોય ત્યારે કૉલ હેન્ડલ કરનાર એજન્ટ |
agent_name | string | null | જ્યારે એજન્ટ અસાઇન કરવામાં આવ્યો હોય ત્યારે કૉલ હેન્ડલ કરનાર એજન્ટ |
test_call_run.target_type | string | agent અથવા phone_number |
test_call_run.target_id | integer | રન દ્વારા લક્ષિત એજન્ટ id અથવા ફોન-નંબર id, જે target_type સાથે મેળ ખાતી હોય |
test_call_run.status | string | completed અથવા failed |
test_call_run.call_id | integer | null | કૉલ કરવામાં આવે તે પહેલાં રન નિષ્ફળ જાય ત્યારે null |
test_call_run.error_message | string | સફળતા પર ખાલી |
એલર્ટ ઇવેન્ટ્સ
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_name | UUID, string | ટ્રિગર થયેલો નિયમ |
metric | string | success_rate, failure_rate, avg_score, call_volume, અથવા suite_regression |
comparator | string | lt, lte, gt, અથવા gte |
metric_value | number | નિયમ ટ્રિગર થયો ત્યારે વિન્ડોમાં મેટ્રિકનું મૂલ્ય |
threshold | number | કન્ફિગર કરેલી થ્રેશોલ્ડ |
window_hours | integer | પાછલી મૂલ્યાંકન વિન્ડો |
fired_at | timestamp |
નિયમો, મેટ્રિક્સ, કૂલડાઉન્સ અને ઇમેઇલ / 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 | ઇન્ટિજર | null | Phone 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.id | UUID | સ્થળાંતરણ |
migration.routing_id | UUID | રૂટ કરાયેલ કૉલ, જે તમે કૉલ કરતાં સમયે મેળવ્યો હતો |
migration.arm | string | ours (ThunderPhone એ કૉલ કર્યો) અથવા vendor (અન્ય પ્લેટફોર્મે કર્યો) |
migration.vendor | string | retell, vapi, elevenlabs, અથવા bland |
migration.vendor_call_id | string | null | અન્ય પ્લેટફોર્મનો કૉલ આઈડી; ours માટે null |
migration.metadata | object | કૉલ કરતાં સમયે તમે મોકલેલ metadata |
migration.vendor_cost_usd | string | null | અન્ય પ્લેટફોર્મે ઉપલબ્ધ કરાવ્યું હોય ત્યારે, તેણે જણાવેલ કૉલનો ખર્ચ |
call_id | integer | null | ThunderPhone કૉલ આઈડી; vendor માટે null |
status | string | vendor માટે: કૉલ પ્રાપ્તકર્તાએ વાત કરી હોય ત્યારે 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_id | UUID | માઇગ્રેશન |
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 | ટાઇમસ્ટેમ્પ |
સંબંધિત
અવરોધક ઇનબાઉન્ડ-કૉલ પેલોડ, જેના માટે તમારે પ્રતિસાદ આપવો આવશ્યક છે.
કૉલ પછીનો ટ્રાન્સક્રિપ્ટ અને મેટ્રિક્સ.
આ ઇવેન્ટ્સના ઉપસમૂહ માટે URL સબ્સ્ક્રાઇબ કરો.
telephony.tool / web.tool ઇવેન્ટ્સ કેવી રીતે જનરેટ થાય છે.