ThunderPhone v3 ಈಗ ಲೈವ್ ಆಗಿದೆ.ನೀವೇ ನೇರವಾಗಿ ಆರಂಭಿಸಿ — 2¢/ನಿಮಿಷದಿಂದ.ಘೋಷಣೆ ಓದಿ

Webhooks

telephony.complete / web.complete

ಕರೆ ಮುಗಿದಾಗ ಟ್ರಾನ್ಸ್‌ಕ್ರಿಪ್ಟ್, ರೆಕಾರ್ಡಿಂಗ್ URL ಮತ್ತು ಮೆಟ್ರಿಕ್‌ಗಳೊಂದಿಗೆ ವಿತರಿಸಲಾಗುವ ತಡೆರಹಿತ ವೆಬ್‌ಹುಕ್.

ಪ್ರತಿ ಕರೆ ಮುಗಿದ ನಂತರ ಪೂರ್ಣಗೊಳಿಸುವಿಕೆ ಈವೆಂಟ್ ಸಕ್ರಿಯಗೊಳ್ಳುತ್ತದೆ — ಒಳಬರುವ ಟೆಲಿಫೋನಿ, ಹೊರಹೋಗುವ ಟೆಲಿಫೋನಿ, ವೆಬ್ ಕರೆ ಅಥವಾ ಪರೀಕ್ಷಾ ಕರೆ (ಬಿಲ್ಡರ್ ಮೈಕ್ ಸೆಷನ್). ಇದು ತಡೆರಹಿತವಾಗಿದೆ: ಯಾವುದೇ 2xx ನೊಂದಿಗೆ ಪ್ರತಿಕ್ರಿಯಿಸಿ.

ಈವೆಂಟ್ ಅನ್ನು ಎರಡೂ ಮಾರ್ಗಗಳಲ್ಲಿ ತಲುಪಿಸಲಾಗುತ್ತದೆ:

ವಿನಂತಿ ಪೇಲೋಡ್ (ಎಂಡ್‌ಪಾಯಿಂಟ್ ವಿತರಣೆಗಳು)

