Campanhas Finitas

O que sao Campanhas Finitas

Campanhas finitas enviam mensagens personalizadas para uma lista definida de contatos. Cada mensagem e gerada por IA com base no perfil do contato e no tema da campanha, o que significa que nenhum contato recebe um texto generico igual ao de outro.

A campanha termina automaticamente quando todos os contatos da lista sao alcancados ou quando a data-limite configurada e atingida.

Quando usar

  • Lancamento de produtos ou servicos
  • Promocoes e ofertas por tempo limitado
  • Reengajamento de leads inativos
  • Pesquisas de satisfacao (NPS)
  • Convites para eventos ou webinars
  • Comunicados direcionados a um grupo especifico de contatos

Passo a passo: Criar uma campanha

1
Acesse Campanhas no dashboard

No menu lateral do dashboard, clique em Campanhas para abrir a area de gestao de campanhas.

2
Clique em "Nova Campanha"

O botao esta no canto superior da lista de campanhas. Ele abre o assistente de criacao.

3
Defina o tipo como Finita

Selecione Campanha Finita para enviar mensagens a uma lista fechada de contatos.

4
Escolha a audiencia

Voce pode definir a audiencia de duas formas:

  • Por telefones: cole uma lista de numeros com DDI (ex: 5511999999999).
  • Por tag: selecione uma tag e todos os contatos com essa tag entram automaticamente na audiencia.
5
Selecione KB Topics

KB Topics sao temas do Knowledge Base que orientam o conteudo da mensagem. Escolha o topico mais relevante para que a IA gere mensagens alinhadas ao objetivo da campanha.

6
Gere as mensagens

O Dexter usa IA para criar uma mensagem personalizada para cada contato da lista. A geracao leva em conta o perfil do contato, o topico selecionado e o contexto da conversa.

7
Revise as mensagens geradas

Antes de ativar, voce pode ver todas as mensagens que serao enviadas. Edite individualmente se necessario ou gere novamente com ajustes no topico.

8
Ative a campanha

Para prevenir envios acidentais, o sistema exibe um resumo completo e pede que voce digite uma frase de confirmacao antes de iniciar o envio. A campanha so comeca apos essa confirmacao.

Audiencia

Por telefones

Cole uma lista de numeros de telefone com DDI. Cada numero deve estar no formato internacional sem espacos, tracos ou parenteses. 

5511999999999
5521988887777
5531977776666

Por tags

Selecione uma tag existente na sua base de contatos. Todos os contatos que possuem essa tag serao incluidos automaticamente na audiencia da campanha.

Preview da audiencia

Antes de ativar a campanha, o Dexter mostra um preview com a quantidade de contatos elegiveis, quantos ja possuem conversa ativa e quantos sao contatos novos. Use essa informacao para validar que a audiencia esta correta antes do envio.

KB Topics e geracao de mensagens

KB Topics sao temas cadastrados no Knowledge Base da sua instancia. Eles funcionam como contexto para a IA gerar mensagens relevantes e naturais.

  • A IA gera uma mensagem unica para cada contato, levando em conta nome, historico e contexto.
  • Cada mensagem e diferente — nao e mala direta generica com o mesmo texto para todos.
  • O topico selecionado define o tema central (ex: lancamento de produto, promocao de inverno).
Dica: quanto mais completo o Knowledge Base, melhores as mensagens geradas. Inclua informacoes sobre seus produtos, servicos, tom de voz e diferenciais.

Ativacao e confirmacao

Antes de iniciar o envio, o sistema apresenta um resumo com:

  • Quantidade total de contatos na audiencia
  • Estimativa de tempo para conclusao
  • Janelas de envio configuradas
  • Primeira mensagem como amostra

Para ativar, voce precisa digitar uma frase de confirmacao exibida na tela (ex: ATIVAR 42, onde 42 e o ID da campanha). Isso impede ativacoes acidentais.

Importante: uma vez ativada, as mensagens sao enviadas de forma automatica, respeitando os limites de envio e as janelas de horario configuradas para proteger sua conta.

Gerenciar campanha em andamento

Enquanto a campanha esta ativa, voce pode:

