ಈವೆಂಟ್‌ಗಳ ಕ್ಯಾಟಲಾಗ್

ಪ್ರತಿಯೊಂದು ವೆಬ್‌ಹುಕ್ ಬಾಡಿಯು type ಫೀಲ್ಡ್ ಅನ್ನು ಹೊಂದಿರುತ್ತದೆ; ಅದರ ಮೌಲ್ಯವು ಈ ಪುಟದಲ್ಲಿರುವ ಈವೆಂಟ್ ಪ್ರಕಾರಗಳಲ್ಲಿ ಒಂದಾಗಿರುತ್ತದೆ. ನೀವು ಒಂದು ಎಂಡ್‌ಪಾಯಿಂಟ್‌ಗೆ ಸಬ್‌ಸ್ಕ್ರೈಬ್ ಮಾಡಿದಾಗ, events ಅರೆ ನೀವು ಬಯಸುವ ಈವೆಂಟ್ ಪ್ರಕಾರಗಳನ್ನು ಹೊಂದಿರಬೇಕು (ಅಥವಾ ಎಲ್ಲದಕ್ಕೂ ಸಬ್‌ಸ್ಕ್ರೈಬ್ ಆಗಲು ಖಾಲಿಯಾಗಿರಬೇಕು).

ಎರಡು ಡೆಲಿವರಿ ಶೈಲಿಗಳು ಈ ಈವೆಂಟ್‌ಗಳನ್ನು ಸಾಗಿಸುತ್ತವೆ:

• ಎಂಡ್‌ಪಾಯಿಂಟ್ ಡೆಲಿವರಿಗಳು ಯಾವಾಗಲೂ ತಡೆರಹಿತ ಅಧಿಸೂಚನೆಗಳಾಗಿದ್ದು, ಮರುಪ್ರಯತ್ನಗಳನ್ನು ಹೊಂದಿರುತ್ತವೆ: ಯಾವುದೇ 2xx ನೊಂದಿಗೆ ಪ್ರತಿಕ್ರಿಯಿಸಿ; ಎನ್‌ವೆಲಪ್‌ನಲ್ಲಿ ಡೀಡ್ಯುಪ್ ಮಾಡಲು event_id ಇರುತ್ತದೆ.
• ತಡೆಗಟ್ಟುವ ವಿನಿಮಯಗಳು ಕೇವಲ ಲೆಗಸಿ ಏಕ-URL ವೆಬ್‌ಹುಕ್‌ನಲ್ಲಿ ಕಾರ್ಯನಿರ್ವಹಿಸುತ್ತವೆ: telephony.incoming / web.incoming ಕಾನ್ಫಿಗರೇಶನ್ ವಿನಂತಿ (ವೆಬ್‌ಹುಕ್-ಮೋಡ್ ಸಂಖ್ಯೆಗಳು ಮತ್ತು ವಿಜೆಟ್ ಕೀಗಳು, 10 ಸೆ ಟೈಮ್‌ಔಟ್) ಮತ್ತು ವೆಬ್‌ಹುಕ್-ಮೋಡ್ ಟೂಲ್ ಡಿಸ್ಪ್ಯಾಚ್. ನಿಮ್ಮ ಪ್ರತಿಕ್ರಿಯೆಯು ಲೈವ್ ಕರೆಯನ್ನು ರೂಪಿಸುತ್ತದೆ.

ಕೆಳಗಿನ ಉದಾಹರಣೆ ಪೇಲೋಡ್‌ಗಳು ಎಂಡ್‌ಪಾಯಿಂಟ್ ಎನ್‌ವೆಲಪ್ ಅನ್ನು ಅದರ ವೈರ್ ಕ್ರಮದಲ್ಲಿ ತೋರಿಸುತ್ತವೆ (ಕೀಗಳನ್ನು ವರ್ಣಮಾಲಾ ಕ್ರಮದಲ್ಲಿ ವಿಂಗಡಿಸಲಾಗಿದೆ: 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>"}.

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 ಅನ್ನು ಹೊಂದಿರುತ್ತದೆ.

ಧ್ವನಿ ಈವೆಂಟ್‌ಗಳು

ಕಸ್ಟಮ್ ಧ್ವನಿ ರಚನೆಯು ಅಸಮಕಾಲಿಕವಾಗಿದೆ. ಈ ತಡೆಯಿಲ್ಲದ ಈವೆಂಟ್‌ಗಳು ನಿಮಗೆ ಪೋಲಿಂಗ್ ಮಾಡುವ ಬದಲು ಅಂತಿಮ ಫಲಿತಾಂಶಕ್ಕೆ ಪ್ರತಿಕ್ರಿಯಿಸಲು ಅವಕಾಶ ನೀಡುತ್ತವೆ ಕ್ಲೋನ್ ವಿವರ ಎಂಡ್‌ಪಾಯಿಂಟ್.

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

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

ಪರೀಕ್ಷಾ ಕರೆ ಈವೆಂಟ್‌ಗಳು

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 ಚಾನೆಲ್‌ಗಳನ್ನು ರಚಿಸಲು ಎಚ್ಚರಿಕೆಗಳ ಮಾರ್ಗದರ್ಶಿ ನೋಡಿ.

ಸಂಬಂಧಿತ