Skip to main content
Uma campanha na aba Campaigns (Audience & campaigns) é um registro reutilizável: você escolhe template, canais (WhatsApp, SMS e/ou e-mail, conforme disponível), público (segmento salvo ou lista de IDs de contato) e dispara com Run. Não é um motor paralelo: ao rodar, entra no mesmo pipeline de filas e cobrança que envios pela API. Tópicos e consentimento: Tópicos de comunicação.
Público por regras: Segmentos na audiência. Artigos no blog (recomendado):

​
Pré-requisitos

  • Pelo menos um template criado e adequado aos canais que você vai marcar.
  • Para WhatsApp: instância configurada e válida.
  • Para e-mail: domínio verificado (remetente ou padrão do workspace).
  • Créditos / plano ativos — o Run checa antes de marcar execução.

​
Criar a campanha

  1. Audience & campaigns → Campaigns → New campaign.
  2. Preencha:
    • Nome interno.
    • Template (categoria marketing vs transacional importa para consentimento).
    • Canais marcados para esse disparo (cada canal exige conteúdo preenchido no template).
    • Audiência:
      • Segment: escolhe um segmento salvo; na hora do Run o backend reavalia o JSON do segmento e busca contatos do workspace (há um teto alto por execução, ordem de dezenas de milhares).
      • Contact IDs: cole CUIDs separados por vírgula ou espaço.
    • Opcional: instância WhatsApp, remetente de e-mail, variáveis extras (JSON).
Para cada canal, só entram destinatários com dado compatível: telefone para WhatsApp/SMS, e-mail para e-mail.

​
Consentimento de marketing e tópicos

Templates de marketing passam pelo mesmo filtro que envios avulsos:
  • O contato precisa aceitar marketing em geral.
  • Se o template estiver vinculado a um tópico, a pessoa precisa estar inscrita naquele tópico (ou aplicar o padrão do workspace, conforme produto).
Quem não passa não recebe naquela rodada — em geral sem erro por contato; a lista efetiva fica menor.

​
Variáveis globais (JSON opcional)

Objeto mesclado por cima das variáveis do contato (nome, e-mail, telefone, propriedades). Útil para cupom único ou texto igual para todos: 
{
  "discount": "10",
  "campaign_name": "abril_2026"
}
Antes de enfileirar, o sistema valida placeholders obrigatórios do template por destinatário. Se faltar variável para alguém, o Run pode falhar com mensagem indicando destinatário e campos faltando — padronize propriedades no cadastro ou use defaults no template. Para marketing, se o template estiver configurado para link de preferências, o sistema pode gerar token por contato e preencher preferences_link no merge — veja Tópicos de comunicação.

​
O botão Run e o status

  • Run dispara na hora (sem agendamento interno da campanha para essa ação, conforme comportamento atual do produto).
  • Status típicos: RUNNING → COMPLETED ou FAILED com mensagem resumida.
  • Enquanto RUNNING, em geral não é possível editar ou apagar a campanha.
Outras travas podem aplicar-se: limites de tamanho de e-mail/SMS, validação de conteúdo SMS, proteção contra duplicidade recente, fila cheia no canal, etc. — detalhes no artigo do blog sobre campanhas.

​
Checklist rápido antes do disparo

  1. Preview do segmento (se usar segmento) — total e amostra fazem sentido?
  2. Disparo teste com poucos IDs antes da base grande.
  3. Template na categoria certa (marketing vs transacional).
  4. Cada canal marcado tem corpo/assunto preenchidos no template.
  5. Instância WhatsApp e domínio e-mail OK.
  6. Créditos e monitoramento pós-Run.

​
Integração via API

O painel e a API compartilham o mesmo núcleo de envio. Para automações e payloads, veja Introdução e Quick Start.

​
Artigos relacionados no blog