Skip to content

Cisco CUBE Call Events Webhook

Overview

Stream real-time call events from Cisco CUBE to any webhook JSON API endpoint. Get instant notifications when calls start ringing, connect, or disconnect - perfect for CRM integrations, call analytics, or custom workflows.

This webhook integration provides live call telemetry without the complexity of JTAPI, TSP, or building your own CUBE XCC integration.

Why Use CUBE Webhooks

  • Real-time Call Events: Instant notifications for ALERTING, CONNECTED, and DISCONNECTED states
  • Simple Integration: Simpler integration compared to JTAPI or TSP
  • CRM Integration: Update customer records in real-time as calls happen
  • Call Analytics: Build custom dashboards with live call data
  • No JTAPI Required: Simpler alternative to traditional Cisco integrations

Webhook Payload

Each call event sends a lightweight JSON payload with essential call information:

json
{
  "call_state": "DISCONNECTED",
  "called_number": "+12512501663",
  "calling_number": "+12517676234",
  "timestamp": "2024-11-23T16:03:36.200940Z"
}

Payload Fields:

  • call_state: Current state of the call (ALERTING, CONNECTED, or DISCONNECTED)
  • calling_number: Originating phone number (E.164 format when available)
  • called_number: Destination phone number (E.164 format when available)
  • timestamp: ISO 8601 formatted timestamp with microsecond precision

Supported Call States

  • ALERTING: Call is ringing (useful for screen pops)
  • CONNECTED: Call answered (track call connection time)
  • DISCONNECTED: Call ended (update call logs on disconnection)

📚 Learn more: CUBE XCC Integration Guide | Cisco XCC API Docs

Requirements

Software Requirements

Network Requirements

  • CUBE must reach Call Telemetry server on port 8090 (XCC registration)
  • CUBE initiates new TCP sessions to port 80 for call processing
  • Webhook endpoints must be accessible via HTTPS from Call Telemetry server
  • Firewall rules must allow bidirectional communication

Integration Notes

  • CURRI Integration is not required
  • Can coexist with existing CURRI policies

Prerequisites

⚠️ Important: CUBE webhooks require an active CUBE XCC integration. You must first:

  1. Configure CUBE XCC Integration on your CUBE router
  2. Ensure the CUBE is registered and processing calls through Call Telemetry
  3. Verify call events are flowing by checking the CUBE's call history

Without an active CUBE integration, webhooks will not receive any call events.

Configuration Steps

Step 1: Create a Webhook

  1. Navigate to CubesCube Webhooks in Call Telemetry

  2. Click Add Webhook

  3. Configure your webhook:

    • Name: Descriptive name (e.g., "CRM Call Events")
    • Description: Optional details about this webhook
    • URL: Your webhook endpoint (e.g., https://api.yourcrm.com/calls)
    • Method: POST
    • Enable: Toggle to activate/deactivate the webhook
    • Connection States: Select which call states to receive (ALERTING, CONNECTED, DISCONNECTED)
    • Associated CUBE: Choose which CUBE gateway to monitor
    • Headers: Add authentication or custom headers (e.g., Authorization: Bearer token)

CUBE XCC Webhooks Edit

On saving, your screen should look like this:

CUBE XCC Webhooks Logs

Step 2: Test Your Integration

  1. Place a test call through your CUBE gateway
  2. Click the calendar icon to view webhook logs
  3. Verify your endpoint received the call events

What the Logs Show:

  • Complete HTTP request details (method, headers, body)
  • Response status code and body
  • Timestamp for each webhook attempt
  • Any error messages or timeouts
  • Request/response correlation for troubleshooting

Webhook Log Examples

Successful Webhook Delivery:CUBE XCC Webhooks Logs

Failed Webhook with Error Details:CUBE XCC Webhooks Log Errors

Understanding Webhook Logs

Successful Webhook:

  • HTTP 200/201/202 status codes
  • Response received within timeout
  • Payload delivered successfully

Possible Errors:

  • Connection Refused: Endpoint unreachable or firewall blocking
  • 401/403: Authentication failure - check headers
  • 404: Incorrect URL path
  • 500: Endpoint server error
  • Timeout: Endpoint took too long to respond

Common Use Cases

CRM Integration

Update customer records when calls connect:

  • Display caller information before answering
  • Log call duration and outcomes
  • Trigger follow-up workflows

Call Analytics

Track real-time metrics:

  • Current calls in progress
  • Average call duration
  • Peak calling times
  • Agent availability

Custom Workflows

Automate based on call events:

  • Send SMS confirmations after calls
  • Update ticketing systems
  • Trigger recording policies
  • Alert managers of long calls

Troubleshooting

Webhook not receiving events?

  • Verify CUBE XCC integration is active and registered
  • Confirm calls are being processed through the CUBE (check call history)
  • Check webhook URL is publicly accessible
  • Review firewall rules for outbound HTTPS
  • Confirm webhook is enabled and associated with the correct CUBE

Missing call events?

  • Verify CUBE XCC is properly configured and registered
  • Check CUBE XCC Traffic Policy isn't filtering calls
  • Ensure webhook is enabled and associated with correct CUBE
  • Review CUBE logs for XCC connection status

Other Telemetry Features

CDR Webhooks (Premium feature):

  • Full CDR data
  • Conditional triggers based on CDR values
  • Metadata support
  • Hit statistics

Policy Webhook Apps (Premium feature):

  • GET/POST support
  • Variable substitution in URLs
  • Response processing for call control
  • Can modify calls based on API responses