For AI agents: the complete documentation index is available at https://docs.clickmax.io/llms.txt, the full documentation bundle is available at https://docs.clickmax.io/llms-full.txt, and this page is available as Markdown at https://docs.clickmax.io/features/automations/run-automation.md.
  • Português
  • Como executar uma automação para um contato, lista, tag ou segmento?

    Com a automação publicada, clique em Executar manualmente, no topo do editor (ou em Executar agora, no cartão do gatilho Início manual), e escolha quem entra: Avulso (um ou mais contatos), Lista, Tag ou Segmento. A janela Executar automação tem três etapas — Quem entra, Ritmo e Quando começa — e, à direita, o Resumo da rodada, com o número de contatos que vão entrar e o botão Executar para N contatos. Cada confirmação cria uma rodada, com status e contagens próprios — a automação continua no ar e pode ser executada quantas vezes precisar.

    Isso vale para qualquer automação publicada: as que começam com Início manual (sem evento; quem entra é escolhido só na hora de executar) e também as que já começam por um evento, como Tag Aplicada ao Contato ou Compra aprovada.

    Papel: qualquer membro com acesso de edição no workspace.

    Antes de começar

    • A automação precisa estar publicada (No ar). Em rascunho ou pausada, o botão Executar agora do cartão fica desabilitado e, ao passar o mouse, diz Publique a automação para executar; o botão disponível no topo é Testar — veja a comparação em Testar × Executar.
    • Para uma automação que só deve rodar quando você mandar, escolha o gatilho Início manual (categoria Início manual) ao criar o fluxo. Ele não tem configuração: publicar só coloca a automação no ar, e nada é enviado até você clicar em Executar manualmente.
    • Para enviar mensagens, tenha o canal conectado em Mensagens.

    Passo a passo

    1. Abra a automação no editor e clique em Publicar (ou Ativar). Numa automação de Início manual, isso não dispara ninguém.

    2. Clique em Executar manualmente, no topo do editor. Numa automação de Início manual, o cartão do gatilho tem o botão Executar agora, que abre a mesma janela.

    3. Em 1 · Quem entra, escolha o cartão da origem:

      • Avulso — busque e marque um ou mais contatos, até 500 por rodada. Cada resultado e cada contato marcado mostram o nome e o telefone, para você distinguir contatos com o mesmo nome.
      • Lista — todos os contatos da lista escolhida.
      • Tag — todos os contatos que têm a tag.
      • Segmento — o segmento é recalculado naquele momento: entra quem cumpre o critério na hora de executar, não quem cumpria quando o segmento foi criado.

      Na Lista, na Tag e no Segmento, o seletor abre com o campo Buscar… no topo: digite parte do nome para achar a origem sem rolar a lista inteira. Cada opção mostra quantos contatos ela tem.

    4. Confira o funil logo abaixo da origem: Contatos em "…" (ou Contatos escolhidos), menos Passaram na última 24 horas (cooldown), igual a Vão entrar — a janela do cooldown (24 horas no exemplo) é o Cooldown do lead configurado no gatilho da automação. O mesmo número aparece em destaque no Resumo da rodada. Se ele não bate com o que você esperava, troque a origem antes de seguir.

    5. Para forçar a entrada de quem já passou, clique em Incluir na linha do cooldown — ela passa a mostrar incluídos e a janela avisa: Quem já recebeu recentemente vai receber de novo. Clique em Pular para voltar ao padrão.

    6. Em 2 · Ritmo, escolha Tudo de uma vez (sem espera entre ciclos), Suave (250 a cada 5 min) ou Personalizado, que abre os controles Contatos por ciclo e Intervalo entre ciclos. Abaixo dos cartões, o cronograma mostra uma barra por ciclo, quando a rodada começa e quando o último ciclo sai. O que cada controle faz está em Como controlar o ritmo de um envio em massa?.

    7. Em 3 · Quando começa, deixe Agora ou escolha Agendar e informe data e hora.

    8. Confira o Resumo da rodada (origem, ritmo, duração, custo estimado e quando) e clique em Executar para N contatos — ou Agendar para N contatos, se agendou.

    A partir daí a rodada aparece no editor com o status Agendada (se você agendou) ou Em andamento.

    O que o cartão da rodada mostra

    No cartão do gatilho Início manual, a Última rodada é uma linha só: o selo de status, a origem e, abaixo, data, desfecho e quem executou — por exemplo, 1 contato avulso · 02 out, 16:46 · 1 entrou · por Paulo. Clicar na linha abre a aba Execuções já filtrada por essa rodada. Ao lado do rótulo, o botão N rodadas abre o histórico.

    ItemO que significa
    Selo de statusVerde com check: concluída sem falha. Âmbar com alerta: concluída com falhas (a linha diz N falharam · ver falhas). Azul girando: em andamento. Azul com relógio: agendada. Cinza: cancelada
    N entraramQuantos contatos de fato entraram na automação nesta rodada
    N pulados pelo cooldownQuantos ficaram de fora por terem passado pela automação dentro da janela de cooldown
    OrigemDe onde veio a audiência: os contatos avulsos, ou o nome da lista, da tag ou do segmento
    Barra de progressoCom a rodada Em andamento (ou concluída com falhas): verde para quem entrou, âmbar para quem falhou e azul listrado para quem ainda está na fila, com a legenda N entraram · N na fila. Enquanto a rodada está em andamento, o botão do cartão vira Rodando… cancelar
    HistóricoAs últimas rodadas agrupadas por dia (Hoje, Ontem, data), cada uma com origem, quem executou, horário e desfecho. O cabeçalho resume N rodadas · N contatos · nenhuma falha (ou N falhas), e Ver todas as execuções abre a aba Execuções sem filtro
    Fita de ciclosNo histórico, só numa rodada Em andamento: um tracinho por ciclo de disparo — verde concluído, amarelo em execução, cinza ainda por sair, vermelho falhou. Passe o mouse para ver "N de M concluídos"
    BlocosNo histórico, abaixo da fita de uma rodada em andamento: abre a lista dos ciclos (rola por dentro), com status, horário e quantos entraram em cada um, e a previsão de término — o horário do último ciclo ainda por sair. Num ciclo pendente marcado para o futuro, o botão Adiantar o coloca na fila agora, sem mexer nos demais

    O cartão e o histórico se atualizam sozinhos enquanto a rodada está em andamento, sem recarregar a página; com o histórico aberto (ou a aba Execuções filtrada pela rodada), a atualização é mais frequente.

    Na aba Execuções, cada execução criada por uma rodada leva o selo Rodada, e você pode filtrar a lista por rodada para ver só o que aquela execução em massa fez. As execuções iniciadas por evento não têm o selo.

    Cancelar uma rodada

    Enquanto a rodada estiver Agendada ou Em andamento, o botão do cartão do gatilho vira Rodando… cancelar (ou Agendada… cancelar) — clique nele e confirme. A regra é simples: o que ainda não saiu, não sai — os contatos que ainda não tinham entrado não entram. Quem já entrou segue o fluxo normalmente; para parar uma dessas execuções, use Interromper na aba Execuções, como em Como interromper uma execução que está em andamento?.

    Pausar ou arquivar a automação também cancela a rodada que estiver agendada ou em andamento.

    Limites

    • Uma rodada por vez. Enquanto houver uma rodada Agendada ou Em andamento, a automação não aceita outra. Espere ela concluir ou cancele-a para executar de novo.
    • Até 500 contatos em Avulso. Para uma audiência maior, coloque os contatos numa lista, aplique uma tag ou monte um segmento e use essa origem.

    Automações que não podem ser executadas

    Alguns passos só funcionam com os dados que o evento do gatilho traz — por exemplo, responder um comentário ou story do Instagram, ou enviar WhatsApp pelo número que recebeu a conversa. Numa rodada não existe conversa nem comentário de origem, então a janela de Executar explica que a automação depende do contexto do gatilho e não permite seguir.

    Para tornar a automação executável, troque esses passos por versões que não dependem do evento — no WhatsApp, fixe o número de envio, como em De qual número a automação envia o WhatsApp?.

    Executar a partir de Contatos

    Em Contatos, selecione os contatos (ou abra uma lista ou um segmento) e, nas ações em massa, clique em Enviar mensagem e escolha o cartão Automação completa. Na janela Automação, marque Executar automação existente, escolha uma automação publicada e clique em Executar: a rodada começa na hora para esse público, com a origem já preenchida. É o caminho mais curto quando você parte do público, não da automação.

    Testar × Executar

    TestarExecutar manualmente
    Quando apareceAutomação em rascunho ou pausadaAutomação publicada
    Quem entraUm contatoAvulso (até 500), lista, tag ou segmento
    CooldownIgnoradoRespeitado, com opção de incluir quem já passou
    AgendarNãoAgora (Executar para N contatos) ou Agendar (Agendar para N contatos)
    AcompanhamentoAbre o passo a passo sobre o canvasCartão da rodada + aba Execuções com selo Rodada

    Os dois executam de verdade: enviam mensagens, aplicam tags e chamam integrações. Veja Como testar uma automação antes de publicar?.

    Perguntas frequentes

    Minha automação antiga de "Envio em massa para lista/tag/segmento" sumiu? Não. Ela foi convertida para uma automação de Início manual, e a lista, tag ou segmento que estava no gatilho aparece pré-selecionada (com o selo Sugestão do gatilho) quando você clica em Executar. Se ela estava agendada, o agendamento virou uma rodada Agendada na mesma data.

    O cartão diz "Ainda não rodou". E agora? É o estado normal de uma automação de Início manual recém-publicada: nada é enviado até você clicar em Executar agora e escolher quem entra — os chips abaixo da frase lembram as origens possíveis (contatos avulsos, lista, tag ou segmento).

    Agendei uma rodada e, na hora marcada, ela apareceu como Falhou. Se algo impede o envio no momento agendado, a rodada falha e você recebe uma notificação. A automação não é pausada — corrija o que faltou e execute de novo.

    Pausei a automação com uma rodada em andamento. O que acontece? A rodada é cancelada. Quem ainda não tinha entrado não entra; ao publicar de novo, execute outra rodada.

    Mudei o Ritmo de disparo com uma rodada em andamento. A rodada em andamento mantém o ritmo com que começou. O novo valor vale a partir da próxima rodada.

    Posso executar uma automação que começa por um evento? Sim. Executar é uma porta de entrada, não um tipo de gatilho: a automação continua reagindo ao evento normalmente e, além disso, recebe os contatos da rodada.

    Relacionados