Acao Descricao
Adicionar contatos Inclua novos numeros ou contatos com tag a qualquer momento. Eles entram na fila de envio.
Remover contatos Remova numeros que nao devem mais receber mensagem. Contatos ja enviados nao sao afetados.
Pausar campanha Interrompa o envio temporariamente. A campanha pode ser retomada depois pelo dashboard.
Verificar status Acompanhe o progresso: quantos contatos ja receberam, quantos faltam e quantos responderam.
Pausa automatica: se a conexao com o WhatsApp cair durante uma campanha, o Dexter pausa automaticamente o envio e retoma quando a conexao for restabelecida.

Stop-on-reply

Se um contato responder enquanto a campanha esta em andamento, o envio para aquele contato e interrompido automaticamente. A conversa e direcionada para o assistente de IA ou para atendimento humano, conforme a configuracao da instancia.

Isso garante que nenhum contato receba uma mensagem de campanha depois de ja ter iniciado uma conversa real com a sua empresa.

Via MCP

Se voce utiliza o Dexter via MCP (por exemplo, pelo Cursor ou outro client MCP compativel), o fluxo completo para criar e ativar uma campanha finita e:

1
dexter_campaigns_prepare

Inicia o rascunho da campanha. Informe o nome, audiencia (telefones ou tag) e modo de geracao.

2
dexter_campaigns_kb_topics

Lista os topicos disponiveis no Knowledge Base para selecionar o tema da campanha.

3
dexter_campaigns_generate

Gera as mensagens personalizadas para cada contato com base no topico escolhido.

4
dexter_campaigns_audience_preview

Exibe um preview da audiencia: contatos elegiveis, novos e ja existentes.

5
dexter_campaigns_create

Cria o rascunho final da campanha. A campanha fica com status draft ate ser ativada.

6
dexter_campaigns_activate

Na primeira chamada, retorna o resumo e a frase de confirmacao. Na segunda chamada, envie a frase exata informada pelo sistema no campo confirmation para ativar.

Atencao: a frase de confirmacao e gerada pelo sistema (ex: ATIVAR 42). Nunca invente a frase — use exatamente o que o sistema retornar.

Exemplo de fluxo resumido:

1. dexter_campaigns_prepare     → prepara rascunho
2. dexter_campaigns_kb_topics   → lista topicos do KB
3. dexter_campaigns_generate    → gera mensagens com IA
4. dexter_campaigns_audience_preview → preview da audiencia
5. dexter_campaigns_create      → cria rascunho final
6. dexter_campaigns_activate    → ativa (requer confirmacao)

Via API REST

Voce pode criar contatos para campanha usando a API REST do Dexter. Isso e util para integracoes com CRMs, ERPs ou qualquer sistema externo.

Endpoint

POST /api/v1/leads

Headers

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Corpo da requisicao

{
  "phone": "5511999999999",
  "name": "Maria Silva",
  "definir_agente": "sdr"
}
Campo Tipo Descricao
phone string Numero com DDI (obrigatorio)
name string Nome do contato (opcional)
definir_agente string Agente que atende o contato (opcional, padrao: sdr)
message string Mensagem inicial a ser enviada (opcional)
lock_agent boolean Trava o agente atribuido, impedindo roteamento automatico (opcional)
Dica: campos adicionais enviados no corpo sao salvos como dados customizados do contato e podem ser usados pelo assistente de IA.

Erros comuns

Erro Causa Solucao
Campanha ja ativa Nao e possivel ter mais de uma campanha ativa ao mesmo tempo na mesma instancia. Aguarde a campanha atual finalizar ou pause-a antes de ativar outra.
Contato ja na campanha O mesmo numero de telefone nao pode estar duas vezes na mesma campanha. Verifique se ha duplicatas na lista de telefones.
Mensagens nao geradas As mensagens nao foram geradas antes de tentar ativar a campanha. Selecione um KB Topic e clique em gerar mensagens antes de ativar.
Frase de confirmacao incorreta A frase digitada nao corresponde a frase exibida pelo sistema. Digite exatamente a frase mostrada na tela de confirmacao.

Limites

  • Rate limit: as mensagens sao enviadas com intervalos entre cada envio, respeitando limites que protegem sua conta e garantem entregas confiaveis.
  • Janela de envio: campanhas respeitam o horario comercial configurado na sua instancia. Mensagens so sao enviadas dentro das janelas permitidas.
  • Limite diario: existe um teto de novos contatos acionados por dia para manter a saude do seu numero.
  • Plano Starter: campanhas basicas com funcionalidades essenciais.
  • Plano Professional / Scale: campanhas completas com geracao por IA, KB Topics, gestao avancada de audiencia e integracao MCP.

Links relacionados