{
  "data": {
    "billable_minutes": 1.25,
    "billing_total_cents": 8,
    "call_id": 987654321,
    "direction": "inbound",
    "duration_seconds": 54,
    "end_reason": "user_hangup",
    "end_time": "2026-04-20T18:25:04.822Z",
    "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..."
    },
    "from_number": "+14155550199",
    "product": "spark",
    "recording_stopped_at": null,
    "recording_stopped_reason": null,
    "recording_url": "https://storage.example.com/…",
    "start_time": "2026-04-20T18:24:10.113Z",
    "status": "completed",
    "summary": "Alex Morgan called to book a follow-up visit and confirmed Thursday, April 23. The agent read the appointment back and Alex asked for a reminder text the day before.",
    "to_number": "+15551234567",
    "transcripts": [ /* see Transcript format */ ],
    "transfer_number": null,
    "unresolved_variables": ["campaign_owner"],
    "variables": {"campaign_name": "Spring renewals"},
    "voice": "john"
  },
  "event_id": "6a7b8c9d-0e1f-4a2b-8c3d-4e5f6a7b8c9d",
  "type": "telephony.complete"
}
ಕ್ಷೇತ್ರವಿಧವಿವರಣೆ
call_idಪೂರ್ಣಾಂಕಈ ಕರೆಗೆ ಸಂಬಂಧಿಸಿದ ಪ್ರತಿಯೊಂದು ಈವೆಂಟ್‌ನಲ್ಲೂ ಸ್ಥಿರವಾಗಿರುತ್ತದೆ
agent_idಪೂರ್ಣಾಂಕ | ಶೂನ್ಯನಿಯೋಜಿಸಲಾದಾಗ ಕರೆಯನ್ನು ನಿರ್ವಹಿಸಿದ ಏಜೆಂಟ್
agent_nameಅಕ್ಷರಸರಣಿ | ಶೂನ್ಯನಿಯೋಜಿಸಲಾದಾಗ ಕರೆಯನ್ನು ನಿರ್ವಹಿಸಿದ ಏಜೆಂಟ್
directionಅಕ್ಷರಸರಣಿinbound, outbound, web, test. ಐತಿಹಾಸಿಕ ಪೇಲೋಡ್‌ಗಳು ಹಳೆಯ mic ಅಥವಾ widget ಮೌಲ್ಯಗಳನ್ನು ಒಳಗೊಂಡಿರಬಹುದು
from_number, to_numberಅಕ್ಷರಸರಣಿE.164. ವೆಬ್ ಕರೆಗಳು ಮತ್ತು ಪರೀಕ್ಷಾ ಕರೆಗಳಿಗಾಗಿ from_number ಅಕ್ಷರಶಃ "web" ಆಗಿರುತ್ತದೆ
origin_domainಅಕ್ಷರಸರಣಿವೆಬ್/ಪರೀಕ್ಷೆಗೆ ಮಾತ್ರ — ವಿಜೆಟ್ ಅನ್ನು ಹೋಸ್ಟ್ ಮಾಡಿದ ಪುಟದ ಮೂಲಸ್ಥಾನ (ಮೈಕ್ ಸೆಷನ್‌ಗಳಿಗೆ ಖಾಲಿ)
start_time, end_timeಸಮಯಮುದ್ರೆISO 8601 UTC
duration_secondsಪೂರ್ಣಾಂಕ | ಶೂನ್ಯಆರಂಭ/ಅಂತ್ಯದಿಂದ ಪಡೆಯಲಾಗಿದೆ
statusಅಕ್ಷರಸರಣಿcompleted ಅಥವಾ failed
end_reasonಅಕ್ಷರಸರಣಿಕೆಳಗಿನ ಕೋಷ್ಟಕವನ್ನು ನೋಡಿ
answered_byಅಕ್ಷರಸರಣಿ | ಶೂನ್ಯಹೊರಹೋಗುವ ಫೋನ್ ಕರೆಗಳಿಗೆ ಮಾತ್ರ (ಇತರ ಸಂದರ್ಭಗಳಲ್ಲಿ ಇರುವುದಿಲ್ಲ): ಯಾರು ಉತ್ತರಿಸಿದರು, human, voicemail, screener (ಕರೆ ಪರಿಶೀಲನಾ ಸಹಾಯಕ), ivr (ಫೋನ್ ಮೆನು) ಅಥವಾ unknown. ಯಾರೂ ಉತ್ತರಿಸದಿದ್ದಾಗ null ಆಗಿರುತ್ತದೆ ಮತ್ತು ನೀವು ವರ್ಗಾಯಿಸುತ್ತಿರುವ ಪ್ಲಾಟ್‌ಫಾರ್ಮ್ ನಿರ್ವಹಿಸಿದ ಹೊರಹೋಗುವ ಕರೆಗಳ migration.call.complete ಈವೆಂಟ್‌ಗಳಲ್ಲಿ ಯಾವಾಗಲೂ null ಆಗಿರುತ್ತದೆ. ಕರೆ ಆಬ್ಜೆಕ್ಟ್ ನಲ್ಲಿರುವ ಮೌಲ್ಯಗಳೇ ಇವು
product, voiceಅಕ್ಷರಸರಣಿಕರೆ ಸಮಯದಲ್ಲಿ ಜಾರಿಯಲ್ಲಿದ್ದ ಏಜೆಂಟ್ ಕಾನ್ಫಿಗರೇಶನ್
variablesಆಬ್ಜೆಕ್ಟ್ಕರೆ ಆರಂಭವಾದಾಗ ಸ್ನ್ಯಾಪ್‌ಶಾಟ್ ತೆಗೆದ ಇನ್‌ಪುಟ್ ವೇರಿಯಬಲ್‌ಗಳು
unresolved_variablesಸರಣಿಕರೆ ಕಾನ್ಫಿಗರೇಶನ್ ಉಲ್ಲೇಖಿಸಿದರೂ ಕರೆ ಆರಂಭದಲ್ಲಿ ಒದಗಿಸದ ವೇರಿಯಬಲ್ ಹೆಸರುಗಳು
transfer_numberಅಕ್ಷರಸರಣಿ | ಶೂನ್ಯಕರೆಯನ್ನು ವರ್ಗಾಯಿಸಿದಾಗ ಹೊಂದಿಸಲಾಗುತ್ತದೆ
scheduled_send_idಅಕ್ಷರಸರಣಿನಿಗದಿತ ಕಳುಹಿಕೆ ಮೂಲಕ ಇರಿಸಲಾದ ಕರೆಯಲ್ಲಿ ಮಾತ್ರ: ಆ ಕಳುಹಿಕೆಯ ಐಡಿ. ಇತರ ಎಲ್ಲ ಕರೆಗಳಲ್ಲಿ ಇರುವುದಿಲ್ಲ
recording_urlಅಕ್ಷರಸರಣಿ | ಶೂನ್ಯಅವಧಿ ಮುಗಿಯುವ ಸಹಿ ಮಾಡಿದ URL; ತಕ್ಷಣ ಡೌನ್‌ಲೋಡ್ ಮಾಡಿ. ಯಾವುದೇ ರೆಕಾರ್ಡಿಂಗ್ ಆರ್ಟಿಫ್ಯಾಕ್ಟ್ ಲಭ್ಯವಿಲ್ಲದಾಗ null
recording_stopped_atಸಮಯಮುದ್ರೆ | ಶೂನ್ಯಕರೆ ಮುಗಿಯುವ ಮೊದಲು ರೆಕಾರ್ಡಿಂಗ್ ನಿಲ್ಲಿಸಿದ ಸಮಯ; ಈ ಕ್ಷಣದ ನಂತರದ ಯಾವುದೂ ರೆಕಾರ್ಡಿಂಗ್‌ನಲ್ಲಿ ಇರುವುದಿಲ್ಲ. ರೆಕಾರ್ಡಿಂಗ್ ಕರೆ ಮುಗಿಯುವವರೆಗೆ ನಡೆದಾಗ ಅಥವಾ ಕರೆಯನ್ನು ರೆಕಾರ್ಡ್ ಮಾಡದಿದ್ದಾಗ null
recording_stopped_reasonಅಕ್ಷರಸರಣಿ | ಶೂನ್ಯರೆಕಾರ್ಡಿಂಗ್ ಏಕೆ ಬೇಗನೆ ನಿಂತಿತು. warm_transfer: ವಾರ್ಮ್ ವರ್ಗಾವಣೆ ಗಮ್ಯಸ್ಥಾನಕ್ಕೆ ಕರೆ ಮಾಡುವ ತಕ್ಷಣದ ಮೊದಲು ಇದು ನಿಲ್ಲುತ್ತದೆ ಮತ್ತು ವರ್ಗಾವಣೆ ವಿಫಲವಾಗಿ ಕರೆಮಾಡುವವರು ಏಜೆಂಟ್‌ಗೆ ಮರಳಿದರೂ ನಿಷ್ಕ್ರಿಯವಾಗಿಯೇ ಇರುತ್ತದೆ. ಇತರ ಮೌಲ್ಯಗಳನ್ನು ಮಾಹಿತಿ ಉದ್ದೇಶದವುಗಳಾಗಿ ಪರಿಗಣಿಸಿ; ಹೆಚ್ಚಿನವುಗಳನ್ನು ಸೇರಿಸಬಹುದು. recording_stopped_at null ಆಗಿದ್ದಾಗ null
billable_minutesಸಂಖ್ಯೆಬಿಲ್ ಮಾಡಲಾದ ನಿಮಿಷಗಳು, ಹತ್ತಿರದ ಕಾಲು ನಿಮಿಷಕ್ಕೆ ದುಂಡಾಗಿಸಲಾಗಿದೆ (15-ಸೆಕೆಂಡ್ ಹೆಚ್ಚಳಗಳು, ಕನಿಷ್ಠ 0.25). ನೇರವಾಗಿ ವಾಯ್ಸ್‌ಮೇಲ್‌ಗೆ ಹೋಗುವ ಕರೆಗಳು ಇಲ್ಲಿಯೂ ತಮ್ಮ ನಿಜವಾದ ಮೀಟರ್ ಮಾಡಿದ ನಿಮಿಷಗಳನ್ನು ವರದಿ ಮಾಡುತ್ತವೆ, ಆದರೆ ಶುಲ್ಕವು ಯೋಜನೆ ದರದಲ್ಲಿ ಒಂದು ನಿಮಿಷಕ್ಕೆ ಮಿತಿಗೊಳಿಸಲಾಗುತ್ತದೆ.
billing_total_centsಪೂರ್ಣಾಂಕ | ಶೂನ್ಯUSD ಸೆಂಟ್‌ಗಳು. billing_pending true ಆಗಿರುವವರೆಗೆ null
billing_pendingಬೂಲಿಯನ್ಶುಲ್ಕ ಇನ್ನೂ ಇತ್ಯರ್ಥವಾಗದ ಮೀಟರ್ ಮಾಡಿದ ಕರೆಯಲ್ಲಿ ಮಾತ್ರ true ರೂಪದಲ್ಲಿ ಇರುತ್ತದೆ: ಮೀಟರ್ ಮಾಡಿದ ಕರೆಗೆ ಅದು ಮುಗಿದ ಕೆಲವು ನಿಮಿಷಗಳ ನಂತರ, ಅದರ ಬಳಕೆ ಲಭ್ಯವಾದಾಗ ಶುಲ್ಕ ವಿಧಿಸಲಾಗುತ್ತದೆ, ಆದ್ದರಿಂದ ಇಲ್ಲಿ billable_minutes ಮತ್ತು billing_total_cents null ಆಗಿರುತ್ತವೆ ಮತ್ತು ಶುಲ್ಕವು call.billed ನಲ್ಲಿ ಬರುತ್ತದೆ. ಇತರ ಎಲ್ಲ ಕರೆಗಳಲ್ಲಿ ಇರುವುದಿಲ್ಲ
transcriptsಸರಣಿಪ್ರತಿ ತಿರುವಿನ ಟ್ರಾನ್ಸ್‌ಕ್ರಿಪ್ಟ್ ನಮೂದುಗಳು; ಟ್ರಾನ್ಸ್‌ಕ್ರಿಪ್ಟ್ ಲಭ್ಯವಿಲ್ಲದಾಗ ಖಾಲಿಯಾಗಿರಬಹುದು
summaryಅಕ್ಷರಸರಣಿ | ಶೂನ್ಯಏಜೆಂಟ್ ಬಿಲ್ಡರ್‌ನಲ್ಲಿ ಸಂಗ್ರಹಿಸಬೇಕಾದ ಡೇಟಾ ಅಡಿಯಲ್ಲಿ ಏಜೆಂಟ್ ಕರೆ ಸಾರಾಂಶ ರಚಿಸಿ ಅನ್ನು ಸಕ್ರಿಯಗೊಳಿಸಿದಾಗ (ಏಜೆಂಟ್ ನಲ್ಲಿ call_summary_enabled) ಮತ್ತು ರಚನೆ ಯಶಸ್ವಿಯಾದಾಗ ಸರಳ ಭಾಷೆಯ ಕರೆ-ನಂತರದ ಸಾರಾಂಶ (2 ರಿಂದ 4 ಗದ್ಯ ವಾಕ್ಯಗಳು, ಗರಿಷ್ಠ 2,000 ಅಕ್ಷರಗಳು; ಏಜೆಂಟ್‌ನ summary_language ನಲ್ಲಿ, ಇಲ್ಲದಿದ್ದರೆ ಸಂಸ್ಥೆಯ ಸಾರಾಂಶ ಭಾಷೆಯಲ್ಲಿ, ಇಲ್ಲದಿದ್ದರೆ ಕರೆಯ ಭಾಷೆಯಲ್ಲಿ: ಕರೆ ಅದನ್ನು ಅತಿಕ್ರಮಿಸದಿದ್ದರೆ ಏಜೆಂಟ್‌ನ ಪ್ರಾಥಮಿಕ ಭಾಷೆ); ಇಲ್ಲದಿದ್ದರೆ null, ಸಾರಾಂಶಿಸಲು ತುಂಬಾ ಚಿಕ್ಕ ಕರೆಗಳು, ಟ್ರಾನ್ಸ್‌ಕ್ರಿಪ್ಟ್ ಇಲ್ಲದ ಕರೆಗಳು ಮತ್ತು ರೆಕಾರ್ಡಿಂಗ್ ನಿಷ್ಕ್ರಿಯಗೊಳಿಸಿದ ಏಜೆಂಟ್‌ಗಳನ್ನೂ ಒಳಗೊಂಡಂತೆ. ಸಾರಾಂಶವನ್ನು ಎಕ್ಸ್‌ಟ್ರಾಕ್ಷನ್‌ನಂತೆಯೇ ಅದೇ ಕರೆ-ನಂತರದ ಹಂತದಲ್ಲಿ ರಚಿಸಲಾಗುತ್ತದೆ, ಆದ್ದರಿಂದ ಕರೆ-ಮುಗಿದ ವೆಬ್‌ಹುಕ್ ಕಳುಹಿಸುವ ಮೊದಲು ಎಕ್ಸ್‌ಟ್ರಾಕ್ಟ್ ಮಾಡಿದ ಡೇಟಾಕ್ಕಾಗಿ ಕಾಯಿರಿ ಸೆಟ್ಟಿಂಗ್ (extraction_blocks_completion) ಈ ಈವೆಂಟ್ ಅದಕ್ಕಾಗಿ ಕಾಯುತ್ತದೆಯೇ ಎಂಬುದನ್ನು ನಿರ್ಧರಿಸುತ್ತದೆ: ಕಾಯುವ ಕ್ರಮದಲ್ಲಿ ಈ ಈವೆಂಟ್ ಕಳುಹಿಸುವ ಮೊದಲು ಸಾರಾಂಶ ಸಿದ್ಧವಾಗಿರುತ್ತದೆ (ಸಾರಾಂಶಕ್ಕೆ ಹಂತದ 75-ಸೆಕೆಂಡ್ ಬಜೆಟ್‌ನೊಳಗೆ ಗರಿಷ್ಠ 30 ಸೆಕೆಂಡುಗಳು ಸಿಗುತ್ತವೆ); ಈವೆಂಟ್ ಕಾಯದಿದ್ದಾಗ (never, ಅಥವಾ except_transfers ಅಡಿಯಲ್ಲಿ ವರ್ಗಾವಣೆ ಅಥವಾ ನಿಮ್ಮ ಸಂಪರ್ಕ ಕೇಂದ್ರಕ್ಕೆ ಹಿಂತಿರುಗುವಿಕೆ) ಈ ಕ್ಷೇತ್ರ null ಆಗಿರುತ್ತದೆ ಮತ್ತು ಸಾರಾಂಶವನ್ನು call.data_extracted ನಲ್ಲಿ ಮತ್ತೆ ಕಳುಹಿಸಲಾಗುವುದಿಲ್ಲ, ಆದ್ದರಿಂದ ನಂತರ ಕರೆ ಆಬ್ಜೆಕ್ಟ್ ನ summary ನಿಂದ ಓದಿ. ಡ್ಯಾಶ್‌ಬೋರ್ಡ್‌ನ ಕರೆ ಪುಟದಲ್ಲಿಯೂ ಲಭ್ಯವಿದೆ
extracted_dataಆಬ್ಜೆಕ್ಟ್ | ಶೂನ್ಯstatus, fields, evidence, verification, field_reasons, ಮತ್ತು schema_version ಹೊಂದಿರುವ ರಚನಾತ್ಮಕ ಎಕ್ಸ್‌ಟ್ರಾಕ್ಷನ್ ಫಲಿತಾಂಶ. ಪ್ರತಿ ಶೂನ್ಯವಲ್ಲದ ಕ್ಷೇತ್ರವು ನಿಖರವಾಗಿ ರಚನಾತ್ಮಕವಾಗಿ ಪರಿಶೀಲಿಸಿದ ಉಲ್ಲೇಖವನ್ನು (ಗರಿಷ್ಠ 1,000 ಅಕ್ಷರಗಳು), ಅದರ ಸ್ಪೀಕರ್ ಪಾತ್ರ ಮತ್ತು ತಿರುವಿನ ಸೂಚ್ಯಂಕದೊಂದಿಗೆ ಹೊಂದಿರುತ್ತದೆ; ದೀರ್ಘವಾದ ಮಾದರಿ-ಹಿಂತಿರುಗಿಸಿದ ಉಲ್ಲೇಖಗಳನ್ನು ಮೊಟಕುಗೊಳಿಸುವ ಬದಲು ತಿರಸ್ಕರಿಸಲಾಗುತ್ತದೆ. ಕ್ಷೇತ್ರವು null ಆಗಿದ್ದಾಗ ಸಾಕ್ಷ್ಯವು null ಆಗಿರುತ್ತದೆ. verified ಎಂದರೆ ಪ್ರತಿಯೊಬ್ಬ ಅಭ್ಯರ್ಥಿಗೆ ನಿಖರವಾಗಿ ಒಂದು ಮಾನ್ಯ ಸ್ವತಂತ್ರ ತೀರ್ಪು ದೊರೆತಿದೆ ಎಂದರ್ಥ. unavailable ವಿರೂಪಗೊಂಡ ಅಥವಾ ಭಾಗಶಃ ಪರಿಶೀಲಕ ಔಟ್‌ಪುಟ್‌ನ್ನೂ ಒಳಗೊಳ್ಳುತ್ತದೆ; ಮಾನ್ಯ ಭಾಗಶಃ ತೀರ್ಪುಗಳು ಇನ್ನೂ ಅನ್ವಯಿಸುತ್ತವೆ, ಆದರೆ ಒಂದು ಮಾನ್ಯ ತೀರ್ಪೂ ಇಲ್ಲದ ಅಭ್ಯರ್ಥಿಗಳನ್ನು ಶೂನ್ಯಗೊಳಿಸಲಾಗುತ್ತದೆ. status completed, failed, exhausted, skipped, ಅಥವಾ skipped_recording_disabled ಆಗಿರುತ್ತದೆ; ಏಜೆಂಟ್‌ಗೆ ಎಕ್ಸ್‌ಟ್ರಾಕ್ಷನ್ ಕ್ಷೇತ್ರಗಳಿಲ್ಲದಾಗ null
steps_traceಸರಣಿಏಜೆಂಟ್‌ಗೆ ಹಂತಗಳು ಅಥವಾ ಹ್ಯಾಂಡ್‌ಆಫ್‌ಗಳು ಇರುವ ಕರೆಗಳಲ್ಲಿ ಮಾತ್ರ. ಕರೆ ಅವುಗಳ ಮೂಲಕ ಸಾಗಿದ ಕ್ರಮ: ಪ್ರತಿ ನಮೂದು t_ms (ಕರೆ ಆರಂಭವಾದಾಗಿನಿಂದ ಮಿಲಿಸೆಕೆಂಡುಗಳು), agent (ಏಜೆಂಟ್‌ನ ಕೀ, a ಜೊತೆಗೆ ಅದರ ಐಡಿ), step (ಹಂತದ ಐಡಿ, ಅಥವಾ ಹಂತಗಳಿಲ್ಲದ ಏಜೆಂಟ್‌ಗೆ ಹ್ಯಾಂಡ್‌ಆಫ್ ಆದಾಗ null) ಮತ್ತು via (start, model, condition, on_enter ಅಥವಾ handoff) ಹೊಂದಿರುತ್ತದೆ. ಐಡಿಗಳು ಮತ್ತು ಸಮಯಗಳನ್ನು ಮಾತ್ರ ಹೊಂದಿರುವುದರಿಂದ, ರೆಕಾರ್ಡಿಂಗ್ ನಿಷ್ಕ್ರಿಯವಾಗಿದ್ದರೂ ಇದನ್ನು ಉಳಿಸಿಕೊಳ್ಳಲಾಗುತ್ತದೆ
collected_valuesಆಬ್ಜೆಕ್ಟ್ಏಜೆಂಟ್‌ಗೆ ಹಂತಗಳು ಅಥವಾ ಹ್ಯಾಂಡ್‌ಆಫ್‌ಗಳು ಇರುವ ಕರೆಗಳಲ್ಲಿ ಮಾತ್ರ. ಸಂಗ್ರಹಣಾ ಕ್ಷೇತ್ರದ ಹೆಸರಿನಿಂದ ಕೀ ಮಾಡಲಾದ, ಏಜೆಂಟ್ ತನ್ನ ಹಂತಗಳಲ್ಲಿ ಸಂಗ್ರಹಿಸಿದ ಮೌಲ್ಯಗಳು, ಜೊತೆಗೆ ಪ್ರತಿ ಹಂತದ on_enter_tool ಫಲಿತಾಂಶಕ್ಕಾಗಿ <tool>_result. ಕರೆಯ ವಿಷಯವನ್ನು ಉಳಿಸಿಕೊಳ್ಳದಿದ್ದಾಗ (ರೆಕಾರ್ಡಿಂಗ್ ನಿಷ್ಕ್ರಿಯಗೊಳಿಸಿದಾಗ) ಬಿಟ್ಟುಬಿಡಲಾಗುತ್ತದೆ

