> 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.

# Chamadas em lote

> **Note**
>
> Ao realizar campanhas de chamadas de saída, garanta a conformidade com todas as regulamentações relevantes,
> incluindo a [TCPA (Lei de Proteção ao Consumidor por Telefone)](/docs/pt/eleven-agents/legal/tcpa) e quaisquer
> leis estaduais aplicáveis.

## Visão geral

As chamadas em lote permitem iniciar várias chamadas de saída simultaneamente usando seus agentes configurados da ElevenLabs. Esse recurso é ideal para cenários como enviar notificações, realizar pesquisas ou entregar mensagens personalizadas de forma eficiente a uma grande lista de destinatários.
Esse recurso está disponível tanto para números de telefone adicionados pela [integração nativa com o Twilio](/docs/pt/eleven-agents/phone-numbers/twilio-integration/native-integration) quanto por [SIP trunking](/docs/pt/eleven-agents/phone-numbers/sip-trunking).

### Principais recursos

* **Envio de listas de destinatários**: Envie facilmente listas de destinatários em formato CSV ou XLS.
* **Variáveis dinâmicas**: Personalize as chamadas incluindo variáveis dinâmicas (por exemplo, `user_name`) em colunas separadas na sua lista de destinatários.
* **Seleção de agente**: Escolha o agente específico da ElevenLabs que atenderá as chamadas.
* **Agendamento**: Envie lotes imediatamente ou agende-os para outro momento.
* **Monitoramento em tempo real**: Acompanhe o progresso das suas chamadas em lote, incluindo o status geral e o status de cada chamada.
* **Relatórios detalhados**: Veja detalhes completos das chamadas em lote concluídas, incluindo informações de destinatários de cada chamada.

## Concorrência

Quando as chamadas em lote são iniciadas, elas usam automaticamente o menor valor entre 50% do limite de concorrência do seu workspace e 70% do limite de concorrência do seu agente.
Isso garante que haja capacidade simultânea suficiente disponível para outras conversas, incluindo chamadas recebidas e chamadas pelo widget.

## Requisitos

* Uma conta da ElevenLabs com um [agente configurado](https://elevenlabs.io/app/agents).
* Um número de telefone importado

> **Warning**
>
> O Modo de Retenção Zero (ZRM) não pode ser ativado para chamadas em lote. Se seu caso de uso exigir ZRM,
> você precisará iniciar as chamadas individualmente, em vez de usar o recurso de chamadas em lote.

## Como criar uma chamada em lote

Siga estas etapas para criar uma nova chamada em lote:

#### Acesse Chamadas em lote

Acesse a [interface de chamadas de saída](https://elevenlabs.io/app/agents/batch-calling) pelo
dashboard do ElevenAgents

#### Inicie uma nova chamada em lote

Clique no botão "Criar uma chamada em lote". Isso abrirá a página "Criar uma chamada em lote".

![Página Criar uma chamada em lote mostrando campos para nome do lote, número de telefone, seleção de agente, envio de destinatários e opções de horário.](/docs/_fern-img/defec00e1f267346775021283bdc6038cfabcd27427dffb7cd7e5cd9382b53e0.webp)

#### Configure os detalhes do lote

* **Nome do lote**: Insira um nome descritivo para sua chamada em lote (por exemplo, "Aviso de entrega", "Notificações semanais de atualização").
* **Número de telefone**: Selecione o número de telefone que será usado para fazer as chamadas de saída.
* **Selecionar agente**: Escolha o agente pré-configurado da ElevenLabs que atenderá as conversas deste lote.

#### Envie os destinatários

* **Enviar arquivo**: Envie sua lista de destinatários. Os formatos compatíveis são CSV e XLS.
* **Formatação**:
  * A coluna `phone_number` é obrigatória no arquivo enviado (se seu agente tiver uma variável dinâmica `phone_number` que também precise ser definida, renomeie-a).
  * Você pode incluir outras colunas (por exemplo, `name`, `user_name`), que serão passadas como variáveis dinâmicas para personalizar as chamadas.
  * Há um modelo disponível para download para garantir a formatação correta.

> **Definição de substituições**
>
> Os seguintes cabeçalhos de coluna são campos especiais usados para substituir a configuração inicial
> de um agente:
>
> * language
> * first_message
> * system_prompt
> * voice_id
>
> A chamada em lote falhará se esses campos forem enviados, mas não estiverem definidos como substituíveis nas configurações de segurança do agente. Veja mais
> [aqui](/docs/pt/eleven-agents/customization/personalization/overrides).

#### Defina o horário

* **Enviar imediatamente**: A chamada em lote começará a ser processada assim que você a enviar. -
  **Agendar para mais tarde**: Escolha uma data, horário e fuso horário específicos para o início da chamada em lote.

#### Envie a chamada em lote

* Você pode fazer uma "chamada de teste" com um único destinatário antes de enviar o lote inteiro. - Clique em "Enviar
  uma chamada em lote" para finalizar e iniciar ou agendar o lote.

## Gerenciamento e monitoramento de chamadas em lote

Depois que uma chamada em lote é criada, você pode monitorar seu progresso e ver os detalhes.

### Visão geral de chamadas em lote

A página de visão geral de Chamadas em lote exibe uma lista de todas as suas chamadas em lote.

![Página de visão geral de Chamadas em lote listando várias chamadas em lote com status, contagem de destinatários e progresso.](/docs/_fern-img/a371de67085f7c63765a90dacbe2ba50b6d5cb8544cb8554233d9a39567b0994.webp)

### Visualização dos detalhes da chamada em lote

Clicar em uma chamada em lote específica na página de visão geral levará você à visualização detalhada, onde poderá ver as conversas individuais.

![Página de detalhes da chamada em lote mostrando um resumo (status, total de destinatários, início, progresso) e uma lista de destinatários com número de telefone, variáveis dinâmicas e status.](/docs/_fern-img/a9ef3ded53870849fea0c86bc9ddf9ae43ca86ba98199b988370a67d11a447ee.webp)

## Uso da API

Você também pode gerenciar e iniciar chamadas em lote programaticamente usando a API da ElevenLabs. Isso permite a integração com seus workflows e aplicativos existentes.

* [Listar chamadas em lote](/docs/pt/api-reference/batch-calling/list) - Recupere todas as chamadas em lote no seu workspace
* [Criar chamada em lote](/docs/pt/api-reference/batch-calling/create) - Envie uma nova chamada em lote com agente, número de telefone e lista de destinatários