Skip to main content

​
Overview

Outbound Voice connections simulate your agent making calls to users.

​
Configuration Requirements

​
Trigger Call Endpoint

  • Field: trigger_call_endpoint
  • Type: String (required)
  • Format: Valid HTTPS URL
  • Purpose: The webhook endpoint where outbound calls are initiated
  • Example: https://your-endpoint.com/webhook

​
Trigger Call Headers

  • Field: trigger_call_headers
  • Type: String (optional)
  • Format: Valid JSON string
  • Purpose: HTTP headers to include in trigger requests
  • Example: {"Content-Type": "application/json", "Authorization": "Bearer token123"}

​
Phone Number Key

  • Field: phone_number_key
  • Type: String (optional)
  • Default: "phone_number"
  • Purpose: Key used to identify the phone number in the trigger payload
  • Example: "phone_number", "recipient_phone", "target_number"

​
Trigger Call Payload

  • Field: trigger_call_payload
  • Type: String (optional)
  • Format: Valid JSON string
  • Purpose: Additional data to send with the trigger request
  • Example: {"sequence_code": "ABC123", "campaign_id": "summer2024"}

​
Setup Instructions

  1. Configure webhook endpoint URL that can receive HTTP POST requests
  2. Set authentication headers as JSON string
  3. Define phone number key and payload structure
  4. Test webhook response and call initiation

​
Technical Details

Call Initiation Flow
  1. Coval sends HTTP POST request to trigger endpoint
  2. Your system receives webhook and initiates call
  3. Agent connects to specified phone number
  4. Conversation proceeds with real-time monitoring
Webhook Payload Structure 
{
  "phone_number": "+12345678901",
  "sequence_code": "ABC123",
  "campaign_id": "summer2024"
}

​
Troubleshooting

Common Issues:
  • Webhook Not Triggering: Verify endpoint URL and accessibility
  • Invalid JSON Format: Validate headers and payload syntax
  • Authentication Failures: Check authorization headers and tokens
  • Call Connection Issues: Verify phone number format and availability