ಅಂತ್ಯದ ಕಾರಣಗಳು

ಮೌಲ್ಯಅರ್ಥ
user_hangupದೂರದ ಪಕ್ಷವು ಮೊದಲು ಕರೆ ಸ್ಥಗಿತಗೊಳಿಸಿತು
ai_hangupAI ಉದ್ದೇಶಪೂರ್ವಕವಾಗಿ ಕರೆಯನ್ನು ಕೊನೆಗೊಳಿಸಿತು
ai_transferAI ಕರೆಯನ್ನು ವರ್ಗಾಯಿಸಿತು; transfer_number ಹೊಂದಿಸಲಾಗಿದೆ
ai_warm_transferAI ವಾರ್ಮ್ (ಅಟೆಂಡೆಡ್) ವರ್ಗಾವಣೆಯನ್ನು ಪೂರ್ಣಗೊಳಿಸಿತು
returned_to_platformAI ಕರೆಯನ್ನು ನಿಮ್ಮ ಸಂಪರ್ಕ ಕೇಂದ್ರಕ್ಕೆ ಹಿಂತಿರುಗಿಸಿತು: ಹಿಂತಿರುಗುವ ನಮೂದಿನ ಹೆಡರ್‌ಗಳಿದ್ದರೆ, ಅವುಗಳನ್ನು SIP BYE ನಲ್ಲಿ ಸೇರಿಸಿ ಕರೆ ಸ್ಥಗಿತಗೊಳಿಸಿತು
voicemail_hangupವಾಯ್ಸ್‌ಮೇಲ್ ಪತ್ತೆಯಾಯಿತು ಮತ್ತು ನಿಮ್ಮ voicemail_action ಪ್ರಕಾರ ಕರೆ ಕೊನೆಗೊಂಡಿತು
max_durationಕರೆ ಗರಿಷ್ಠ ಅವಧಿಯ ಮಿತಿಯನ್ನು ತಲುಪಿತು: ಏಜೆಂಟ್‌ನ ಮಿತಿ, ಕರೆಯ ಸ್ವಂತ ಮಿತಿ ಅಥವಾ 6-ಗಂಟೆಗಳ ಪ್ಲಾಟ್‌ಫಾರ್ಮ್ ಮಿತಿ. ಸಮಯ ಮಿತಿ ಎಚ್ಚರಿಕೆಯ ನಂತರ AI ಅಥವಾ ಕರೆಗಾರ ಕೊನೆಗೊಳಿಸಿದ ಕರೆಯು ai_hangup ಅಥವಾ user_hangup ಅನ್ನೇ ಉಳಿಸಿಕೊಳ್ಳುತ್ತದೆ
supersededಸೆಷನ್ ಅನ್ನು ಹೊಸ ಸೆಷನ್‌ನಿಂದ ಬದಲಾಯಿಸಲಾಯಿತು
inbound_config_webhook_failedವೆಬ್‌ಹುಕ್ ಮೋಡ್‌ನಲ್ಲಿರುವ ಸಂಖ್ಯೆಗೆ ಒಳಬರುವ ಕರೆ: ಕಾನ್ಫಿಗರೇಶನ್ ವೆಬ್‌ಹುಕ್ ಬಳಸಬಹುದಾದ ಕಾನ್ಫಿಗರೇಶನ್ ಅನ್ನು ಹಿಂತಿರುಗಿಸಲಿಲ್ಲ, ಆದ್ದರಿಂದ ಏಜೆಂಟ್ ಉತ್ತರಿಸುವ ಮೊದಲು ಕರೆಯನ್ನು ಕೊನೆಗೊಳಿಸಲಾಯಿತು. status ಎಂಬುದು failed ಆಗಿರುತ್ತದೆ ಮತ್ತು ಕರೆಯನ್ನು ಬಿಲ್ ಮಾಡಲಾಗುವುದಿಲ್ಲ
outbound_queue_timeoutಕ್ಯೂ ಮಾಡಲಾದ ಕರೆ ಡಯಲ್ ಮಾಡಲು ಸ್ಥಳವಿಲ್ಲದೆ 10 ನಿಮಿಷ ಕಾಯಿತು. status ಎಂಬುದು failed ಆಗಿರುತ್ತದೆ, ಯಾವುದನ್ನೂ ಡಯಲ್ ಮಾಡಲಾಗುವುದಿಲ್ಲ ಮತ್ತು ಕರೆಯನ್ನು ಬಿಲ್ ಮಾಡಲಾಗುವುದಿಲ್ಲ
outbound_queue_canceledಕ್ಯೂ ಮಾಡಲಾದ ಕರೆ ಡಯಲ್ ಆಗುವ ಮೊದಲು ನೀವು ಅದನ್ನು ರದ್ದುಗೊಳಿಸಿದ್ದೀರಿ. status ಎಂಬುದು failed ಆಗಿರುತ್ತದೆ ಮತ್ತು ಕರೆಯನ್ನು ಬಿಲ್ ಮಾಡಲಾಗುವುದಿಲ್ಲ
unknownಕರೆ ಕೊನೆಗೊಳ್ಳುವ ಕಾರಣವನ್ನು ನಿರ್ಧರಿಸಲಾಗಲಿಲ್ಲ

