> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# 아웃바운드 캠페인 생성

POST https://api.elevenlabs.io/v1/convai/outbound-campaigns/campaigns/submit
Content-Type: application/json

정책의 통화 가능 시간대 내에서 에이전트가 각 수신자에게 전화하거나 메시지를 보내고, 허용되는 경우 재시도 및 후속 조치를 수행하는 아웃바운드 캠페인을 생성합니다. 새 캠페인에는 `201`을 반환합니다. `idempotency_key` 또는 요청 본문으로 일치하는 반복 요청은 기존 캠페인을 `created`가 false인 상태로 반환합니다.

Reference: https://elevenlabs.io/docs/api-reference/campaigns/create

## Servers

- `https://api.elevenlabs.io` (Production, default)
- `https://api.us.elevenlabs.io` (Production US)
- `https://api.eu.residency.elevenlabs.io` (Production EU)
- `https://api.in.residency.elevenlabs.io` (Production India)
- `https://api.sg.residency.elevenlabs.io` (Production Singapore)

## Request

### Body (application/json)

This endpoint expects a SubmitCampaignRequest.

- `call_name` (string, required) — 캠페인 이름입니다.
- `agent_id` (string, required) — 통화를 시작하는 에이전트입니다.
- `recipients` (list of SubmitCampaignRecipient, required) — 통화할 대상입니다. 각 수신자는 캠페인의 리드가 됩니다.
- `channel_config` (SubmitCampaignRequestChannelConfig, required)
- `scheduled_time_unix` (integer, optional, nullable) — 통화를 시작할 시점입니다. 생략하면 지금 시작합니다. 통화는 다음 통화 가능 시간대까지 기다립니다.
- `timezone` (string, optional, nullable) — 정책 설정을 재정의하여 통화 가능 시간대를 해석하는 IANA 시간대입니다.
- `branch_id` (string, optional, nullable) — 통화에 사용할 에이전트 브랜치입니다.
- `environment` (string, optional, nullable) — 에이전트 환경 변수를 해석할 환경입니다.
- `target_concurrency_limit` (integer, optional, nullable) — 동시에 시작할 최대 통화 수입니다.
- `idempotency_key` (string, optional, nullable) — 요청을 안전하게 재시도할 수 있게 합니다. 동일한 키로 반복 요청하면 생성된 캠페인을 반환합니다.
- `outcome` (SubmitCampaignRequestOutcome, optional, nullable) — 캠페인 통화에서 성공으로 간주되는 결과입니다.
- `policy` (PolicyConfig-Input, optional, nullable) — 캠페인에 스냅샷으로 적용할 정책입니다. 설정하면 워크스페이스 기본값 및 에이전트별 재정의 설정에 우선하며, 생략하면 워크스페이스 구성이 존재해야 하고 해당 구성이 정책을 제공합니다.
- `variant` (enum, optional, nullable) — `simple`은 항상 열려 있는 통화 가능 시간대에서 수집 항목 없이 수신자당 한 번 시도하며, `policy`와 함께 사용할 수 없습니다. `advanced`는 `policy` 또는 워크스페이스 구성을 사용하며 전화 캠페인의 기본값입니다.
  - Allowed values: `simple`, `advanced`

## Response

### 200

성공 응답

- `campaign` (CampaignResponse, required)
- `created` (boolean, required) — 요청이 이전 요청을 반복하여 해당 캠페인을 반환한 경우 false입니다.
- `within_calling_window` (boolean, required) — 다음 통화 가능 시간대가 아니라 즉시 통화를 시작할지 여부입니다.

## Errors

### 422 Unprocessable Entity Error

유효성 검사 오류

- `detail` (list of ValidationError, optional)

## Types

### SubmitCampaignRecipient

- `phone_number` (string, optional, nullable) — `+14155550100`과 같은 E.164 형식의 통화할 번호입니다.
- `phone_numbers` (list of string, optional, nullable) — `phone_number` 다음 순서로 통화할 추가 번호입니다. 현재 번호로 통화가 계속 실패하면 리드는 다음 번호로 이동합니다.
- `whatsapp_user_id` (string, optional, nullable) — 연락처의 WhatsApp 사용자 ID입니다. WhatsApp 캠페인에서는 전화번호 대신 사용합니다.
- `id` (string, optional, nullable) — 수신자에 대한 식별자이며, 해당 리드의 `recipient_id`로 반환됩니다.
- `conversation_initiation_client_data` (ConversationInitiationClientDataRequest-Input, optional, nullable) — 이 수신자의 통화에 적용할 동적 변수와 재정의 설정입니다.

### SubmitCampaignRequestChannelConfig

- `channel`: `phone` (PhoneChannelConfig)
  - `agent_phone_number_id` (string, required) — 발신에 사용할 전화번호입니다.
  - `mode_config` (PhoneVoiceConfig-Input, optional)
- `channel`: `whatsapp` (SubmitWhatsAppChannelConfig)
  - `mode_config` (SubmitWhatsAppChannelConfigModeConfig, required)
  - `whatsapp_phone_number_id` (string, required) — 통화를 걸거나 메시지를 보낼 때 사용할 WhatsApp 전화번호입니다.

