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/messaging/send-a-broadcast.md.
  • Português

      • Envie um broadcast

      Um broadcast dispara a mesma mensagem para todos os contatos de uma lista ou de um segmento, por e-mail, WhatsApp, SMS ou voz. Para atingir uma tag, crie antes um segmento com a regra dessa tag e dispare para ele.

      Antes de começar

      • Papel: qualquer membro do workspace cria e dispara um broadcast. Só a criação de uma nova lista ou de um novo segmento para montar a audiência é bloqueada para guest e attendant sem a subrole coordenador — esses papéis ainda disparam para listas e segmentos que já existem.
      • Canal conectado: o canal do broadcast precisa estar configurado. Veja conectar o WhatsApp e domínio de e-mail.

      Passos

      1. Abra Mensagens e crie um novo broadcast, escolhendo o canal (e-mail, WhatsApp, SMS ou voz).
      2. Escreva o conteúdo da mensagem. Para e-mail, preencha também assunto e assinatura.
        • O Assunto aceita variáveis do contato: clique no botão de chaves {} ao lado do campo e escolha a variável, ou digite direto no formato {{name}}. Cada destinatário recebe o assunto com os próprios dados. Use {{name|Cliente}} para mostrar "Cliente" quando o contato não tiver nome — sem o valor padrão, a variável sai vazia. O disparo de teste mostra o assunto sem dados de contato (só o valor padrão, quando houver).
        • A tela de criação de e-mail mostra um preview do conteúdo ao lado da configuração de envio. Clique em Clique para editar (aparece ao passar o mouse sobre o preview) para abrir o editor visual completo, com o painel único de Conteúdo, Linhas e Configuração à esquerda (veja como montar o conteúdo do e-mail no editor?) — clicar em outro ponto do preview não abre o editor. Para ver como o e-mail chega ao destinatário sem sair da tela de configuração, use Visualizar e-mail completo.
        • No editor visual de e-mail, use Importar HTML (ao lado do botão de variáveis) para partir de um HTML já pronto: arraste um arquivo .html ou ative Colar HTML e cole o código. A pré-visualização mostra o resultado antes de confirmar — ao importar, todo o conteúdo atual do e-mail é substituído (desfazer com Ctrl+Z volta ao estado anterior).
        • O link de cancelar inscrição vai automaticamente no fim do e-mail. Para escolher onde ele fica e o texto dele, arraste o bloco Descadastro para o e-mail — normalmente dentro do Rodapé (veja como montar o conteúdo do e-mail no editor?).
        • Para colocar um link em um botão ou texto, clique nele e use o controle de link/botão que aparece. Clicar no link mostrado ali para trocar o destino abre automaticamente a aba Conteúdo (painel à esquerda) já com as opções — link de checkout (de uma oferta), página (de uma página do projeto), redirecionamento (um dos redirects configurados em Domínios) ou URL personalizada (para colar qualquer outro link).
        • No canto esquerdo da barra de ferramentas do editor aparece Salvando... enquanto suas edições estão sendo sincronizadas e Tudo salvo quando terminam — isso só confirma que o conteúdo foi sincronizado na tela, não que o broadcast já foi salvo no servidor. Clique em Confirmar para sair do editor visual e voltar à configuração de envio; a persistência de verdade só acontece no passo 6, com Salvar rascunho ou o disparo.
        • No WhatsApp, a criação é um fluxo guiado em etapas e só com templates aprovados pela Meta — veja Disparo de WhatsApp.
        • No e-mail, a criação de um novo disparo também é um fluxo guiado em etapas — veja Disparo de e-mail. Rascunhos e agendamentos montados no editor antigo continuam abrindo a tela de configuração descrita acima, com o aviso Este e-mail está no editor antigo. Clique em Abrir no editor novo e confirme para continuar no fluxo guiado: o editor visual abre direto na etapa Mensagem. O layout pode mudar na conversão — revise o e-mail, clique em Salvar no editor e depois Salvar no rodapé. Alterações que você não salvou na tela antiga são descartadas. Depois de salvo no editor novo, o disparo passa a abrir sempre no fluxo guiado.
      3. Em destinatários, abra o seletor e escolha a audiência na aba Listas (grupos estáticos) ou Segmentos (grupos dinâmicos) — dá para combinar as duas. A diferença entre elas está em lista vs. segmento.
        • Alternativa: parta direto de uma lista ou segmento pelo botão Criar broadcast na página do próprio grupo.
      4. Confira a contagem de destinatários. Só contatos válidos do canal são enviados.
      5. (Opcional) Agende o disparo para uma data/hora futura, ou ajuste o envio em lotes (quantidade por ciclo e intervalo entre ciclos). Sem ajuste, o servidor aplica o lote padrão — o envio nunca sai em rajada única.
      6. Confirme o disparo, ou use Salvar rascunho para enviar depois. O envio é irreversível.

      Disparo de e-mail

      O disparo de e-mail também é um fluxo guiado em cinco etapas, no trilho lateral (no celular, no topo da tela). Continuar avança e Voltar retorna.

      1. Remetente: escolha o remetente. Só domínios verificados podem enviar; o domínio ainda em verificação aparece como Domínio em verificação, com o atalho Ver verificação. Para incluir outro remetente, use Adicionar remetente no fim da lista: ele abre a conexão de domínio e e-mail sem sair do disparo. Sem nenhum remetente, a tela oferece Configurar Domínio e E-mail. O nome interno do disparo também fica aqui e só você o vê.
      2. Mensagem: em Como montar o e-mail, escolha Criar e-mail ou Usar modelo salvo. Preencha o Assunto (a tela avisa quando ele é longo e pode ser cortado em alguns apps de e-mail) e, se quiser, o Cabeçalho, o texto de apoio que aparece na caixa de entrada depois do assunto. Abrir o editor abre o editor visual completo (veja como montar o conteúdo do e-mail no editor?). Na galeria de modelos, busque pelo nome, ordene e clique em Selecionar (ou Editar). Salvar como modelo guarda o e-mail atual para os próximos disparos. A lateral Na caixa de entrada mostra como o remetente, o assunto e o cabeçalho chegam. Para as variáveis do assunto, do cabeçalho e do corpo, defina o texto alternativo em Se não houver…, usar:.
      3. Público: escolha as listas e confira o resumo: contatos nas listas, Sem e-mail cadastrado e E-mails válidos. Com e-mails inválidos ou arriscados, escolha Deixar de fora ou Enviar para todos, ou use Revisar destinatários (veja como escolher quem recebe).
      4. Quando e ritmo: Enviar agora ou Agendar com data e hora (horário de Brasília), e ajuste quantos e-mails saem por ciclo e o intervalo entre ciclos.
      5. Revisar: confira o resumo, use Editar em qualquer item para voltar à etapa, e Enviar teste para receber o e-mail antes do disparo. Depois, Concluir e enviar (ou Concluir e agendar). A tela passa a mostrar o andamento, com Pausar envio, Retomar e Cancelar envio.

      Pendências ficam numa faixa acima do rodapé. As vermelhas impedem o envio (remetente, assunto, conteúdo, público ou nenhum e-mail válido); as amarelas só avisam (assunto longo, cabeçalho vazio em e-mail de modelo salvo e contatos sem o campo de uma variável). Salvar guarda o rascunho e mantém você no fluxo; Salvar e sair guarda e volta para a lista. Num disparo que já está agendado, salvar mantém o agendamento no mesmo horário; para tirá-lo da agenda, escolha Enviar agora em Quando e ritmo antes de salvar. Se a data agendada já passou, ajuste-a antes de salvar. No celular, essas ações ficam no botão ⋯ do rodapé, ao lado de Continuar, e a barra de navegação do app some durante a criação do disparo. Um rascunho sem nome aparece como Disparo sem nome. Se você não tem permissão para alterar o disparo, ele abre somente para leitura.

      Disparo de WhatsApp

      O disparo de WhatsApp é um fluxo guiado em cinco etapas, mostradas no trilho lateral (no celular, no topo da tela). Continuar avança e Voltar retorna.

      1. Origem: escolha o número de onde a mensagem vai sair. Os templates disponíveis dependem do número. Aqui também fica o nome interno do disparo, que só você vê.
      2. Template: a galeria mostra só templates de Marketing e Utilidade aprovados pela Meta para aquele número. Filtre por categoria, busque pelo nome e use Carregar mais para ver os próximos. Templates ainda em análise ou recusados aparecem em Indisponíveis para envio. Ao escolher um template, abre a janela Variáveis (no celular, uma gaveta): cada {{1}}, {{2}} do corpo e cada botão com variável (código de cupom, link dinâmico) recebe um campo do contato — por exemplo {{name}} — ou um texto fixo, com a prévia ao lado. Confirmar e selecionar só fica liberado com todas preenchidas, porque a Meta recusa o disparo inteiro quando uma variável chega vazia. O card escolhido fica marcado como Selecionado, e Editar reabre as variáveis. Enviar teste para mim manda a mensagem real para o seu número antes do disparo.
      3. Público: escolha as listas e os segmentos e confira quantos contatos vão receber. Se o público passa do limite diário do número, o disparo não é cortado: o restante sai em ondas, e a tela mostra a previsão da próxima.
      4. Quando e ritmo: envie agora ou agende uma data e hora, e ajuste quantas mensagens saem por ciclo e o intervalo entre ciclos.
      5. Revisar: confira o resumo e clique em Concluir e enviar. A tela passa a mostrar o andamento do disparo (progresso e ciclos), e Voltar à lista retorna às mensagens.

      Pendências que impedem ou afetam o envio aparecem numa faixa logo acima dos botões do rodapé, com a contagem. Quando há mais de uma, clique na faixa para ver todas. Contatos sem o campo da variável é só um aviso: esses contatos são pulados e o restante recebe normalmente.

      No disparo de WhatsApp, os contatos importados da agenda do celular (pela coexistência) que ainda não mandaram nenhuma mensagem para você não recebem o disparo, porque nunca deram opt-in para mensagens da API. A faixa Contatos da agenda do celular sem opt-in mostra quantos ficaram de fora, e os créditos, a capacidade e o público exibidos já descontam esses contatos. Assim que o contato responder, ele volta a receber os próximos disparos.

      O rascunho pode ser salvo em qualquer etapa, mesmo antes de escolher o público ou o template. Salvar guarda e mantém você no fluxo, e Salvar e sair guarda e volta para a lista. Num disparo que já está agendado, salvar mantém o agendamento no mesmo horário. No celular, Salvar, Salvar e sair e o envio de teste ficam no botão ⋯ do rodapé, ao lado de Continuar. Um rascunho salvo sem nome aparece como Disparo sem nome seguido de um número. Para agendar ou enviar, o público e o template precisam estar escolhidos.

      Depois de disparado, acompanhe entregas, aberturas e cliques na página do broadcast. Um broadcast em andamento pode ser cancelado; os lotes ainda não enviados são interrompidos.

      Por que o envio parou ou uma mensagem não saiu

      Na página do broadcast, um envio pausado mostra o motivo e quem o retoma: Pausado manualmente (retome quando quiser), Pausado: template indisponível na Meta (retoma sozinho quando a Meta aprovar o template de novo) ou Pausado: número pausado pelo operador (só volta quando o número for retomado). Use Pausar envio e Retomar envio para controlar o andamento. Enquanto o envio está em andamento, a tela também mostra o Término previsto, em cerca de quanto tempo o envio acaba.

      O cartão Canceladas conta as mensagens que nunca saíram da fila: envio cancelado, descartado ou impedido, por exemplo porque o contato respondeu antes do envio ou pediu para não receber mensagens. Elas não entram em Falhas. Ao abrir uma mensagem individual, o motivo aparece em texto simples, como O contato respondeu antes do envio ou A janela de 24 horas de conversa com este contato está fechada.

      Adiantar o próximo lote

      Na aba Blocos de envio, enquanto o envio está em andamento, o botão Adiantar próximo bloco manda o próximo lote pendente agora, sem esperar o horário agendado. Os lotes seguintes andam o mesmo tempo para frente e mantêm o intervalo entre eles — o envio inteiro termina antes.

      • É sempre o próximo lote da fila; não dá para escolher um lote específico.
      • Fica indisponível enquanto um lote ainda está sendo enviado. Espere ele terminar.
      • É por sua conta e risco: o envio em lotes protege a reputação do remetente, e adiantar gera um pico de volume que provedores (Gmail, Outlook, Meta, operadoras) podem punir com spam, limitação ou queda de qualidade do número. A confirmação exige marcar que você entende os riscos.
      • Não tem volta: os lotes não retornam ao horário original. Para parar, use Cancelar envio.

      Primeira visita, sem nenhum envio

      Quando o canal (E-mail, WhatsApp, SMS ou Voz/URA) ainda não tem nenhum envio, a lista mostra uma prévia esmaecida da área, um título como Faça seu primeiro envio de e-mail (ou de WhatsApp, SMS ou mensagem de voz), um resumo curto e três destaques. O botão Criar mensagem começa um novo envio naquele canal; no e-mail, a plataforma pergunta primeiro o projeto. Uma busca ou filtro sem resultado não mostra essa tela: continua aparecendo a mensagem simples de que nada foi encontrado. O Histórico e os Templates não mudam.

      Relacionados

      Se não funcionou

      • O número do WhatsApp está bloqueado: a Meta pode banir o número e barrar o disparo. Confira códigos de erro e o limite da Meta.
      • Não consigo selecionar o template no WhatsApp: falta preencher alguma variável na janela Variáveis, inclusive as dos botões. Trocar o número de origem limpa o template escolhido, então ele precisa ser selecionado de novo.
      • A galeria de templates do WhatsApp está vazia: o número ainda não tem template de Marketing ou Utilidade aprovado pela Meta. Templates de autenticação não aparecem no disparo, e os que estão em análise ficam em Indisponíveis para envio até a aprovação.
      • Não consigo agendar ou enviar o rascunho: escolha o público e o template antes. O rascunho salva sem eles, mas o envio exige os dois.
      • O assunto chegou com um espaço vazio no lugar do nome: o contato não tem esse dado preenchido. Adicione um valor padrão na variável, por exemplo {{name|Cliente}}.
      • Não consigo criar a lista/segmento da audiência: seu papel é guest ou attendant sem coordenador. Use um grupo já existente ou veja sem permissão.
      • Um destinatário aparece como Bounce: o envio para ele falhou. Na aba Audiência do broadcast, passe o mouse sobre o status Bounce para ver o motivo da falha registrado no envio, quando ele existe.