ಪ್ರತಿಲಿಪಿ ಸ್ವರೂಪ

transcripts ನಲ್ಲಿನ ಪ್ರತಿಯೊಂದು ನಮೂದು ಒಂದು ಸಂಭಾಷಣಾ ತಿರುವಾಗಿದೆ. ಪಾತ್ರಗಳು user (ಕರೆ ಮಾಡುವವರ ಮಾತು), model (ಏಜೆಂಟ್ ಮಾತು ಮತ್ತು ಟೂಲ್ ಕರೆಗಳು), tool (ಟೂಲ್ ಫಲಿತಾಂಶಗಳು), ಮತ್ತು system (ಭಾಷೆ ಬದಲಾವಣೆಗಳಂತಹ ಕರೆ ಈವೆಂಟ್‌ಗಳು) ಆಗಿವೆ.

[
  {
    "role": "user",
    "content_type": "text/plain",
    "content": "Hi, I'm calling about my appointment.",
    "start_ms": 1200,
    "end_ms":   4100,
    "audio_url": "https://storage.example.com/…"
  },
  {
    "role": "model",
    "content_type": "text/plain",
    "content": "Sure, what date works best?",
    "start_ms": 4200,
    "end_ms":   6100
  },
  {
    "role": "model",
    "content_type": "application/json",
    "content": {
      "tool_call": "search_appointments",
      "arguments": { "date": "2026-04-21" }
    }
  },
  {
    "role": "tool",
    "content_type": "application/json",
    "content": {
      "tool_name": "search_appointments",
      "response": { "available_slots": ["9:00 AM", "2:00 PM"] }
    }
  }
]
ಕ್ಷೇತ್ರವಿಧವಿವರಣೆ
roleಸ್ಟ್ರಿಂಗ್user, model, tool, ಅಥವಾ system
content_typeಸ್ಟ್ರಿಂಗ್ಮಾತಿಗಾಗಿ text/plain; ಟೂಲ್ ಕರೆಗಳು, ಟೂಲ್ ಫಲಿತಾಂಶಗಳು ಮತ್ತು ಸಿಸ್ಟಮ್ ಈವೆಂಟ್‌ಗಳಿಗಾಗಿ application/json
contentಸ್ಟ್ರಿಂಗ್ | ಆಬ್ಜೆಕ್ಟ್ಮಾತಿನ ಪಠ್ಯ, ಅಥವಾ ಮೇಲೆ ತೋರಿಸಿರುವ ರಚನಾತ್ಮಕ ಆಬ್ಜೆಕ್ಟ್. ಟೂಲ್ ಕರೆಗಳು: {"tool_call": name, "arguments": {…}}. ಟೂಲ್ ಫಲಿತಾಂಶಗಳು: {"tool_name": name, "response": {…}}
start_ms, end_msಪೂರ್ಣಾಂಕಕರೆ ಆರಂಭದಿಂದ ಆಫ್‌ಸೆಟ್‌ಗಳು, ms. ಆಡಿಯೊ ಸಮಯದ ಮಾಹಿತಿ ತಿಳಿದಿದ್ದಾಗ ಇರುತ್ತವೆ
ttfa_msಪೂರ್ಣಾಂಕಅಳತೆ ಮಾಡಿದಾಗ, model ತಿರುವಿನ ಮೊದಲ ಆಡಿಯೊವರೆಗಿನ ಸಮಯ
audio_url, audio_urlsಸ್ಟ್ರಿಂಗ್ / ಅರೆಪ್ರತಿ-ತಿರುವಿಗೆ ರೆಕಾರ್ಡ್ ಮಾಡಿದಾಗ, ಆ ತಿರುವಿನ ಆಡಿಯೊಗಾಗಿ ಅವಧಿ ಮುಗಿಯುವ ಸಹಿ ಮಾಡಿದ URLಗಳು