### SubmitCampaignRequestOutcome

캠페인 통화에서 성공으로 간주되는 결과입니다.

- `type`: `data_collection` (DataCollectionOutcome)
  - `data_collection_id` (string, required) — 성공한 통화에서 설정하는 에이전트의 데이터 수집 항목입니다.
  - `equals` (list of CampaignResponseOutcomeDiscriminatorMappingDataCollectionEqualsItems, required) — 성공으로 간주되는 값이며, 모두 해당 항목의 유형입니다.
- `type`: `evaluation_criteria` (EvaluationCriterionOutcome)
  - `criteria_id` (string, required) — 성공한 통화가 충족하는 에이전트의 평가 기준입니다.

### PolicyConfig-Input

- `timezone` (string, optional, default: UTC) — 통화 시간대를 해석하는 데 사용하는 IANA 시간대입니다.
- `retry` (RetryPolicy, optional)
- `calling_periods` (list of CallingPeriod, optional) — 통화를 걸 수 있는 주간 시간대입니다.
- `data_collection` (DataCollectionConfig, optional) — 후속 통화를 결정하는 에이전트의 데이터 수집 항목입니다. 각 항목은 용도에 맞는 기본 제공 항목이 기본값이며, `null`로 설정하면 비활성화됩니다.
- `followup_context` (FollowupContextPolicy, optional) — 후속 통화에 전달할 `campaign__` 동적 변수입니다.

### CampaignResponse

- `campaign_id` (string, required)
- `call_name` (string, required) — 캠페인 이름입니다.
- `agent_id` (string, required)
- `channel_config` (CampaignResponseChannelConfig, required)
- `status` (enum, required) — `attention`은 해결되지 않은 주의 항목으로 인해 캠페인의 일부 통화가 보류되고 나머지는 진행됨을 의미합니다. `stopping`은 대기 중인 통화가 취소되고 이미 시작된 통화는 마무리 중임을 의미합니다.
  - Allowed values: `active`, `paused`, `stopping`, `stopped`, `completed`, `failed`, `attention`
- `policy` (CampaignPolicySnapshot, required) — 캠페인 생성 시 적용된 정책입니다.
- `variant` (enum, required)
  - Allowed values: `simple`, `advanced`
- `source` (enum, required, nullable) — 캠페인이 앱에서 생성되었는지 API를 통해 생성되었는지 여부입니다.
  - Allowed values: `ui`, `api`
- `outcome` (CampaignResponseOutcome, required, nullable) — 캠페인 통화에서 성공으로 간주되는 결과입니다.
- `created_at_unix` (integer, required)
- `scheduled_time_unix` (integer, required, nullable) — 캠페인이 통화를 시작하는 시점입니다. 설정하지 않으면 생성 즉시 시작합니다.
- `updated_at_unix` (integer, required)
- `branch_id` (string, required, nullable) — 캠페인이 통화에 사용하는 에이전트 브랜치입니다.
- `environment` (string, required, nullable) — 에이전트 환경 변수를 해석하는 환경입니다.
- `target_concurrency_limit` (integer, required, nullable) — 캠페인이 동시에 시작할 수 있는 최대 통화 수입니다.
- `channel` (enum, required)
  - Allowed values: `phone`, `whatsapp`
- `mode` (enum, required)
  - Allowed values: `voice`, `message`
- `counts` (CampaignSummaryCounts, required)
- `agent_name` (string, required, default: )

### ValidationError

- `loc` (list of ValidationErrorLocItems, required)
- `msg` (string, required)
- `type` (string, required)

### ConversationInitiationClientDataRequest-Input

- `conversation_config_override` (ConversationConfigClientOverride-Input, optional)
- `custom_llm_extra_body` (map from string to any, optional)
- `user_id` (string, optional, nullable) — 이 대화에 참여하는 최종 사용자 ID(에이전트 소유자의 사용자 식별용)
- `source_info` (ConversationInitiationSourceInfo, optional) — 대화 시작 출처 정보
- `branch_id` (string, optional, nullable) — 이 대화에 사용할 에이전트 브랜치 ID
- `environment` (string, optional, nullable) — 환경 변수를 확인하는 데 사용할 환경
- `starting_workflow_node_id` (string, optional, nullable) — 설정하면 기본 진입점 대신 이 노드 ID에서 workflow를 시작합니다.
- `procedure_ids` (list of string, optional, nullable) — 설정하면 시작 에이전트는 이 절차들만 사용할 수 있습니다. 각 ID는 해당 에이전트에 연결되어 있어야 하며, 알 수 없는 ID가 있으면 대화 시작에 실패합니다. 빈 목록은 해당 에이전트의 모든 절차를 비활성화합니다. 에이전트 전환 후에는 적용되지 않습니다. enable_procedure_ids_from_client가 필요합니다.
- `start_procedure_ids` (list of string, optional, nullable) — 설정하면 대화가 시작될 때 이러한 자유 형식 절차가 시작됩니다. 최대 5개의 ID를 허용합니다. 각 ID는 procedure_ids 적용 후 사용 가능해야 합니다. 알 수 없는 ID 및 구조화된 절차는 대화 시작에 실패합니다. enable_procedure_ids_from_client가 필요합니다.
- `dynamic_variables` (map from string to any, optional)

