ThunderPhone v3 ਹੁਣ ਲਾਈਵ ਹੈ।ਸੈਲਫ਼-ਸਰਵਿਸ—2¢/ਮਿੰਟ ਤੋਂ।ਐਲਾਨ ਪੜ੍ਹੋ

Webhooks

telephony.complete / web.complete

ਕਾਲ ਸਮਾਪਤ ਹੋਣ

ਹਰ ਕਾਲ ਸਮਾਪਤ ਹੋਣ ਤੋਂ ਬਾਅਦ ਇੱਕ completion ਇਵੈਂਟ ਟ੍ਰਿਗਰ ਹੁੰਦਾ ਹੈ — ਇਨਬਾਊਂਡ ਟੈਲੀਫੋਨੀ, ਆਉਟਬਾਊਂਡ ਟੈਲੀਫੋਨੀ, ਵੈੱਬ ਕਾਲ, ਜਾਂ ਟੈਸਟ ਕਾਲ (ਬਿਲਡਰ ਮਾਈਕ ਸੈਸ਼ਨ)। ਇਹ ਨਾਨ-ਬਲਾਕਿੰਗ ਹੈ: ਕਿਸੇ ਵੀ 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ਸਟਰਿੰਗਸਿਰਫ਼ ਨਿਰਧਾਰਤ ਭੇਜਣ ਦੁਆਰਾ ਕੀਤੀ ਗਈ ਕਾਲ ਵਿੱਚ: ਉਸ ਭੇਜਣ ਦੀ 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ਸਟਰਿੰਗ | ਨਲਸਧਾਰਨ ਭਾਸ਼ਾ ਵਿੱਚ ਕਾਲ ਤੋਂ ਬਾਅਦ ਦਾ ਸੰਖੇਪ (ਗੱਦ ਦੇ ਦੋ ਤੋਂ ਚਾਰ ਵਾਕ, ਵੱਧ ਤੋਂ ਵੱਧ 2,000 ਅੱਖਰ, ਏਜੰਟ ਦੀ summary_language ਵਿੱਚ ਲਿਖਿਆ ਗਿਆ, ਨਹੀਂ ਤਾਂ ਸੰਸਥਾ ਦੀ ਸੰਖੇਪ ਭਾਸ਼ਾ ਵਿੱਚ, ਨਹੀਂ ਤਾਂ ਕਾਲ ਦੀ ਭਾਸ਼ਾ ਵਿੱਚ: ਏਜੰਟ ਦੀ ਮੁੱਖ ਭਾਸ਼ਾ, ਜਦ ਤੱਕ ਕਾਲ ਨੇ ਇਸਨੂੰ ਓਵਰਰਾਈਡ ਨਾ ਕੀਤਾ ਹੋਵੇ) ਜਦੋਂ ਏਜੰਟ ਬਿਲਡਰ ਵਿੱਚ ਕਾਲ ਸੰਖੇਪ ਬਣਾਓ ਨੂੰ ਇਕੱਠਾ ਕਰਨ ਲਈ ਡਾਟਾ ਹੇਠ ਚਾਲੂ ਕੀਤਾ ਗਿਆ ਹੋਵੇ (ਏਜੰਟ ਉੱਤੇ call_summary_enabled) ਅਤੇ ਬਣਾਉਣਾ ਸਫਲ ਰਿਹਾ ਹੋਵੇ; ਨਹੀਂ ਤਾਂ 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 ਅਤੇ ਇਸਦੀ ID), step (ਕਦਮ ਦੀ ID, ਜਾਂ ਬਿਨਾਂ ਕਦਮਾਂ ਵਾਲੇ ਏਜੰਟ ਨੂੰ ਹੈਂਡਆਫ਼ ਉੱਤੇ null) ਅਤੇ via (start, model, condition, on_enter ਜਾਂ handoff) ਹੁੰਦੇ ਹਨ। ਸਿਰਫ਼ ID ਅਤੇ ਸਮੇਂ ਰੱਖਦਾ ਹੈ, ਇਸ ਲਈ ਰਿਕਾਰਡਿੰਗ ਬੰਦ ਹੋਣ 'ਤੇ ਵੀ ਰੱਖਿਆ ਜਾਂਦਾ ਹੈ
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_failedwebhook ਮੋਡ ਵਿੱਚ ਕਿਸੇ ਨੰਬਰ ਲਈ ਇਨਬਾਊਂਡ ਕਾਲ: ਕੰਫਿਗਰੇਸ਼ਨ webhook ਨੇ ਵਰਤਣਯੋਗ ਕੰਫਿਗਰੇਸ਼ਨ ਵਾਪਸ ਨਹੀਂ ਕੀਤੀ, ਇਸ ਲਈ ਏਜੰਟ ਦੇ ਜਵਾਬ ਦੇਣ ਤੋਂ ਪਹਿਲਾਂ ਕਾਲ ਖਤਮ ਕਰ ਦਿੱਤੀ ਗਈ। 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, ਜਦੋਂ ਹਰ ਵਾਰੀ ਵੱਖਰੇ ਤੌਰ 'ਤੇ ਰਿਕਾਰਡ ਕੀਤਾ ਗਿਆ ਹੋਵੇ