ಅಡಚಣೆ ಗುರುತುಗಳು, ಸ್ವೀಕೃತಿ ಪ್ರಾಂಪ್ಟ್‌ಗಳು ಮತ್ತು ಮೂಲ ಸ್ಥಾನಗಳನ್ನು ಒಳಗೊಂಡ ಸಂಪೂರ್ಣ ರಚನಾತ್ಮಕ ತಿರುವು ಇತಿಹಾಸಕ್ಕಾಗಿ, GET /v1/calls/{call_id}/history ಬಳಸಿ.

ಲೆಗಸಿ ಪೇಲೋಡ್ ವ್ಯತ್ಯಾಸಗಳು

ಲೆಗಸಿ ಏಕ-URL ವೆಬ್‌ಹುಕ್ ಎನ್‌ವೆಲಪ್ {"type": "telephony.complete" | "web.complete", "data": {…}} ಆಗಿದ್ದು, ಯಾವುದೇ event_id ಇಲ್ಲ, ಮತ್ತು ಅದರ data ಎಂಡ್‌ಪಾಯಿಂಟ್ ಪೇಲೋಡ್‌ನಿಂದ ಭಿನ್ನವಾಗಿದೆ:

ಲೆಗಸಿ ಪೂರ್ಣಗೊಳಿಸುವಿಕೆ ಪೇಲೋಡ್ agent_id ಮತ್ತು agent_name ಅನ್ನೂ ಹೊಂದಿರುತ್ತದೆ.

  • ತಿರುವು ಅರೆ transcripts ಅಡಿಯಲ್ಲಿ ಅಲ್ಲ, history ಅಡಿಯಲ್ಲಿದೆ (ಮೇಲಿನಂತೆಯೇ ತಿರುವು ಸ್ಕೀಮಾ).
  • ಕ್ಷೇತ್ರಗಳ ಸೆಟ್ ಕಚ್ಚಾ ಕರೆ-ಅಂತ್ಯ ವರದಿಯಾಗಿದ್ದು, ಮೇಲಿನ ಕೋಷ್ಟಕಕ್ಕಿಂತ ಹೆಚ್ಚುವರಿ ಆಂತರಿಕ ಕ್ಷೇತ್ರಗಳನ್ನು ಒಳಗೊಂಡಿರಬಹುದು — ಗೊತ್ತಿಲ್ಲದ ಕ್ಷೇತ್ರಗಳನ್ನು ಮಾಹಿತಿಗಾಗಿ ಮಾತ್ರವೆಂದು ಪರಿಗಣಿಸಿ.
  • ವೆಬ್ ಕರೆಗಳು (direction: "web") from_number / to_number ಅನ್ನು ಬಿಟ್ಟುಬಿಡುತ್ತವೆ ಮತ್ತು origin_domain ಅನ್ನು ಸೇರಿಸುತ್ತವೆ.
  • ಬಿಲ್ಡರ್ ಮೈಕ್ ಪರೀಕ್ಷಾ ಕರೆಗಳು ಲೆಗಸಿ ಮಾರ್ಗದಲ್ಲಿ telephony.complete ಎಂದು ವರದಿಯಾಗುತ್ತವೆ (ಎಂಡ್‌ಪಾಯಿಂಟ್ ಸಿಸ್ಟಮ್ ಅವುಗಳನ್ನು web.complete ಗೆ ಮ್ಯಾಪ್ ಮಾಡುತ್ತದೆ).
  • ವರ್ಗಾವಣೆ ಸಮನ್ವಯ: ಕರೆ ವರ್ಗಾವಣೆಯಲ್ಲಿ ಅಂತ್ಯಗೊಂಡಾಗ, ಲೆಗಸಿ ವೆಬ್‌ಹುಕ್ ಅನ್ನು ಸಿಂಕ್ರೋನಸ್ ಆಗಿ ಕರೆಯಲಾಗುತ್ತದೆ ಮತ್ತು ವರ್ಗಾವಣೆ ಸ್ವೀಕರಿಸುವ ಗುರಿ ಸಿದ್ಧವಾಗಿಲ್ಲ ಎಂದು ಸೂಚಿಸಲು {"transfer_ready": false} ಎಂದು ಪ್ರತಿಕ್ರಿಯಿಸಬಹುದು. ಯಾವುದೇ ಇತರ ಪ್ರತಿಕ್ರಿಯೆ (ಅಥವಾ ಲೆಗಸಿ ವೆಬ್‌ಹುಕ್ ಇಲ್ಲದಿರುವುದು) ವರ್ಗಾವಣೆಯನ್ನು ಮುಂದುವರಿಯಲು ಅನುಮತಿಸುತ್ತದೆ. ಇದಕ್ಕಾಗಿ ಎಂಡ್‌ಪಾಯಿಂಟ್ ವಿತರಣೆಗಳನ್ನು ಎಂದಿಗೂ ಪರಿಗಣಿಸಲಾಗುವುದಿಲ್ಲ.