### PhoneVoiceConfig-Input

- `ringing_timeout_secs` (integer, optional, default: 60) — 포기하기 전에 수신자에게 벨을 울릴 시간(초)입니다. 제공업체 자체 제한도 적용됩니다.
- `twilio_call_recording_enabled` (boolean, optional, default: false) — Twilio 통화 녹음을 사용해 통화를 녹음할지 여부입니다. Twilio 이외의 제공업체에서는 무시됩니다. 녹음은 Twilio 계정에 저장됩니다.
- `twilio_machine_detection` (TwilioMachineDetectionConfig, optional, nullable) — Twilio의 통신사 수준 자동 응답기 감지(AMD)를 위한 구성입니다. 비활성화하려면 생략하거나 null로 설정하세요. Twilio 이외의 제공업체 및 수신 통화에서는 무시됩니다. 결과 판정은 별도의 `answering_machine_detection` 웹훅 이벤트로 전달되며, 이 이벤트는 워크스페이스 또는 에이전트 웹훅 설정에서 활성화해야 합니다. 이는 대화 또는 통화 후 웹훅의 일부가 아닙니다. 감지는 비동기적으로 실행되므로 대화 시작을 지연시키지 않으며, 판정은 통화 중 언제든지 도착할 수 있습니다. `detect_message_end`를 사용하면 통화가 종료된 후에도 도착할 수 있습니다. Twilio는 AMD에 대해 별도로 요금을 청구합니다.
- `mode` ("voice", optional, default: voice)

### SubmitWhatsAppChannelConfigModeConfig

- `mode`: `message` (SubmitWhatsAppMessageConfig)
  - `template` (SubmitWhatsAppTemplateRef, required) — 전송할 승인된 Meta 템플릿의 이름입니다. 서버가 템플릿을 직접 로드하므로 클라이언트는 구성 요소를 제공하지 않습니다.
- `mode`: `voice` (WhatsAppVoiceConfig)
  - `whatsapp_call_permission_request_template_language_code` (string, required) — 해당 템플릿의 언어 코드입니다.
  - `whatsapp_call_permission_request_template_name` (string, required) — 연락처에 통화 허가를 요청하는 승인된 템플릿입니다.

### CampaignResponseOutcomeDiscriminatorMappingDataCollectionEqualsItems

- string
- integer
- double
- boolean

### RetryPolicy

- `retry_delay_seconds` (integer, optional, default: 600) — 짧은 재시도 전 대기 시간입니다.
- `max_short_retries` (integer, optional, default: 1) — 통화 실패 후 하나의 통화 가능 시간대에서 허용되는 재시도 횟수입니다. 모두 사용하면 다음 재시도는 새로 시작되는 다음 시간대까지 기다립니다.
- `max_total_calls` (integer, optional, default: 6) — 첫 통화를 포함하여 리드가 받을 수 있는 최대 통화 횟수입니다.
- `max_callbacks` (integer, optional, default: 2) — 하나의 번호에 대해 허용할 최대 콜백 횟수입니다.
- `max_redirects` (integer, optional, default: 2) — 리드가 다른 번호로 통화해 달라는 요청을 따를 수 있는 최대 횟수입니다.
- `interval_placement` (enum, optional, default: start) — 연기된 통화를 이후 통화 가능 시간대의 어디에 배치할지 지정합니다. 해당 시간대의 `start`, `random` 시점 또는 그 시간대에서 마지막 통화가 실패한 지점에서 `rotate_step_seconds`만큼 지난 `rotate` 위치를 사용할 수 있습니다.
  - Allowed values: `start`, `random`, `rotate`
- `rotate_step_seconds` (integer, optional, default: 900) — `rotate` 배치가 각 통화를 이동시키는 간격입니다. `rotate`에서만 사용됩니다.
- `max_consecutive_failures_per_number` (integer, optional, nullable) — 리드가 다음 등록 번호로 이동하거나 다음 번호가 없으면 종료되기 전에 하나의 번호로 연속 실패할 수 있는 통화 횟수입니다. 통화가 연결되거나 새 번호로 리디렉션되면 횟수가 초기화됩니다. 설정하지 않으면 `max_total_calls`만 적용됩니다.

### CallingPeriod

- `weekdays` (list of integer, required) — 간격이 적용되는 요일입니다. `0`(월요일)부터 `6`(일요일)까지입니다.
- `intervals` (list of CallingIntervalPolicy, required) — 각 요일의 시간대입니다. 어떤 요일에서도 서로 겹칠 수 없습니다.

### DataCollectionConfig

후속 통화를 결정하는 에이전트의 데이터 수집 항목입니다. 각 항목은 용도에 맞는 기본 제공 항목이 기본값이며, `null`로 설정하면 비활성화됩니다.

