Open in
நிகழ்வு பட்டியல்
ThunderPhone வெளியிடும் அனைத்து webhook நிகழ்வு வகைகளும்.
ஒவ்வொரு webhook உடலிலும் type புலம் இருக்கும்; அதன் மதிப்பு இந்தப் பக்கத்தில் உள்ள நிகழ்வு வகைகளில் ஒன்றாகும். நீங்கள் ஒரு
எண்ட்பாயிண்ட்டுக்கு சந்தா செலுத்தும்போது, events வரிசையில் நீங்கள் விரும்பும்
நிகழ்வு வகைகள் இருக்க வேண்டும் (அல்லது அனைத்திற்கும் சந்தா செலுத்த காலியாக இருக்கலாம் —
ஆனால் ஒவ்வொரு turn-க்கான நிகழ்வுகளான telephony.turn /
web.turn மற்றும் நேரடி முன்னேற்ற நிகழ்வான
call.status_changed தவிர; இவை அவற்றை வெளிப்படையாகப் பெயரிடும்
எண்ட்பாயிண்ட்டுகளுக்கு மட்டுமே அனுப்பப்படும்).
இந்த நிகழ்வுகள் இரண்டு விநியோக முறைகளில் அனுப்பப்படுகின்றன:
- எண்ட்பாயிண்ட் டெலிவரிகள் எப்போதும் மீண்டும் முயற்சிகளுடன் தடையற்ற அறிவிப்புகளாக இருக்கும்: ஏதேனும் 2xx-உடன் பதிலளிக்கவும்; உறையில் நகல்நீக்கத்திற்கான
event_idஇருக்கும். - தடுக்கும் பரிமாற்றங்கள் மரபு ஒற்றை-URL வெப்ஹுக் இல் மட்டும் இயங்கும்:
telephony.incoming/web.incomingகட்டமைப்பு கோரிக்கை (வெப்ஹுக்-முறை எண்கள்: ஒரு மீண்டும் முயற்சி உட்பட 13 வி; வெப்ஹுக்-முறை விட்ஜெட் விசைகள்: 10 வி) மற்றும் வெப்ஹுக்-முறை கருவி அனுப்பல். உங்கள் பதில் நேரடி அழைப்பை வடிவமைக்கும்.
கீழே உள்ள எடுத்துக்காட்டு payload-கள் endpoint உறையை அதன் wire வரிசையில் காட்டுகின்றன
(விசைகள் அகரவரிசைப்படி வரிசைப்படுத்தப்பட்டுள்ளன: 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 வெப்ஹூக்கிற்கு ஒருபோதும் அனுப்பப்படாது). அழைப்பின் 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 டிரங்க்), 405 அல்லது 501. கேரியர் மறுக்காதபோது null |
bridge_kind | சரம் | null | bridged-க்கு மட்டும்: cold_fallback (ThunderPhone இணைத்த, மறுக்கப்பட்ட குளிர் மாற்றம்) அல்லது warm (ஏஜென்ட் விலகிய பிறகு வார்ம் மாற்றத்தில் உள்ள இரு நபர்கள்) |
bridge_seconds | முழுஎண் | null | bridged-க்கு மட்டும்: ThunderPhone கட்டணமிட்ட இணைக்கப்பட்ட நேரம், வினாடிகளில் |
bridge_total_cents | முழுஎண் | null | bridged-க்கு மட்டும்: இலவச அழைப்பு கிரெடிட் இருந்தால் அதற்குப் பிறகு, அழைப்பின் billing_total_cents-இலிருந்து தனியாகக் கட்டணமிடப்பட்ட பாலத்தின் USD சென்ட் செலவு |
இதே மதிப்புகள் அழைப்பு ஆப்ஜெக்டில்
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-யையும் அனுப்பும்.
அழைப்பு மணி ஒலிப்பது அறிவிக்கப்படாது: ஒரு கேரியர் மணி ஒலிப்பதைக் குறிக்கிறதா என்பது நம்புவதற்குத் தகாத அளவுக்கு மாறுபடும். ஏஜென்ட்டின் prompt, ThunderPhone அல்லாமல், குரலஞ்சல் பெட்டியில் என்ன செய்ய வேண்டும் என்பதைத் தீர்மானிக்கும் சில voicemail_action: "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 இருக்கும்: உரைச் செய்தி அனுப்பப்பட்ட
திட்டமிடப்பட்ட அனுப்பலின் ஐடி, அல்லது திட்டமிடப்படாத உரைச் செய்திக்கான
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
உள்ளமைவு மற்றும் கையொப்பச் சரிபார்ப்பு தனியாக வெளியிடப்படும்.
திட்டமிடப்பட்ட நிகழ்வுகள்
அனுப்பப்படாத திட்டமிடப்பட்ட அனுப்புதல்கள் இந்த
நிகழ்வுகளில் ஒன்றைத் தூண்டும். அனுப்பப்படும் அனுப்புதல், வழக்கமான நிகழ்வுகளையே தூண்டும்:
உரைக்காக scheduled_send_id அமைக்கப்பட்ட sms.* நிகழ்வுகள், அழைப்புக்கான அழைப்பு
நிகழ்வுகள் மற்றும் அதன் 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 | சரம் | தனிப்பயன் குரல் பொது அடையாளம் |
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 | பொருள் | பிரித்தெடுத்தல் புலத்தால் குறியிடப்பட்ட ஆதாரம். null அல்லாத மதிப்பில், துல்லியமான கட்டமைப்பு சரிபார்க்கப்பட்ட மேற்கோள் (அதிகபட்சம் 1,000 எழுத்துகள்), speaker_role (caller அல்லது agent), மற்றும் turn_index இருக்கும்; மாடல் திருப்பிய நீளமான மேற்கோள்கள் சுருக்கப்படுவதற்குப் பதிலாக நிராகரிக்கப்படும், மேலும் அதன் புலம் null ஆக இருக்கும்போதெல்லாம் ஆதாரம் null ஆக இருக்கும் |
extracted_data.verification | சரம் | ஒவ்வொரு வேட்பாளர் புலத்திற்கும் சுயாதீன ஆதாரச் சோதனை துல்லியமாக ஒரு செல்லுபடியான தீர்ப்பைத் திருப்பியபோது மட்டும் verified. unavailable என்பது சோதனை தோல்வியடைந்தது, நேரம் முடிந்தது, போதுமான பட்ஜெட் இல்லை, அல்லது தவறான வடிவிலான அல்லது பகுதியளவான வெளியீட்டைத் திருப்பியது என்பதைக் குறிக்கும். முழுமையாகக் கிடைக்காத சோதனை, வாடிக்கையாளர் மதிப்பாய்வுக்காக கட்டமைப்பு அடிப்படையிலான மதிப்புகளைப் பாதுகாக்கும். பகுதியளவான வெளியீட்டில், செல்லுபடியான தீர்ப்புகள் பயன்படுத்தப்படும்; துல்லியமாக ஒரு செல்லுபடியான தீர்ப்பு இல்லாத ஒவ்வொரு வேட்பாளரும் null ஆக்கப்படும் |
extracted_data.field_reasons | பொருள் | கட்டமைப்பு அடிப்படை அல்லது சுயாதீன சரிபார்ப்பாளரால் null ஆக்கப்பட்ட புலங்களால் குறியிடப்பட்ட காரணங்கள் |
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 க்கு புகாரளி என்பதற்குப் பிறகு, அல்லது 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
ஒரு
test-call இயக்கம்
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 | target_type-உடன் பொருந்தும், இயக்கம் இலக்காகக் கொண்ட ஏஜென்ட் id அல்லது தொலைபேசி எண் id |
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 (in data) | UUID | என்வலப்பின் விநியோக event_id-இலிருந்து வேறுபடும் எச்சரிக்கை தூண்டல் 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 ஆக மீண்டு பின்னர் குறியிடப்பட்டால் அனுப்பப்படும். இந்த நிகழ்வுக்கு ஏஜென்ட் சூழல் இல்லை, எனவே நிறுவன அளவிலான endpoint-கள் மட்டுமே இதைப் பெறும். நிறுவனத்தின் உரிமையாளர்கள் மற்றும் நிர்வாகிகளுக்கும் மின்னஞ்சல் அனுப்பப்படும்.
{
"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 | தொலைபேசி எண்கள்-இல் இதன் 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% ஆக இருக்கும்; ஏஜென்ட்டின் இடமாற்றம் தாவலில் யாராவது அதை மீண்டும் தொடங்கும் வரை இடமாற்றம் இடைநிறுத்தப்பட்டிருக்கும். பேலோடில் தொலைபேசி எண்கள், உரைப்பதிவுகள் அல்லது அழைப்பு அடையாளங்கள் இருக்காது.
{
"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 நிகழ்வுகள் எவ்வாறு உருவாக்கப்படுகின்றன.