ಉದಾಹರಣೆ ಹ್ಯಾಂಡ್ಲರ್

Python (FastAPI)
import hashlib
import hmac
import json
import os
 
from fastapi import FastAPI, HTTPException, Request
 
app = FastAPI()
SECRET = os.environ["THUNDERPHONE_WEBHOOK_SECRET"]
 
def verify(body: bytes, signature: str) -> bool:
    expected = hmac.new(SECRET.encode(), body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, signature or "")
 
@app.post("/thunderphone-webhook")
async def webhook(request: Request):
    body = await request.body()
    if not verify(body, request.headers.get("X-ThunderPhone-Signature", "")):
        raise HTTPException(status_code=401)
 
    event = json.loads(body)
    if event["type"] in ("telephony.complete", "web.complete"):
        data = event["data"]
        # Endpoint deliveries use "transcripts"; the legacy webhook uses "history".
        turns = data.get("transcripts") or data.get("history") or []
        await persist_call_record(
            call_id=data["call_id"],
            turns=turns,
            recording_url=data.get("recording_url"),
        )
        if data["end_reason"] in ("ai_transfer", "ai_warm_transfer"):
            await notify_team(data.get("transfer_number"), data["call_id"])
    return {"ok": True}
Node.js (Express)
import crypto from "node:crypto";
import express from "express";
 
