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

# Inicie uma Campanha Oficial

> Escolha um template aprovado, importe os contatos e revise a campanha antes de enviar pela Meta.

Com um [número conectado](https://docs.blu.direct/api-oficial/conectar-numero.md) e um [template aprovado](https://docs.blu.direct/api-oficial/criar-modelo.md), você prepara a campanha em três etapas: **Template**, **Contatos** e **Revisão**.

## 1. Escolha o número e o template

Abra [Campanhas Oficiais > Números conectados](https://blu.direct/app/official-api/chips) e clique em **Nova campanha** no card do número desejado. Confira os avisos de restrição ou bloqueio antes de prosseguir.

Em **Template**, use **Buscar template**, selecione a mensagem e clique em **Continuar**. A lista mostra apenas templates aprovados para a conta da Meta daquele número.

![Etapa Template de Nova campanha com busca e template selecionado](https://mintcdn.com/blu-direct/6E5TseMmfqhGLMyo/images/api-oficial/selecionar-modelo.jpg?fit=max\&auto=format\&n=6E5TseMmfqhGLMyo\&q=85\&s=407f6e71cea531ff5d4ea9e4a0b73576)

Se a lista estiver vazia, confirme se o template foi aprovado e se pertence à mesma conta da Meta. Templates em análise, rejeitados, pausados ou desativados não ficam disponíveis para seleção.

## 2. Importe os contatos

Em **Contatos**, baixe **Modelo CSV** ou **Modelo XLSX** para obter uma planilha com as colunas necessárias à mensagem escolhida. Preencha o arquivo e arraste-o para a área de importação ou clique para escolhê-lo.

![Etapa Contatos com área de importação e modelos CSV e XLSX](https://mintcdn.com/blu-direct/6E5TseMmfqhGLMyo/images/api-oficial/importar-contatos.jpg?fit=max\&auto=format\&n=6E5TseMmfqhGLMyo\&q=85\&s=4df726e3566ac591968735212d0deaaa)

* Use um arquivo **.csv** ou **.xlsx**, com até **10.000 contatos**.
* A primeira coluna deve conter o **número com DDI e DDD**. Use o cabeçalho `numero` e mantenha apenas os dígitos nos telefones.
* Inclua uma coluna para cada variável da mensagem, com o mesmo nome e um valor para cada contato.
* Colunas extras podem permanecer na lista e são ignoradas.
* Confira os números repetidos: a importação remove duplicatas e informa a quantidade removida.

Por exemplo, um template com `{{nome}}` e `{{pedido}}` precisa destas colunas. Os dados abaixo são apenas ilustrativos; substitua-os pelos contatos que autorizaram o envio.

```csv theme={null}
numero,nome,pedido
5511912345678,Ana,1234
5521987654321,Bruno,5678
```

Após importar, confira a quantidade e a prévia da lista. Colunas obrigatórias ausentes e variáveis vazias impedem a continuação. Corrija o arquivo e importe novamente; os contatos com valores vazios aparecem primeiro na prévia. Clique em **Continuar** quando a lista estiver pronta.

> [!NOTE]
>
> O limite de 10.000 contatos é o limite do arquivo por campanha. O limite de
> contatos que a Meta permite alcançar em 24 horas pode ser menor. Confira
> os valores e avisos apresentados para sua conta antes de iniciar.

## 3. Revise e inicie

Na etapa **Revisão**, confira:

* O template e a categoria selecionados.
* A prévia da mensagem, preenchida com os dados do primeiro contato.
* A quantidade de destinatários.
* Os avisos de saúde do número e de limite de contatos.
* O **Custo estimado**, incluindo eventuais contatos de países sem tarifa cadastrada.

A estimativa não é a cobrança final. Confira as condições e o método de pagamento no [WhatsApp Manager](https://business.facebook.com/wa/manage/); a cobrança das mensagens é feita pela Meta.

Se precisar ajustar o template ou a lista, clique em **Voltar**. Quando tudo estiver correto, clique em **Iniciar campanha**. Essa ação começa o envio e confirma que os contatos autorizaram receber mensagens daquele número. Pedidos de saída são respeitados.

> [!WARNING]
>
> Se o número estiver bloqueado pela Meta, resolva a situação no WhatsApp
> Manager antes de iniciar. Revise também restrições e avisos de limite:
> iniciar uma campanha não elimina essas condições e os envios podem falhar.

## Acompanhe o resultado

Depois de iniciada, a campanha continua mesmo se você fechar a janela. A tela mostra o progresso e os totais de **Aceitas pela Meta**, **Entregues**, **Lidas** e **Falhas**. Mensagem aceita pela Meta ainda não significa mensagem entregue.

Entregas e leituras podem chegar depois de a campanha terminar. Consulte os detalhes e acompanhe os resultados no card **Campanhas recentes** de **Campanhas Oficiais > Estatísticas**. O guia de [estatísticas e custos](https://docs.blu.direct/api-oficial/estatisticas.md) explica cada indicador, os custos na Meta e a saúde dos números. Se houver contatos que pediram para sair, a tela informa quantos não receberam a mensagem por esse motivo.

Se o início falhar, leia o erro exibido, resolva a causa indicada e tente novamente. Se a campanha terminar com erros, confira os detalhes antes de preparar outro envio para os mesmos contatos.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.