- `callback_time` (string, optional, nullable, default: __system_data_collection_callback_time) — 연락처가 콜백을 요청한 시간을 보관하는 항목입니다.
- `redirect_phone_number` (string, optional, nullable, default: __system_data_collection_redirect_phone_number) — 연락처가 통화를 요청한 다른 번호를 보관하는 항목입니다.
- `stop` (string, optional, nullable, default: __system_data_collection_do_not_call) — 연락처가 다시 통화하지 말라고 요청한 경우 true가 되는 항목입니다.
- `mappings` (map from string to string, optional) — 이후 통화에 사용할 수 있도록 데이터 수집 결과를 동적 변수에 복사합니다. 각 키는 데이터 수집 항목 ID이고 값은 변수 이름입니다.

### FollowupContextPolicy

후속 통화에 전달할 `campaign__` 동적 변수입니다.

- `call_type` (boolean, optional, default: true) — 통화 유형을 `campaign__call_type`으로 전달합니다.
- `previous_conversation_id` (boolean, optional, default: true) — 마지막 대화의 ID를 `campaign__previous_conversation_id`으로 전달합니다.
- `previous_summary` (boolean, optional, default: true) — 마지막 대화의 요약을 `campaign__previous_summary`로 전달합니다.
- `previous_transcript` (boolean, optional, default: true) — 마지막 대화의 스크립트를 `campaign__previous_transcript`로 전달합니다.

### CampaignResponseChannelConfig

- `channel`: `phone` (PhoneChannelConfig)
  - `agent_phone_number_id` (string, required) — 발신에 사용할 전화번호입니다.
  - `mode_config` (PhoneVoiceConfig-Output, optional)
- `channel`: `whatsapp` (WhatsAppChannelConfig)
  - `mode_config` (WhatsAppChannelConfigModeConfig, required)
  - `whatsapp_phone_number_id` (string, required) — 통화를 걸거나 메시지를 보낼 때 사용할 WhatsApp 전화번호입니다.

### CampaignPolicySnapshot

캠페인 생성 시 적용된 정책이며, 제출된 `policy`와 같은 형식으로 제공됩니다.

- `timezone` (string, required)
- `retry` (RetryPolicy, required)
- `calling_periods` (list of CallingPeriodPolicy, required)
- `data_collection` (DataCollectionPolicy, required)
- `followup_context` (FollowupContextPolicy, required) — 후속 통화에 전달할 `campaign__` 동적 변수입니다.

### CampaignResponseOutcome

캠페인 통화에서 성공으로 간주되는 결과입니다.

- `type`: `data_collection` (DataCollectionOutcome)
  - `data_collection_id` (string, required) — 성공한 통화에서 설정하는 에이전트의 데이터 수집 항목입니다.
  - `equals` (list of CampaignResponseOutcomeDiscriminatorMappingDataCollectionEqualsItems, required) — 성공으로 간주되는 값이며, 모두 해당 항목의 유형입니다.
- `type`: `evaluation_criteria` (EvaluationCriterionOutcome)
  - `criteria_id` (string, required) — 성공한 통화가 충족하는 에이전트의 평가 기준입니다.

### CampaignSummaryCounts

- `leads` (integer, required)
- `terminal_leads` (integer, required) — 더 이상 통화하지 않을 리드입니다.
- `open_attention` (integer, required) — 아직 해결되지 않은 주의 항목입니다.
- `delivery` (RecipientDeliveryCounts, optional, nullable) — 각 단계에 도달한 메시지 수입니다. 메시지 캠페인 하나를 조회할 때 설정됩니다.

### ValidationErrorLocItems

- string
- integer

### ConversationConfigClientOverride-Input

- `asr` (ASRConversationalConfigOverride, optional, nullable) — 대화형 트랜스크립션 구성
- `turn` (TurnConfigOverride, optional, nullable) — 턴 감지 구성
- `tts` (TTSConversationalConfigOverride, optional, nullable) — 대화형 텍스트 음성 변환 구성
- `conversation` (ConversationConfigOverride, optional, nullable) — 대화 이벤트 구성
- `agent` (AgentConfigOverride-Input, optional, nullable) — 에이전트별 구성

### ConversationInitiationSourceInfo

대화 시작 출처 정보

- `source` (enum, optional, nullable, default: unknown) — 대화 시작 출처
  - Allowed values: `unknown`, `android_sdk`, `node_js_sdk`, `react_native_sdk`, `react_sdk`, `js_sdk`, `python_sdk`, `widget`, `sip_trunk`, `twilio`, `exotel`, `genesys`, `avaya`, `audiocodes`, `swift_sdk`, `whatsapp`, `twilio_sms`, `flutter_sdk`, `zendesk_integration`, `slack_integration`, `telegram_integration`, `intercom_integration`, `freshdesk_integration`, `salesforce_integration`, `template_preview`, `genesys_bot_connector`, `subagent_tool`
- `version` (string, optional, nullable) — SDK 버전 번호

### TwilioMachineDetectionConfig

통화에서 Twilio의 통신사 수준 자동응답기 감지(AMD)를 실행하는 방식입니다.

- `mode` (enum, optional, default: enable) — 감지 수준을 설정합니다. `enable`은 Twilio가 사람과 기계를 구분할 수 있는 즉시 판정을 반환합니다. `detect_message_end`는 음성 사서함 인사말이 끝날 때까지도 기다리며, 이때 `machine_end_*` 판정이 생성되지만 결과 반환은 더 늦어집니다.
  - Allowed values: `enable`, `detect_message_end`
