Submit batch calling job

POST

/v1/convai/batch-calling/submit

POST

/v1/convai/batch-calling/submit

curl -X POST https://api.elevenlabs.io/v1/convai/batch-calling/submit \
     -H "Content-Type: application/json" \
     -d '{
  "call_name": "call_name",
  "agent_id": "agent_id",
  "recipients": [
    {}
  ]
}'

{
  "id": "id",
  "name": "name",
  "agent_id": "agent_id",
  "created_at_unix": 1,
  "scheduled_time_unix": 1,
  "total_calls_dispatched": 1,
  "total_calls_scheduled": 1,
  "total_calls_finished": 1,
  "last_updated_at_unix": 1,
  "status": "pending",
  "retry_count": 1,
  "telephony_call_config": {
    "ringing_timeout_secs": 1,
    "twilio_call_recording_enabled": true,
    "twilio_machine_detection": {
      "mode": "enable"
    }
  },
  "agent_name": "agent_name",
  "phone_number_id": "phone_number_id",
  "phone_provider": "twilio",
  "whatsapp_params": {
    "whatsapp_call_permission_request_template_name": "whatsapp_call_permission_request_template_name",
    "whatsapp_call_permission_request_template_language_code": "whatsapp_call_permission_request_template_language_code",
    "whatsapp_phone_number_id": "whatsapp_phone_number_id"
  },
  "branch_id": "branch_id",
  "environment": "environment",
  "timezone": "timezone",
  "target_concurrency_limit": 1,
  "branch_name": "branch_name"
}

Submit a batch call request to schedule calls for multiple recipients.

Anfrage

This endpoint expects an object.

call_namestringErforderlich

agent_idstringErforderlich

recipientslist of objectsErforderlich

scheduled_time_unixintegerOptional

agent_phone_number_idstringOptional

whatsapp_paramsobjectOptional

timezonestringOptional

branch_idstringOptional

environmentstringOptional

telephony_call_configobjectOptional

target_concurrency_limitintegerOptional>=1

Maximum number of simultaneous calls for this batch. When set, dispatch is governed by this limit rather than workspace/agent capacity percentages.

Antwort

Successful Response

idstring

namestring

agent_idstring

created_at_unixinteger

scheduled_time_unixinteger

total_calls_dispatchedintegerStandardwert ist 0

total_calls_scheduledintegerStandardwert ist 0

total_calls_finishedintegerStandardwert ist 0

last_updated_at_unixinteger

statusenum

Erlaubte Werte:

retry_countintegerStandardwert ist 0

telephony_call_configobject

agent_namestring

phone_number_idstringOptional

phone_providerenumOptional