ਈਵੈਂਟ ਕੈਟਾਲਾਗ

ThunderPhone ਵੱਲੋਂ ਭੇਜੇ ਜਾਣ ਵਾਲੇ ਸਾਰੇ webhook ਈਵੈਂਟ ਕਿਸਮਾਂ।

ਹਰ ਵੈੱਬਹੁੱਕ ਬਾਡੀ ਵਿੱਚ ਇੱਕ type ਫੀਲਡ ਹੁੰਦੀ ਹੈ ਜਿਸਦਾ ਮੁੱਲ ਇਸ ਸਫ਼ੇ ਦੇ ਇਵੈਂਟ ਕਿਸਮਾਂ ਵਿੱਚੋਂ ਇੱਕ ਹੁੰਦਾ ਹੈ। ਜਦੋਂ ਤੁਸੀਂ ਕਿਸੇ ਐਂਡਪੌਇੰਟ ਨੂੰ ਸਬਸਕ੍ਰਾਈਬ ਕਰਦੇ ਹੋ, ਤਾਂ events ਐਰੇ ਵਿੱਚ ਉਹ ਇਵੈਂਟ ਕਿਸਮਾਂ ਹੋਣੀਆਂ ਚਾਹੀਦੀਆਂ ਹਨ ਜੋ ਤੁਸੀਂ ਚਾਹੁੰਦੇ ਹੋ (ਜਾਂ ਹਰ ਚੀਜ਼ ਲਈ ਸਬਸਕ੍ਰਾਈਬ ਕਰਨ ਲਈ ਇਹ ਖਾਲੀ ਹੋਵੇ — ਸਿਵਾਏ ਪ੍ਰਤੀ-ਟਰਨ ਇਵੈਂਟਾਂ telephony.turn / web.turn ਦੇ, ਜੋ ਸਿਰਫ਼ ਉਹਨਾਂ ਐਂਡਪੌਇੰਟਾਂ ਨੂੰ ਭੇਜੇ ਜਾਂਦੇ ਹਨ ਜੋ ਉਨ੍ਹਾਂ ਨੂੰ ਸਪਸ਼ਟ ਤੌਰ 'ਤੇ ਨਾਮਿਤ ਕਰਦੇ ਹਨ)।

ਇਹ ਇਵੈਂਟ ਦੋ ਡਿਲੀਵਰੀ ਸ਼ੈਲੀਆਂ ਰਾਹੀਂ ਭੇਜੇ ਜਾਂਦੇ ਹਨ:

• ਐਂਡਪੌਇੰਟ ਡਿਲੀਵਰੀਆਂ ਹਮੇਸ਼ਾ ਮੁੜ-ਕੋਸ਼ਿਸ਼ਾਂ ਦੇ ਨਾਲ ਨਾ-ਰੋਕਣ ਵਾਲੀਆਂ ਸੂਚਨਾਵਾਂ ਹੁੰਦੀਆਂ ਹਨ: ਕੋਈ ਵੀ 2xx ਜਵਾਬ ਦਿਓ; ਐਨਵਲਪ ਵਿੱਚ event_id ਹੁੰਦਾ ਹੈ ਜਿਸਦੇ ਆਧਾਰ 'ਤੇ ਡੀਡੁਪਲੀਕੇਟ ਕੀਤਾ ਜਾ ਸਕਦਾ ਹੈ।
• ਰੋਕਣ ਵਾਲੇ ਲੈਣ-ਦੇਣ ਸਿਰਫ਼ ਪੁਰਾਣੇ ਸਿੰਗਲ-URL ਵੈੱਬਹੁੱਕ 'ਤੇ ਚੱਲਦੇ ਹਨ: telephony.incoming / web.incoming ਕੌਂਫਿਗਰੇਸ਼ਨ ਬੇਨਤੀ (ਵੈੱਬਹੁੱਕ-ਮੋਡ ਨੰਬਰ ਅਤੇ ਵਿਜਟ ਕੁੰਜੀਆਂ, 10 s ਟਾਈਮਆਉਟ) ਅਤੇ ਵੈੱਬਹੁੱਕ-ਮੋਡ ਟੂਲ ਡਿਸਪੈਚ। ਤੁਹਾਡਾ ਜਵਾਬ ਚੱਲ ਰਹੀ ਕਾਲ ਨੂੰ ਆਕਾਰ ਦਿੰਦਾ ਹੈ।

ਹੇਠਾਂ ਦਿੱਤੇ ਉਦਾਹਰਨ ਪੇਲੋਡ ਆਪਣੇ ਵਾਇਰ ਕ੍ਰਮ ਵਿੱਚ ਐਂਡਪੌਇੰਟ ਐਨਵਲਪ ਦਿਖਾਉਂਦੇ ਹਨ (ਕੁੰਜੀਆਂ ਵਰਣਮਾਲਾ ਅਨੁਸਾਰ ਕ੍ਰਮਬੱਧ ਹਨ: 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"
}

telephony.complete#

ਜਦੋਂ ਇਨਬਾਊਂਡ ਜਾਂ ਆਉਟਬਾਊਂਡ ਟੈਲੀਫੋਨੀ ਕਾਲ ਸਮਾਪਤ ਹੁੰਦੀ ਹੈ ਤਾਂ ਭੇਜਿਆ ਜਾਂਦਾ ਹੈ। ਗੈਰ-ਬਲਾਕਿੰਗ। ਇਸ ਵਿੱਚ ਟ੍ਰਾਂਸਕ੍ਰਿਪਟ, ਉਪਲਬਧ ਹੋਣ 'ਤੇ ਰਿਕਾਰਡਿੰਗ URL, ਅਤੇ ਬਿਲਿੰਗ ਸੰਖੇਪ ਸ਼ਾਮਲ ਹੁੰਦੇ ਹਨ। ਪੇਲੋਡ ਸਕੀਮਾ ਲਈ telephony.complete / web.complete ਵੇਖੋ।

telephony.tool#

ਟੈਲੀਫੋਨੀ ਕਾਲ ਵੱਲੋਂ ਫੰਕਸ਼ਨ ਟੂਲ ਨੂੰ ਚਲਾਉਣ ਤੋਂ ਬਾਅਦ ਭੇਜਿਆ ਜਾਂਦਾ ਹੈ। ਗੈਰ-ਬਲਾਕਿੰਗ ਆਡਿਟ ਸੂਚਨਾ — ਇਹ ਇਵੈਂਟ ਡਿਲਿਵਰ ਹੋਣ ਤੱਕ ਟੂਲ ਪਹਿਲਾਂ ਹੀ ਚੱਲ ਚੁੱਕਾ ਹੁੰਦਾ ਹੈ; ਇਹ ਤੁਹਾਡੇ ਆਪਣੇ ਫੰਕਸ਼ਨ ਟੂਲਾਂ ਨੂੰ ਕਵਰ ਕਰਦਾ ਹੈ (ਬਿਲਟ-ਇਨ, ਗਿਆਨ-ਅਧਾਰਿਤ, ਐਪ-ਕਨੈਕਸ਼ਨ, ਜਾਂ MCP ਟੂਲਾਂ ਨੂੰ ਨਹੀਂ)।

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

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

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 ਖਾਲੀ ਹੁੰਦੇ ਹਨ।

web.complete#

telephony.complete ਦਾ ਵੈੱਬ-ਚੈਨਲ ਸਮਕੱਖ, ਜੋ ਵੈੱਬ ਵਿਜਟ ਕਾਲਾਂ (direction: "web") ਅਤੇ ਬਿਲਡਰ ਮਾਈਕ ਟੈਸਟ ਕਾਲਾਂ (direction: "test") ਨੂੰ ਕਵਰ ਕਰਦਾ ਹੈ। ਗੈਰ-ਬਲਾਕਿੰਗ। ਇਸਦਾ ਪੇਲੋਡ ਆਕਾਰ telephony.complete ਵਰਗਾ ਹੀ ਹੈ, ਨਾਲ ਹੀ origin_domain, ਅਤੇ from_number ਨੂੰ "web" 'ਤੇ ਸੈੱਟ ਕੀਤਾ ਜਾਂਦਾ ਹੈ।

web.tool#

telephony.tool ਦਾ ਵੈੱਬ-ਚੈਨਲ ਸਮਕੱਖ। data ਵਿੱਚ from_number / to_number ਦੀ ਥਾਂ origin_domain ਹੁੰਦਾ ਹੈ।

web.turn#

telephony.turn ਦਾ ਵੈੱਬ-ਚੈਨਲ ਸਮਕੱਖ, ਜੋ ਵੈੱਬ ਵਿਜਟ ਕਾਲਾਂ ਅਤੇ ਬਿਲਡਰ ਮਾਈਕ ਟੈਸਟ ਕਾਲਾਂ ਨੂੰ ਕਵਰ ਕਰਦਾ ਹੈ। ਪੇਲੋਡ ਦਾ ਆਕਾਰ ਉਹੀ ਹੈ, ਪਰ from_number / to_number ਦੀ ਥਾਂ origin_domain ਹੁੰਦਾ ਹੈ। telephony.turn ਵਾਂਗ, ਇਸ ਲਈ ਵੀ ਇੱਕ ਸਪੱਸ਼ਟ ਸਬਸਕ੍ਰਿਪਸ਼ਨ ਲੋੜੀਂਦੀ ਹੈ — ਇਹ ਕਦੇ ਵੀ ਖਾਲੀ events ਐਰੇ ਰਾਹੀਂ ਡਿਲਿਵਰ ਨਹੀਂ ਹੁੰਦਾ।

ਆਵਾਜ਼ ਇਵੈਂਟ#

ਕਸਟਮ ਆਵਾਜ਼ ਬਣਾਉਣਾ ਅਸਿੰਕ੍ਰੋਨਸ ਹੁੰਦਾ ਹੈ। ਇਹ ਨਾਨ-ਬਲਾਕਿੰਗ ਇਵੈਂਟ ਤੁਹਾਨੂੰ ਪੋਲਿੰਗ ਕਰਨ ਦੀ ਬਜਾਏ ਅੰਤਿਮ ਨਤੀਜੇ 'ਤੇ ਪ੍ਰਤੀਕਿਰਿਆ ਕਰਨ ਦਿੰਦੇ ਹਨ ਕਲੋਨ ਵੇਰਵਾ ਐਂਡਪੌਇੰਟ।

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

ਗੁਣਵੱਤਾ ਇਵੈਂਟ#

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…"
    }
  },
  "event_id": "7c1d2e3f-4a5b-4c6d-8e9f-0a1b2c3d4e5f",
  "type": "call.graded"
}

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": "gemini-2.5-flash"
  },
  "event_id": "4d79ef1d-c2b1-4ed6-85b8-8326bd2895ef",
  "type": "call.data_extracted"
}

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