- `actions` (list of TwilioMachineDetectionRule, optional) — AMD 판정별로 통화에서 수행할 작업입니다. 각 작업은 최대 하나의 규칙에만 포함될 수 있으므로, 해당 작업의 모든 판정을 함께 나열하세요. 규칙이 없는 판정에서는 통화가 계속 진행됩니다.

### SubmitWhatsAppTemplateRef

전송할 승인된 Meta 템플릿의 이름입니다. 서버가 템플릿을 직접 로드하므로 클라이언트는 구성 요소를 제공하지 않습니다.

- `name` (string, required)
- `language` (string, required) — `en_US`와 같은 템플릿의 언어 코드입니다.

### CallingIntervalPolicy

- `start` (string, required) — 현지 시작 시간으로, 형식은 `HH:MM`입니다.
- `end` (string, required) — 현지 종료 시간으로, 형식은 `HH:MM`입니다. `24:00`은 자정에 종료됨을 의미합니다.

### PhoneVoiceConfig-Output

- `ringing_timeout_secs` (integer, optional, default: 60) — 포기하기 전에 수신자에게 벨을 울릴 시간(초)입니다. 제공업체 자체 제한도 적용됩니다.
- `twilio_call_recording_enabled` (boolean, optional, default: false) — Twilio 통화 녹음을 사용해 통화를 녹음할지 여부입니다. Twilio 이외의 제공업체에서는 무시됩니다. 녹음은 Twilio 계정에 저장됩니다.
- `twilio_machine_detection` (TwilioMachineDetectionConfig, optional, nullable) — Twilio의 통신사 수준 자동 응답기 감지(AMD)를 위한 구성입니다. 비활성화하려면 생략하거나 null로 설정하세요. Twilio 이외의 제공업체 및 수신 통화에서는 무시됩니다. 결과 판정은 별도의 `answering_machine_detection` 웹훅 이벤트로 전달되며, 이 이벤트는 워크스페이스 또는 에이전트 웹훅 설정에서 활성화해야 합니다. 이는 대화 또는 통화 후 웹훅의 일부가 아닙니다. 감지는 비동기적으로 실행되므로 대화 시작을 지연시키지 않으며, 판정은 통화 중 언제든지 도착할 수 있습니다. `detect_message_end`를 사용하면 통화가 종료된 후에도 도착할 수 있습니다. Twilio는 AMD에 대해 별도로 요금을 청구합니다.
- `mode` ("voice", optional, default: voice)

### WhatsAppChannelConfigModeConfig

- `mode`: `message` (WhatsAppMessageConfig)
  - `template` (WhatsAppTemplate, required) — 제출 시 승인된 상태의 Meta 템플릿입니다.
- `mode`: `voice` (WhatsAppVoiceConfig)
  - `whatsapp_call_permission_request_template_language_code` (string, required) — 해당 템플릿의 언어 코드입니다.
  - `whatsapp_call_permission_request_template_name` (string, required) — 연락처에 통화 허가를 요청하는 승인된 템플릿입니다.

### CallingPeriodPolicy

- `weekdays` (list of integer, required)
- `intervals` (list of CallingIntervalPolicy, required) — 각 요일의 시간대입니다. 어떤 요일에서도 서로 겹칠 수 없습니다.

### DataCollectionPolicy

- `callback_time` (string, optional, nullable)
- `redirect_phone_number` (string, optional, nullable)
- `stop` (string, optional, nullable)
- `mappings` (map from string to string, optional) — 이후 통화에 사용할 수 있도록 데이터 수집 결과를 동적 변수에 복사합니다. 각 키는 데이터 수집 항목 ID이고 값은 변수 이름입니다.

### RecipientDeliveryCounts

- `sent` (integer, optional, default: 0)
- `delivered` (integer, optional, default: 0)
- `read` (integer, optional, default: 0)
- `replied` (integer, optional, default: 0)
- `failed` (integer, optional, default: 0)

### ASRConversationalConfigOverride

- `keywords` (list of string, optional, nullable) — 예측 확률을 높일 키워드

### TurnConfigOverride

- `soft_timeout_config` (SoftTimeoutConfigOverride, optional, nullable) — 소프트 타임아웃 기능을 위한 구성입니다. 긴 LLM 응답 중 즉각적인 피드백을 제공합니다.
- `noisy_environment_message` (string, optional, nullable) — 에이전트가 시끄러운 환경을 감지했을 때 말하는 내용입니다.

### TTSConversationalConfigOverride

- `model_id` (enum, optional, nullable, default: eleven_v4_turbo) — TTS에 사용할 모델입니다.
  - Allowed values: `eleven_turbo_v2`, `eleven_turbo_v2_5`, `eleven_flash_v2`, `eleven_flash_v2_5`, `eleven_multilingual_v2`, `eleven_v3_conversational`, `eleven_v4`, `eleven_v4_turbo`
