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

# Preparar a planilha do envio em massa

> Quais colunas a planilha do envio em lote precisa ter, como o Pombo reconhece os nomes das colunas, os formatos e limites aceitos, e como evitar linhas recusadas.

O envio em massa lê uma planilha e cria uma notificação por linha. Esta página é a referência do
arquivo: se ele estiver certo, o resto do envio é só conferir e confirmar.

<Tip>
  **Não monte a planilha do zero.** No passo **Arquivo** do envio em lote há o link
  **Baixe o modelo**: ele gera um `.xlsx` já com as colunas certas para o canal e o modelo que
  você escolheu, incluindo uma coluna por variável. É o caminho mais rápido e o que erra menos.
</Tip>

## Formato e tamanho

| Item          | Regra                                        |
| ------------- | -------------------------------------------- |
| Formatos      | **CSV** ou **XLSX**                          |
| Tamanho       | até **10 MB**                                |
| Planilha lida | apenas a **primeira aba** do arquivo         |
| Cabeçalho     | a **primeira linha** precisa ser o cabeçalho |

<Warning>
  Só a primeira aba é lida. Se você organiza seus dados em várias abas, mova para a primeira a que
  vai ser enviada.
</Warning>

## Colunas obrigatórias

Dependem do canal.

<Tabs>
  <Tab title="WhatsApp">
    | Coluna            | Obrigatória |
    | ----------------- | ----------- |
    | **Nome completo** | Sim         |
    | **Telefone**      | Sim         |
    | **CPF / CNPJ**    | Sim         |
  </Tab>

  <Tab title="E-mail">
    | Coluna            | Obrigatória |
    | ----------------- | ----------- |
    | **Nome completo** | Sim         |
    | **E-mail**        | Sim         |
  </Tab>
</Tabs>

Além dessas, o arquivo precisa de **uma coluna para cada variável do modelo** que você escolher.
Se o modelo tem `valor` e `data_vencimento`, a planilha precisa dessas duas colunas.

Colunas a mais não incomodam: no mapeamento você marca **Ignorar esta coluna**.

## Como o Pombo reconhece as colunas

O reconhecimento é tolerante: maiúsculas, acentos, espaços, hífens e sublinhados são ignorados, e
apelidos comuns funcionam: `celular`, `whatsapp` e `phone` valem como telefone, `documento` e
`cpf/cnpj` valem como documento.

Se algo não for reconhecido, o passo de mapeamento diz exatamente qual campo precisa de escolha
manual, e você seleciona a coluna na lista **sem alterar o arquivo**.

## Como preencher cada campo

### Telefone

Aceita o formato internacional (`+5511999998888`) ou um número brasileiro comum. Precisa ter
entre 7 e 15 dígitos.

<Note>
  Inclua o **DDD**. Um número sem DDD não identifica ninguém, e é a causa mais comum de linha
  recusada.
</Note>

### CPF / CNPJ

11 dígitos para CPF, 14 para CNPJ. Pode escrever com pontos e barras: o Pombo limpa a
formatação. Os dígitos verificadores são conferidos, então um número digitado errado é recusado
ali mesmo, antes do envio.

<Warning>
  Cuidado com o Excel: ele costuma **apagar o zero inicial** de CPFs e transformar documentos
  longos em notação científica. Formate a coluna como **Texto** antes de colar os dados.
</Warning>

### Nome e e-mail

O **nome** é qualquer texto não vazio, mas aparece na notificação e no laudo, então vale a grafia
correta. O **e-mail** precisa ser um endereço válido: no canal e-mail, é ele que define para onde a
notificação vai.

## O que faz uma linha ser recusada

Cada linha é validada individualmente. Recusas mais comuns:

| Mensagem                                                    | O que corrigir                              |
| ----------------------------------------------------------- | ------------------------------------------- |
| *Nome do destinatário é obrigatório.*                       | Célula de nome vazia                        |
| *Documento é obrigatório.*                                  | CPF/CNPJ vazio (WhatsApp)                   |
| *Documento deve ter 11 dígitos (CPF) ou 14 dígitos (CNPJ).* | Dígitos faltando ou sobrando                |
| *CPF inválido* / *CNPJ inválido*                            | Número não passa na conferência dos dígitos |
| *Número de telefone é obrigatório.*                         | Telefone vazio                              |
| *Formato de telefone não reconhecido.*                      | Falta DDD, ou há caracteres estranhos       |
| *E-mail é obrigatório.* / *E-mail inválido.*                | Endereço vazio ou malformado                |

<Note>
  **Linhas com erro não impedem o envio.** O Pombo mostra quantas são, permite ver os erros, e
  envia normalmente as linhas válidas. As recusadas são simplesmente ignoradas. Só não é possível
  seguir quando **nenhuma** linha é válida.
</Note>

## Corrigir e reenviar

Não há edição linha a linha na tela, e não é possível trocar o arquivo dentro do mesmo envio. Se
houver muitas linhas com erro, o caminho é **corrigir a planilha no seu computador** e usar
**Começar novamente**.

<Tip>
  Faça um teste com 3 ou 4 linhas antes de subir a planilha inteira. Você descobre um problema de
  formatação gastando 3 envios em vez de descobrir com 2 000 linhas recusadas.
</Tip>

<Card title="Planilha pronta? Rodar o lote" icon="send" href="/envios/envio-em-massa">
  Os seis passos, do arquivo à confirmação.
</Card>