ਚਾਰ ਨਤੀਜਾ ਗਿਣਤੀਆਂ ਆਪਸੀ ਤੌਰ 'ਤੇ ਵੱਖਰੀਆਂ ਹਨ ਅਤੇ contacts_total ਦੇ ਬਰਾਬਰ ਜੋੜ ਬਣਾਉਂਦੀਆਂ ਹਨ: completed ਵਿੱਚ ਸਫਲ ਸੰਪਰਕ ਹੁੰਦੇ ਹਨ; no_answer ਵਿੱਚ ਉਹ ਅੰਤਿਮ ਅਸਫਲ/ਸਮਾਪਤ ਸੰਪਰਕ ਹੁੰਦੇ ਹਨ ਜਿਨ੍ਹਾਂ ਦਾ ਅੰਤਿਮ ਨਤੀਜਾ ਕੋਈ ਜਵਾਬ ਨਹੀਂ ਸੀ; failed ਵਿੱਚ ਹੋਰ ਸਾਰੇ ਅੰਤਿਮ ਅਸਫਲ/ਸਮਾਪਤ ਸੰਪਰਕ ਹੁੰਦੇ ਹਨ; ਅਤੇ remaining ਵਿੱਚ ਬਕਾਇਆ, ਸ਼ਡਿਊਲ ਕੀਤੇ ਜਾਂ ਮੌਜੂਦਾ ਸਮੇਂ ਕਾਲ ਕੀਤੇ ਜਾ ਰਹੇ ਸੰਪਰਕ ਹੁੰਦੇ ਹਨ। ਰੀਟ੍ਰਾਈ ਦੀ ਉਡੀਕ ਕਰ ਰਿਹਾ ਸੰਪਰਕ remaining ਹੁੰਦਾ ਹੈ, ਭਾਵੇਂ ਉਸਦੀ ਸਭ ਤੋਂ ਹਾਲੀਆ ਕੋਸ਼ਿਸ਼ ਦਾ ਨਤੀਜਾ ਕੋਈ ਜਵਾਬ ਨਾ ਹੋਵੇ। ਇੱਕ-ਵਾਰ ਵਾਲੇ ਮੁਕੰਮਲਤਾ ਸਨੈਪਸ਼ਾਟ ਤੋਂ ਪਹਿਲਾਂ ਚੱਲ ਰਹੀਆਂ ਕਾਲਾਂ ਦਾ ਮੇਲ ਕੀਤਾ ਜਾਂਦਾ ਹੈ। started_at ਕਨਫਿਗਰ ਕੀਤਾ ਕੈਂਪੇਨ ਸ਼ੁਰੂ ਸਮਾਂ ਹੈ, ਜਾਂ ਜਦੋਂ ਕੋਈ ਸ਼ੁਰੂ ਸਮਾਂ ਕਨਫਿਗਰ ਨਾ ਹੋਵੇ ਤਾਂ ਕੈਂਪੇਨ ਬਣਾਉਣ ਦਾ ਸਮਾਂ ਹੈ।

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

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

ਇਹ ਇੱਕ ਨੋਟੀਫਿਕੇਸ਼ਨ ਹੈ, ਐਵੀਡੈਂਸ ਬੰਡਲ ਨਹੀਂ। ਇਸਨੂੰ ਸਮੱਸਿਆ ਪੈਟਰਨ ਨਾਲ ਜੋੜਨ ਲਈ 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"
}

ਅਲਰਟ ਇਵੈਂਟਸ#

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

ਨਿਯਮ, ਮੈਟ੍ਰਿਕਸ, ਕੂਲਡਾਊਨ, ਅਤੇ ਈਮੇਲ / Slack ਚੈਨਲ ਬਣਾਉਣ ਲਈ ਅਲਰਟਸ ਗਾਈਡ ਦੇਖੋ।

ਸੰਬੰਧਿਤ#