- `voice_id` (string, optional, nullable) — TTS에 사용할 음성 ID
- `supported_voices` (list of SupportedVoice, optional, nullable) — 에이전트에서 추가로 지원하는 음성
- `stability` (double, optional, nullable) — 생성된 음성의 안정성
- `speed` (double, optional, nullable) — 생성된 음성의 속도
- `similarity_boost` (double, optional, nullable) — 생성된 음성의 유사성 부스트
- `pronunciation_dictionary_locators` (list of PydanticPronunciationDictionaryVersionLocator, optional, nullable) — 발음 사전 로케이터

### ConversationConfigOverride

- `text_only` (boolean, optional, nullable) — 활성화하면 오디오는 처리하지 않고 텍스트만 사용합니다. 오디오 요금을 피하는 데 사용하세요.
- `max_duration_seconds` (integer, optional, nullable) — 대화의 최대 지속 시간(초)입니다.

### AgentConfigOverride-Input

- `first_message` (string, optional, nullable) — 비어 있지 않은 경우 에이전트가 처음으로 말할 메시지입니다. 비어 있으면 에이전트는 사용자가 대화를 시작할 때까지 기다립니다.
- `language` (string, optional, nullable) — 에이전트 언어 - ASR 및 TTS에 사용
- `max_conversation_duration_message` (string, optional, nullable) — 비어 있지 않은 경우 최대 대화 시간에 도달했을 때 에이전트가 보낼 메시지입니다.
- `prompt` (PromptAgentAPIModelOverride-Input, optional, nullable) — 에이전트용 프롬프트

### TwilioMachineDetectionRule

지정된 AMD 판정에 따라 진행 중인 통화에서 수행할 작업입니다.

- `action` (enum, required)
  - Allowed values: `hang_up`
- `answered_by` (list of enum, required) — 작업을 트리거하는 판정입니다.
  - Allowed values: `human`, `fax`, `unknown`, `machine_start`, `machine_end_beep`, `machine_end_silence`, `machine_end_other`

### WhatsAppTemplate

- `name` (string, required)
- `language` (string, required) — https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/supported-languages
- `components` (list of WhatsAppTemplateComponent, required)
- `parameter_format` (enum, optional, default: POSITIONAL)
  - Allowed values: `POSITIONAL`, `NAMED`
- `category` (string, optional, nullable) — https://developers.facebook.com/docs/graph-api/reference/whats-app-business-account/message_templates/

### SoftTimeoutConfigOverride

- `message` (string, optional, nullable) — LLM 응답을 기다리는 동안 첫 번째 소프트 타임아웃에 도달했을 때 표시할 메시지입니다. 동적 변수(예: \{\{system\_\_time}}, \{\{custom\_variable}})를 지원합니다.
- `additional_soft_timeout_messages` (list of string, optional, nullable) — 동일한 LLM 생성에서 후속 소프트 타임아웃에 사용할 추가 정적 채움 메시지입니다. 첫 번째 타임아웃에는 `message`가 사용됩니다. 구성된 메시지 수가 `max_soft_timeouts_per_generation`보다 적으면 마지막으로 구성된 메시지가 반복되고, 그렇지 않으면 내장 채움 메시지가 사용됩니다.

### SupportedVoice

- `label` (string, required)
- `voice_id` (string, required)
- `description` (string, optional, nullable)
- `language` (string, optional, nullable)
- `model_family` (enum, optional, nullable)
  - Allowed values: `turbo`, `flash`, `multilingual`, `v3_conversational`, `v4`, `v4_turbo`
- `optimize_streaming_latency` (enum, optional, nullable)
  - Allowed values: `0`, `1`, `2`, `3`, `4`
- `stability` (double, optional, nullable)
- `speed` (double, optional, nullable)
- `similarity_boost` (double, optional, nullable)

### PydanticPronunciationDictionaryVersionLocator

다른 문서에서 특정 사전과 해당 버전을 참조할 수 있도록 하는 로케이터입니다. PronunciationDictionaryVersionLocatorDBModel의 pydantic 버전입니다. 다른 에이전트 데이터 모델과의 호환성을 보장하기 위해 필요합니다.

- `pronunciation_dictionary_id` (string, required) — 발음 사전의 ID
- `version_id` (string, required, nullable) — 발음 사전 버전의 ID

### PromptAgentAPIModelOverride-Input

