Campanhas no painel — como funcionam e como usar

O que são campanhas

As campanhas permitem enviar a mesma mensagem (ou template aprovado no WhatsApp Business, quando aplicável) para vários destinatários de uma vez, pela integração que escolher (ex.: WhatsApp oficial, WhatsApp no número, Telegram).

O envio acontece em segundo plano: depois de criar a campanha e confirmar o disparo (ou na hora agendada), as mensagens saem sem você precisar manter a página aberta.

---

Antes de começar

1. Integração ativa (ex.: WhatsApp já conectado ou oficial configurado).
2. Template de campanha (menu Campanhas → Templates): texto e variáveis (ex.: nome, telefone) ou, para WhatsApp oficial, configuração alinhada ao template aprovado na Meta.
3. Para WhatsApp oficial, o custo por conversa/template é faturado pela Meta; o painel pode mostrar uma estimativa informativa no passo final.

---

Criar uma campanha (passo a passo)

1. Abra Campanhas → Nova campanha (ou equivalente no menu).
2. No assistente, à esquerda vê os passos; à direita preenche cada etapa:
   • Canal: escolha a integração e, se quiser, o nome da campanha.
   • Template: escolha o template guardado.
   • Público: contatos da base ou arquivo CSV (indique as colunas de telefone e, se quiser, nome).
   • Quando enviar: Agora ou Agendar data/hora.
   • Revisão: confira o resumo; para WhatsApp oficial pode indicar a categoria do template (utilidade, marketing, autenticação) para a estimativa de custo.
3. Clique em Criar campanha.

• Se escolheu agora, o sistema inicia o envio em seguida.
• Se agendou, o envio começa na data e hora definidas. Acompanhe o estado na lista de campanhas.

---

Onde ver o resultado

• Campanhas: lista e detalhe com estado (rascunho, agendada, a enviar, concluída, cancelada) e contadores de enviados/falhados.
• Conversas: cada envio bem-sucedido gera (ou reutiliza) a conversa com o contato e uma mensagem enviada com indicação de que veio de campanha — o cliente vê no mesmo histórico que o bot.

---

Cancelar

Pode cancelar uma campanha quando ainda fizer sentido para o negócio: envios ainda não tratados deixam de ser feitos; o detalhe da campanha deve refletir o estado cancelado. Destinatários que ainda estavam pendentes podem aparecer como falha com motivo de cancelamento.

---

Automação externa (n8n, CRM)

Para criar campanhas, adicionar destinatários e disparar via API (sem usar o assistente do painel), é necessário:

• plano Professional;
• chave de API da organização em Configurações da organização → Chaves de API;
• seguir a documentação API pública — organização e campanhas (/api/v1/campaigns/...).

Listas, consentimento e regras legais de contato continuam sua responsabilidade no CRM ou na automação; o OSBChat fornece o canal técnico de envio.

---

Resolução de problemas (resumo)