const app = express();
const SECRET = process.env.THUNDERPHONE_WEBHOOK_SECRET;
 
function verify(body, signature) {
  const expected = crypto.createHmac("sha256", SECRET).update(body).digest("hex");
  return signature &&
    crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(signature));
}
 
app.post(
  "/thunderphone-webhook",
  express.raw({ type: "application/json" }),
  async (req, res) => {
    if (!verify(req.body, req.header("X-ThunderPhone-Signature"))) {
      return res.sendStatus(401);
    }
    const event = JSON.parse(req.body.toString("utf8"));
    if (["telephony.complete", "web.complete"].includes(event.type)) {
      const data = event.data;
      // Endpoint deliveries use "transcripts"; the legacy webhook uses "history".
      const turns = data.transcripts ?? data.history ?? [];
      await persistCallRecord({ ...data, turns });
      if (["ai_transfer", "ai_warm_transfer"].includes(data.end_reason)) {
        await notifyTeam(data.transfer_number, data.call_id);
      }
    }
    res.json({ ok: true });
  },
);

ಸಾಮಾನ್ಯ ಬಳಕೆಯ ಸಂದರ್ಭಗಳು

CRM ಏಕೀಕರಣ

ಪ್ರತಿಯೊಂದು ಕರೆಯ ಟ್ರಾನ್ಸ್‌ಕ್ರಿಪ್ಟ್ ಮತ್ತು ರೆಕಾರ್ಡಿಂಗ್ URL ಅನ್ನು ನಿಮ್ಮ ಗ್ರಾಹಕ ದಾಖಲೆಗಳ ಜೊತೆಗೆ ಸಂಗ್ರಹಿಸಿ.