- `prompt` (string, optional, nullable) — 에이전트용 프롬프트
- `llm` (enum, optional, nullable) — 프롬프트와 채팅 기록으로 쿼리할 LLM입니다. 데이터 레지던시를 사용하는 경우 해당 데이터 레지던시 환경에서 지원되는 LLM이어야 합니다.
  - Allowed values: `gpt-4o-mini`, `gpt-4o`, `gpt-4`, `gpt-4-turbo`, `gpt-4.1`, `gpt-4.1-mini`, `gpt-4.1-nano`, `gpt-5`, `gpt-5.1`, `gpt-5.2`, `gpt-5.2-chat-latest`, `gpt-5.4`, `gpt-5.4-mini`, `gpt-5.4-nano`, `gpt-5.5`, `gpt-5.6-sol`, `gpt-5.6-terra`, `gpt-5.6-luna`, `gpt-6-astra`, `gpt-6-sol`, `gpt-6-luna`, `gpt-6.1-sol`, `gpt-6.1-terra`, `gpt-5-mini`, `gpt-5-nano`, `gpt-3.5-turbo`, `gemini-1.5-pro`, `gemini-1.5-flash`, `gemini-2.0-flash`, `gemini-2.0-flash-lite`, `gemini-2.5-flash-lite`, `gemini-2.5-flash`, `gemini-3-pro-preview`, `gemini-3-flash-preview`, `gemini-3.1-pro-preview`, `gemini-3.1-flash-lite-preview`, `gemini-3.1-flash-lite`, `gemini-3.5-flash`, `gemini-3.5-flash-lite`, `gemini-3.6-flash`, `gemini-3.7-flash`, `gemini-3.8-flash`, `gemini-4-argon`, `claude-sonnet-4-5`, `claude-opus-4-6`, `claude-opus-4-7`, `claude-opus-4-8`, `claude-opus-5`, `claude-opus-5-5`, `claude-sonnet-4-6`, `claude-sonnet-5`, `claude-sonnet-5-5`, `claude-sonnet-4`, `claude-haiku-4-5`, `claude-haiku-5-5`, `claude-3-7-sonnet`, `claude-3-5-sonnet`, `claude-3-5-sonnet-v1`, `claude-3-haiku`, `grok-beta`, `custom-llm`, `qwen3-4b`, `qwen3-30b-a3b`, `qwen36-35b-a3b`, `qwen35-397b-a17b`, `gpt-oss-20b`, `gpt-oss-120b`, `glm-45-air-fp8`, `glm-52`, `deepseek-v41-flash`, `nemotron-35-super-vl-nvfp4`, `gemini-2.5-flash-preview-09-2025`, `gemini-2.5-flash-lite-preview-09-2025`, `gemini-2.5-flash-preview-05-20`, `gemini-2.5-flash-preview-04-17`, `gemini-2.5-flash-lite-preview-06-17`, `gemini-2.0-flash-lite-001`, `gemini-2.0-flash-001`, `gemini-1.5-flash-002`, `gemini-1.5-flash-001`, `gemini-1.5-pro-002`, `gemini-1.5-pro-001`, `claude-sonnet-4@20250514`, `claude-sonnet-4-5@20250929`, `claude-haiku-4-5@20251001`, `claude-3-7-sonnet@20250219`, `claude-3-5-sonnet@20240620`, `claude-3-5-sonnet-v2@20241022`, `claude-3-haiku@20240307`, `gpt-5-2025-08-07`, `gpt-5.1-2025-11-13`, `gpt-5.2-2025-12-11`, `gpt-5.4-2026-03-05`, `gpt-5.4-mini-2026-03-17`, `gpt-5.4-nano-2026-03-17`, `gpt-5.5-2026-04-23`, `gpt-5-mini-2025-08-07`, `gpt-5-nano-2025-08-07`, `gpt-4.1-2025-04-14`, `gpt-4.1-mini-2025-04-14`, `gpt-4.1-nano-2025-04-14`, `gpt-4o-mini-2024-07-18`, `gpt-4o-2024-11-20`, `gpt-4o-2024-08-06`, `gpt-4o-2024-05-13`, `gpt-4-0613`, `gpt-4-0314`, `gpt-4-turbo-2024-04-09`, `gpt-3.5-turbo-0125`, `gpt-3.5-turbo-1106`, `watt-tool-8b`, `watt-tool-70b`
- `tool_ids` (list of string, optional, nullable) — 에이전트가 사용하는 도구 ID 목록입니다.
- `tool_ids_strict` (boolean, optional, nullable) — 대화 재정의로만 적용되며, tool_ids를 재정의할 수 있는 경우에만 허용됩니다. true이면 재정의된 tool_ids는 워크플로 노드의 도구를 포함하여 대화에서 허용되는 전체 도구 목록입니다. 에이전트에 설정하면 무시됩니다.
- `native_mcp_server_ids` (list of string, optional, nullable) — 에이전트가 사용할 네이티브 MCP 서버 ID 목록
- `knowledge_base` (list of KnowledgeBaseLocator, optional, nullable) — 에이전트가 사용할 지식 베이스 목록

### WhatsAppTemplateComponent

- `type` (string, required)
- `format` (string, optional, nullable)
- `text` (string, optional, nullable)
- `buttons` (list of WhatsAppTemplateComponentButton, optional, nullable)

### KnowledgeBaseLocator

- `type` (enum, required) — 지식 베이스 유형
  - Allowed values: `file`, `url`, `text`, `folder`
- `name` (string, required) — 지식 베이스 이름입니다.
- `id` (string, required) — 지식 베이스의 ID
- `usage_mode` (enum, optional, default: auto) — 지식 베이스의 사용 모드
  - Allowed values: `prompt`, `auto`

### WhatsAppTemplateComponentButton

- `type` (string, required)
- `text` (string, optional, nullable)
- `url` (string, optional, nullable)

## Examples

**Request**

```json
{
  "call_name": "string",
  "agent_id": "string",
  "recipients": [
    {}
  ],
  "channel_config": {
    "agent_phone_number_id": "string"
  }
}
```

**Response**

