Recupera una chiamata batch per ID.

GET

/v1/convai/batch-calling/:batch_id

GET

/v1/convai/batch-calling/:batch_id

curl https://api.elevenlabs.io/v1/convai/batch-calling/batch_id

{
  "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",
  "recipients": [
    {
      "id": "id",
      "status": "pending",
      "created_at_unix": 1,
      "updated_at_unix": 1,
      "phone_number": "phone_number",
      "whatsapp_user_id": "whatsapp_user_id",
      "conversation_id": "conversation_id",
      "conversation_initiation_client_data": {
        "conversation_config_override": {
          "asr": {
            "keywords": [
              "hello",
              "world"
            ]
          },
          "turn": {
            "soft_timeout_config": {
              "message": "Hhmmmm...yeah."
            }
          },
          "tts": {
            "model_id": "eleven_turbo_v2",
            "voice_id": "cjVigY5qzO86Huf0OWal",
            "stability": 0.5,
            "speed": 1,
            "similarity_boost": 0.8,
            "pronunciation_dictionary_locators": [
              {
                "pronunciation_dictionary_id": "pronunciation_dictionary_id",
                "version_id": null
              }
            ]
          },
          "conversation": {
            "max_duration_seconds": 600
          },
          "agent": {
            "first_message": "Hello, how can I help you today?",
            "language": "en",
            "prompt": {
              "prompt": "You are a helpful assistant that can answer questions about the topic of the conversation.",
              "llm": "gemini-2.0-flash-001",
              "tool_ids": [
                "tool_ids"
              ],
              "knowledge_base": [
                {
                  "type": "file",
                  "name": "My Knowledge Base",
                  "id": "123",
                  "usage_mode": "auto"
                }
              ]
            }
          }
        }
      }
    }
  ],
  "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"
}

Ottieni informazioni dettagliate su una chiamata batch, inclusi tutti i destinatari.

Parametri di percorso

batch_idstringObbligatorio

Risposta

Risposta riuscita

idstring

namestring

agent_idstring

created_at_unixinteger

scheduled_time_unixinteger

total_calls_dispatchedintegerPredefinito a 0

total_calls_scheduledintegerPredefinito a 0

total_calls_finishedintegerPredefinito a 0

last_updated_at_unixinteger

statusenum

Valori consentiti:

retry_countintegerPredefinito a 0

telephony_call_configobject

agent_namestring

recipientslist of objects

phone_number_idstringOpzionale

phone_providerenumOpzionale

Valori consentiti:

whatsapp_paramsobjectOpzionale

branch_idstringOpzionale

environmentstringOpzionale

timezonestringOpzionale

target_concurrency_limitintegerOpzionale>=1

Numero massimo di chiamate simultanee per questo batch. Quando impostato, l'invio è regolato da questo limite anziché dalle percentuali di capacità del workspace o dell'agente.

branch_namestringOpzionale

Errori

422

Batch Calls Get Request Unprocessable Entity Error

Parametri di percorso

Header

Risposta

Errori