ವಿಶ್ಲೇಷಣೆ

ವಿಷಯ ಮಾದರೀಕರಣ, CSAT ಸಂಕೇತ ಹೊರತೆಗೆಯುವಿಕೆ ಅಥವಾ ವರ್ಗಾವಣೆ-ದರ ಮೇಲ್ವಿಚಾರಣೆಗಾಗಿ ಟ್ರಾನ್ಸ್‌ಕ್ರಿಪ್ಟ್‌ಗಳನ್ನು ಪೈಪ್‌ಲೈನ್‌ಗೆ ಸ್ಟ್ರೀಮ್ ಮಾಡಿ.

ಗುಣಮಟ್ಟ ಪರಿಶೀಲನೆ

ಮಾನವ ಪರಿಶೀಲನೆಗಾಗಿ ಕರೆಗಳನ್ನು QA ಸಾಧನದಲ್ಲಿ ತೆರೆಯಿರಿ, ಅಥವಾ ಅವುಗಳನ್ನು ನಿಮ್ಮ ಸ್ವಂತ ಮೌಲ್ಯಮಾಪನ ಮಾದರಿಯ ಮೂಲಕ ಚಲಾಯಿಸಿ.

ಅಧಿಸೂಚನೆಗಳು

ವರ್ಗಾವಣೆ ಅಥವಾ ವೈಫಲ್ಯದ ಸಂದರ್ಭದಲ್ಲಿ ಮಾನವ ಸಹತಂಡದ ಸದಸ್ಯರನ್ನು ಪ್ರಚೋದಿಸಿ.


ಸಂಬಂಧಿತ