```json
{
  "campaign": {
    "campaign_id": "string",
    "call_name": "string",
    "agent_id": "string",
    "channel_config": {
      "channel": "phone",
      "agent_phone_number_id": "string",
      "mode_config": {
        "ringing_timeout_secs": 60,
        "twilio_call_recording_enabled": false,
        "twilio_machine_detection": {
          "mode": "enable",
          "actions": [
            {
              "action": "hang_up",
              "answered_by": [
                "human"
              ]
            }
          ]
        },
        "mode": "voice"
      }
    },
    "status": "active",
    "policy": {
      "timezone": "string",
      "retry": {
        "retry_delay_seconds": 600,
        "max_short_retries": 1,
        "max_total_calls": 6,
        "max_callbacks": 2,
        "max_redirects": 2,
        "interval_placement": "start",
        "rotate_step_seconds": 900,
        "max_consecutive_failures_per_number": 1
      },
      "calling_periods": [
        {
          "weekdays": [
            1
          ],
          "intervals": [
            {
              "start": "string",
              "end": "string"
            }
          ]
        }
      ],
      "data_collection": {
        "callback_time": "string",
        "redirect_phone_number": "string",
        "stop": "string",
        "mappings": {}
      },
      "followup_context": {
        "call_type": true,
        "previous_conversation_id": true,
        "previous_summary": true,
        "previous_transcript": true
      }
    },
    "variant": "simple",
    "source": "ui",
    "outcome": {
      "type": "evaluation_criteria",
      "criteria_id": "string"
    },
    "created_at_unix": 1,
    "scheduled_time_unix": 1,
    "updated_at_unix": 1,
    "branch_id": "string",
    "environment": "string",
    "target_concurrency_limit": 1,
    "channel": "phone",
    "mode": "voice",
    "counts": {
      "leads": 1,
      "terminal_leads": 1,
      "open_attention": 1,
      "delivery": {
        "sent": 0,
        "delivered": 0,
        "read": 0,
        "replied": 0,
        "failed": 0
      }
    },
    "agent_name": ""
  },
  "created": true,
  "within_calling_window": true
}
```

**SDK Code**

```python
import requests

url = "https://api.elevenlabs.io/v1/convai/outbound-campaigns/campaigns/submit"

payload = {
    "call_name": "string",
    "agent_id": "string",
    "recipients": [{}],
    "channel_config": { "agent_phone_number_id": "string" }
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.json())
```

```javascript
const url = 'https://api.elevenlabs.io/v1/convai/outbound-campaigns/campaigns/submit';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: '{"call_name":"string","agent_id":"string","recipients":[{}],"channel_config":{"agent_phone_number_id":"string"}}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.elevenlabs.io/v1/convai/outbound-campaigns/campaigns/submit"

	payload := strings.NewReader("{\n  \"call_name\": \"string\",\n  \"agent_id\": \"string\",\n  \"recipients\": [\n    {}\n  ],\n  \"channel_config\": {\n    \"agent_phone_number_id\": \"string\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.elevenlabs.io/v1/convai/outbound-campaigns/campaigns/submit")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"call_name\": \"string\",\n  \"agent_id\": \"string\",\n  \"recipients\": [\n    {}\n  ],\n  \"channel_config\": {\n    \"agent_phone_number_id\": \"string\"\n  }\n}"

response = http.request(request)
puts response.read_body
```

```java
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.post("https://api.elevenlabs.io/v1/convai/outbound-campaigns/campaigns/submit")
  .header("Content-Type", "application/json")
  .body("{\n  \"call_name\": \"string\",\n  \"agent_id\": \"string\",\n  \"recipients\": [\n    {}\n  ],\n  \"channel_config\": {\n    \"agent_phone_number_id\": \"string\"\n  }\n}")
  .asString();
```

```php
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api.elevenlabs.io/v1/convai/outbound-campaigns/campaigns/submit', [
  'body' => '{
  "call_name": "string",
  "agent_id": "string",
  "recipients": [
    {}
  ],
  "channel_config": {
    "agent_phone_number_id": "string"
  }
}',
  'headers' => [
    'Content-Type' => 'application/json',
  ],
]);

echo $response->getBody();
```

```csharp
using RestSharp;

var client = new RestClient("https://api.elevenlabs.io/v1/convai/outbound-campaigns/campaigns/submit");
var request = new RestRequest(Method.POST);
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "{\n  \"call_name\": \"string\",\n  \"agent_id\": \"string\",\n  \"recipients\": [\n    {}\n  ],\n  \"channel_config\": {\n    \"agent_phone_number_id\": \"string\"\n  }\n}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
```

```swift
import Foundation

let headers = ["Content-Type": "application/json"]
let parameters = [
  "call_name": "string",
  "agent_id": "string",
  "recipients": [[]],
  "channel_config": ["agent_phone_number_id": "string"]
] as [String : Any]

let postData = JSONSerialization.data(withJSONObject: parameters, options: [])

let request = NSMutableURLRequest(url: NSURL(string: "https://api.elevenlabs.io/v1/convai/outbound-campaigns/campaigns/submit")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "POST"
request.allHTTPHeaderFields = headers
request.httpBody = postData as Data

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```