Bridge ended notification

Internal endpoint that receives notifications when a call bridge (transfer) completes. Triggered automatically by the telephony system after a bridged call ends, allowing configured project functions to process bridge metadata and call duration information.

POST /internal/v1/agentic-dial/bridge-ended

cURL

cURL

curl -X POST "https://api.us-1.platform.polyai.app/internal/v1/agentic-dial/bridge-ended" -H "Content-Type: application/json" -d '{"conversation_id":"conv_abc123xyz","bridge_duration_seconds":180,"call_duration_seconds":300}'

400

{
  "error_message": "<string>"
}

Overview

The bridge-ended endpoint receives notifications when a call bridge (transfer) completes. This endpoint is triggered automatically by the telephony system after a bridged call ends, allowing configured project functions to process bridge metadata and call duration information.

Use cases

• Log bridge duration for analytics
• Trigger post-transfer workflows
• Update CRM systems with transfer outcomes
• Calculate agent availability based on bridge time

Request body

The endpoint accepts the following parameters:

Parameter	Type	Required	Description
conversation_id	string	Yes	The unique identifier for the conversation
bridge_duration_seconds	number	Yes	Duration of the bridge/transfer in seconds
call_duration_seconds	number	Yes	Total call duration in seconds

Example request

{
  "conversation_id": "conv_abc123xyz",
  "bridge_duration_seconds": 180,
  "call_duration_seconds": 300
}

Behavior

When this endpoint receives a bridge-ended notification:

1. The system extracts the conversation ID and bridge metadata
2. Configured project functions are triggered with the bridge data
3. Functions can access bridge duration and call duration for processing
4. The conversation state is updated to reflect the bridge completion

Configuration

This endpoint is automatically configured when you set up call transfer/bridge functionality in your project. Contact your PolyAI representative to enable bridge-ended notifications for your project.

Authorizations

X-Api-Key · string · header · required

API key for the External Events webhook. Contact your PolyAI representative to obtain credentials.

Body

application/json

conversation_id · string · required

The unique identifier for the conversation

bridge_duration_seconds · number · required

Duration of the bridge/transfer in seconds

call_duration_seconds · number · required

Total call duration in seconds

Response

200

Bridge ended notification received and processed successfully.