> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pombo.digital/llms.txt
> Use this file to discover all available pages before exploring further.

# Enviar em massa por planilha

> Como enviar centenas de notificações de uma vez a partir de uma planilha: os seis passos do envio em lote, o que acontece ao confirmar e como acompanhar o resultado.

O **envio em massa** cria uma notificação por linha da sua planilha, cada uma com seu próprio
laudo. No painel ele aparece como **Envios em Massa**.

<Warning>
  **Só o proprietário da conta tem acesso ao envio em massa**: para admins e membros o item nem
  aparece no menu. Veja [Equipe e permissões](/conta/equipe-e-permissoes).
</Warning>

## Antes de começar

* A **planilha** pronta. Veja [Preparar a planilha](/envios/preparar-planilha).
* **Envios suficientes** para todas as linhas válidas. O saldo é conferido antes da confirmação.
* Os **dados do remetente** preenchidos, como em qualquer envio.
* Um modelo de **texto puro**: o lote [não aceita anexos](/envios/anexos).

## Os seis passos

O envio em lote é um assistente com seis etapas: **Canal**, **Modelo**, **Arquivo**,
**Mapeamento**, **Revisão** e **Confirmar**.

<Steps>
  <Step title="Canal">
    **Como quer enviar este lote?** WhatsApp ou e-mail, para todo o lote.

    Trocar o canal depois **reinicia o assistente**, então escolha com o arquivo em mente.
  </Step>

  <Step title="Modelo">
    Aparecem só os modelos aprovados de texto puro do canal escolhido, separados em
    **Seus modelos** e **Modelos pré-aprovados**. Clicar em um modelo já avança.
  </Step>

  <Step title="Arquivo">
    Arraste o CSV ou XLSX, ou clique para selecionar. Se ainda não tem o arquivo, use
    **Baixe o modelo**: ele já vem com as colunas certas para este canal e este modelo.
  </Step>

  <Step title="Mapeamento">
    O Pombo tenta ligar cada coluna do seu arquivo ao campo correspondente, e mostra dados reais
    da sua planilha para você conferir. Colunas reconhecidas automaticamente aparecem em verde.

    O que ele não reconhecer, você escolhe na lista. Não é possível avançar com um campo
    obrigatório sem coluna.
  </Step>

  <Step title="Revisão">
    Aqui você vê os números: **Total**, **Válidos** e **Com erros**.

    Se houver linhas com erro, um aviso mostra quantas são e o que há de errado em cada uma. As
    linhas válidas seguem normalmente; as recusadas são ignoradas.
  </Step>

  <Step title="Confirmar">
    A última tela mostra **Total de envios**, o modelo, o canal e o seu saldo, inclusive
    **Saldo após este lote**. Se faltar saldo, ela diz quantos envios faltam e oferece
    **Comprar envios**; você pode comprar e voltar para continuar.

    Clique em **Confirmar e Enviar** e confirme na janela.
  </Step>
</Steps>

## O ponto sem volta

<Warning>
  **Depois de confirmar, o envio começa imediatamente e não pode ser cancelado.** Não há botão de
  parada, nem para o proprietário. Confira os números na Revisão antes de confirmar: é a última
  oportunidade.
</Warning>

O que acontece no instante da confirmação: o saldo correspondente às linhas válidas é reservado, o
lote passa a **Enviando**, e as mensagens começam a sair.

## Acompanhar o lote

A tela do lote se atualiza sozinha durante o envio, mostrando quantas de quantas já saíram.

| Situação               | O que significa                                  |
| ---------------------- | ------------------------------------------------ |
| **Importando**         | O arquivo está sendo lido e validado             |
| **Pronto para enviar** | Validado, esperando sua confirmação              |
| **Enviando**           | As mensagens estão saindo                        |
| **Concluído**          | Terminou                                         |
| **Falhou**             | O lote não pôde ser processado                   |
| **Cancelado**          | Não foi disparado                                |
| **Expirado**           | Ficou 72 horas sem confirmação; nada foi enviado |

<Warning>
  Atenção a uma ambiguidade da tela: um lote que terminou **com falhas** também mostra a etiqueta
  **Concluído**. Para saber se houve falhas, olhe o cartão **Resultado do envio** (ele separa
  **Enviados**, **Entregues** e **Falhas**), ou baixe o relatório.
</Warning>

## O relatório do lote

Quando o lote termina, aparece **Baixar relatório**: uma planilha com uma linha por destinatário,
trazendo telefone, nome, documento, as variáveis preenchidas, situação do envio, situação da
entrega, **motivo do erro** e as datas de cada etapa, além do código de cada notificação.

É por aí que você descobre exatamente quais destinatários falharam e por quê.

<Note>
  O arquivo é salvo com a extensão `.xlsx`, mas o conteúdo é **CSV**. Se o Excel reclamar ao
  abrir, ou se as colunas aparecerem todas juntas, renomeie o arquivo para `.csv` e abra de novo.
</Note>

## Se algo der errado

<AccordionGroup>
  <Accordion title="Nenhuma linha válida">
    O aviso *"Nenhuma linha válida. Corrija o arquivo e comece novamente."* significa que todas as
    linhas foram recusadas, geralmente um problema de formato que atinge a coluna inteira. Veja
    [Preparar a planilha](/envios/preparar-planilha).
  </Accordion>

  <Accordion title="Saldo insuficiente">
    A tela informa quantos envios faltam. Compre e volte para a mesma tela: o lote continua ali
    esperando, desde que dentro do prazo de 72 horas.
  </Accordion>

  <Accordion title="Algumas linhas falharam no envio, não na validação">
    São falhas de entrega, não de arquivo: número que não existe no WhatsApp, endereço inválido.
    O relatório traz o motivo de cada uma. Veja [Status de entrega](/envios/status-de-entrega).
  </Accordion>

  <Accordion title="Uma linha falhou por conflito de telefone">
    Se o telefone da planilha já está cadastrado em outro CPF ou CNPJ, aquela linha falha com
    *"Número de telefone já cadastrado com CPF/CNPJ diferente"*. No envio em lote esse conflito
    não pode ser resolvido na hora. Veja
    [Duplicados e conflitos](/contatos/duplicados-e-conflitos).
  </Accordion>
</AccordionGroup>

<CardGroup cols={2}>
  <Card title="Preparar a planilha" icon="table" href="/envios/preparar-planilha">
    As colunas obrigatórias e o que faz uma linha ser recusada.
  </Card>

  <Card title="Comprar envios" icon="shopping-cart" href="/conta/comprar-envios">
    Se o saldo não cobre o lote inteiro.
  </Card>
</CardGroup>