ਪੂਰੀ ਤਰ੍ਹਾਂ ਸੰਰਚਿਤ ਵਾਰੀ ਇਤਿਹਾਸ ਲਈ (ਰੁਕਾਵਟ ਮਾਰਕਰਾਂ, ack-prompts, ਅਤੇ ਕੱਚੀਆਂ ਸਥਿਤੀਆਂ ਸਮੇਤ), ਵਰਤੋ GET /v1/calls/{call_id}/history।

ਪੁਰਾਣੇ ਪੇਲੋਡ ਦੇ ਅੰਤਰ

ਪੁਰਾਣਾ ਸਿੰਗਲ-URL webhook ਐਨਵਲਪ {"type": "telephony.complete" | "web.complete", "data": {…}} ਹੈ, ਜਿਸ ਵਿੱਚ ਕੋਈ event_id ਨਹੀਂ ਹੁੰਦਾ, ਅਤੇ ਇਸਦਾ data ਐਂਡਪੌਇੰਟ ਪੇਲੋਡ ਤੋਂ ਵੱਖਰਾ ਹੁੰਦਾ ਹੈ:

ਪੁਰਾਣੇ ਸਮਾਪਤੀ ਪੇਲੋਡ ਵਿੱਚ agent_id ਅਤੇ agent_name ਵੀ ਹੁੰਦੇ ਹਨ।

  • ਵਾਰੀ ਐਰੇ transcripts ਦੀ ਬਜਾਏ history ਹੇਠ ਹੁੰਦਾ ਹੈ (ਉੱਪਰ ਦਿੱਤੇ ਵਾਂਗ ਹੀ ਵਾਰੀ ਸਕੀਮਾ)।
  • ਫੀਲਡ ਸੈੱਟ ਕਾਲ-ਸਮਾਪਤੀ ਦੀ ਕੱਚੀ ਰਿਪੋਰਟ ਹੈ ਅਤੇ ਇਸ ਵਿੱਚ ਉੱਪਰਲੀ ਟੇਬਲ ਤੋਂ ਇਲਾਵਾ ਵਾਧੂ ਅੰਦਰੂਨੀ ਫੀਲਡ ਸ਼ਾਮਲ ਹੋ ਸਕਦੇ ਹਨ — ਅਣਜਾਣ ਫੀਲਡਾਂ ਨੂੰ ਜਾਣਕਾਰੀ ਲਈ ਸਮਝੋ।
  • ਵੈੱਬ ਕਾਲਾਂ (direction: "web") ਵਿੱਚ from_number / to_number ਨਹੀਂ ਹੁੰਦੇ ਅਤੇ origin_domain ਜੋੜਿਆ ਜਾਂਦਾ ਹੈ।
  • Builder ਮਾਈਕ ਟੈਸਟ ਕਾਲਾਂ ਪੁਰਾਣੇ ਪਾਥ ਉੱਤੇ telephony.complete ਵਜੋਂ ਰਿਪੋਰਟ ਹੁੰਦੀਆਂ ਹਨ (ਐਂਡਪੌਇੰਟ ਸਿਸਟਮ ਉਨ੍ਹਾਂ ਨੂੰ web.complete ਨਾਲ ਮੈਪ ਕਰਦਾ ਹੈ)।
  • ਟ੍ਰਾਂਸਫ਼ਰ ਤਾਲਮੇਲ: ਜਦੋਂ ਕਾਲ ਟ੍ਰਾਂਸਫ਼ਰ ਵਿੱਚ ਖਤਮ ਹੁੰਦੀ ਹੈ, ਪੁਰਾਣੇ webhook ਨੂੰ ਸਮਕਾਲੀ ਤੌਰ 'ਤੇ ਕਾਲ ਕੀਤਾ ਜਾਂਦਾ ਹੈ ਅਤੇ ਇਹ ਇਹ ਸੰਕੇਤ ਦੇਣ ਲਈ {"transfer_ready": false} ਜਵਾਬ ਦੇ ਸਕਦਾ ਹੈ ਕਿ ਹੈਂਡਆਫ਼ ਟਾਰਗੇਟ ਤਿਆਰ ਨਹੀਂ ਹੈ। ਕੋਈ ਵੀ ਹੋਰ ਜਵਾਬ (ਜਾਂ ਕੋਈ ਪੁਰਾਣਾ webhook ਨਾ ਹੋਣਾ) ਟ੍ਰਾਂਸਫ਼ਰ ਨੂੰ ਅੱਗੇ ਵਧਣ ਦਿੰਦਾ ਹੈ। ਇਸ ਲਈ ਐਂਡਪੌਇੰਟ ਡਿਲਿਵਰੀਆਂ ਨਾਲ ਕਦੇ ਸਲਾਹ ਨਹੀਂ ਕੀਤੀ ਜਾਂਦੀ।

ਉਦਾਹਰਨ ਹੈਂਡਲਰ

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 ਟੂਲ ਵਿੱਚ ਖੋਲ੍ਹੋ, ਜਾਂ ਉਹਨਾਂ ਨੂੰ ਆਪਣੇ ਮੁਲਾਂਕਣ ਮਾਡਲ ਰਾਹੀਂ ਚਲਾਓ।

ਸੂਚਨਾਵਾਂ

ਟ੍ਰਾਂਸਫ਼ਰ / ਅਸਫਲਤਾ ਹੋਣ 'ਤੇ ਕਿਸੇ ਮਨੁੱਖੀ ਟੀਮ ਮੈਂਬਰ ਨੂੰ ਸੂਚਿਤ ਕਰੋ।


ਸੰਬੰਧਿਤ