Campanhas

Visão geral de Campanhas

Visão geral As Campanhas da ConversaLabs permitem que você fale com seus contatos de forma proativa — em vez de esperar a pessoa iniciar a conversa. Em um só lugar você cria, agenda e acompanha disparos de mensagens para públicos definidos, com métricas de entrega e resultado. Há duas famílias principais de campanha: - Campanhas no site: mensagens proativas exibidas no widget de chat do seu site, disparadas por regras (por exemplo, qual página o visitante está vendo e há quanto tempo). Ideais para engajar quem está navegando agora. - Campanhas de WhatsApp: envios para listas de contatos (audiência definida por etiquetas), usando templates HSM aprovados ou mensagens com variantes, com agendamento e ritmo de envio. Cada tipo tem seu próprio artigo nesta categoria, com o passo a passo completo. Dependendo dos canais habilitados na sua conta, você também pode encontrar campanhas de SMS, que seguem a mesma lógica das de WhatsApp. Pré-requisitos - Acesso ao módulo Campanhas (pode depender do seu perfil de acesso — fale com um administrador). - Para campanhas no site: uma caixa de entrada de site/widget ativa. - Para campanhas de WhatsApp: uma caixa de entrada de WhatsApp conectada e, no caso de templates, modelos aprovados. - Contatos organizados (especialmente etiquetas, usadas para definir a audiência). Passo a passo 1. Abra Campanhas na barra lateral. 2. Escolha o tipo de campanha (site ou WhatsApp). 3. Clique em Criar campanha. 4. Dê um título e selecione a caixa de entrada (canal) que fará o envio. 5. Monte o conteúdo (mensagem, template ou mensagem proativa) e defina o público ou o gatilho de disparo. 6. Escolha quando enviar (agora, agendado ou salvar como rascunho) e confirme. 7. Acompanhe o status e as métricas da campanha na lista. Configurações & opções - Tipo de campanha: site (proativa no widget) ou WhatsApp (para listas). - Canal / caixa de entrada: define por onde a mensagem é enviada. - Público ou gatilho: audiência por etiquetas (WhatsApp) ou regra de página/tempo (site). - Conteúdo: template HSM, mensagem com variantes ou mensagem proativa. - Agendamento: enviar agora, agendar para depois ou manter como rascunho. - Status e métricas: acompanhe enviadas, entregues, lidas e respondidas. Casos de uso - Saudar visitantes em uma página de preços e oferecer ajuda em tempo real (campanha no site). - Anunciar uma promoção para uma lista de clientes etiquetados (campanha de WhatsApp). - Reativar contatos antigos com uma mensagem segmentada e agendada. - Comunicar avisos importantes (mudança de horário, novo recurso) ao público certo. Dicas, limites e boas práticas - Comece com públicos pequenos e bem segmentados por etiquetas — qualidade vale mais que volume. - No WhatsApp, respeite as regras da Meta e as boas práticas anti-ban (ritmo de envio, conteúdo relevante, opção de descadastro). - Mantenha mensagens claras e úteis para reduzir bloqueios e aumentar respostas. - Teste o conteúdo com um público reduzido antes de um disparo grande. Solução de problemas - Não vejo Campanhas: o módulo pode não estar habilitado para sua conta ou seu perfil — fale com um administrador. - Não consigo escolher a caixa de entrada: confirme que o canal certo está conectado (site para campanhas no site; WhatsApp para campanhas de WhatsApp). - Público vazio: verifique se há contatos com a etiqueta selecionada. Veja também - Campanhas no site - Campanha de WhatsApp para listas de contatos - Templates HSM e variáveis

Campanhas no site (mensagens proativas no widget)

Visão geral As campanhas no site (também chamadas de campanhas ao vivo) exibem uma mensagem proativa no widget de chat do seu site para o visitante que está navegando. Em vez de esperar o contato abrir o chat, a plataforma inicia a conversa quando uma regra é atendida — por exemplo, quando a pessoa fica um tempo em uma página específica. É a forma ideal de oferecer ajuda no momento certo: tirar dúvidas em uma página de preços, recuperar um carrinho ou apresentar uma promoção a quem demonstra interesse. Pré-requisitos - Acesso ao módulo Campanhas. - Uma caixa de entrada de site/widget ativa, com o widget instalado no seu site. - Definição de qual agente ou bot enviará a mensagem. Passo a passo 1. Abra Campanhas na barra lateral e selecione o tipo site (campanhas ao vivo). 2. Clique em Criar campanha. 3. Preencha o título (nome interno para você identificar a campanha). 4. Escreva a mensagem que aparecerá no widget. 5. Selecione a caixa de entrada (o widget do site onde a mensagem será exibida). 6. Escolha o remetente (o agente ou bot que assina a mensagem). 7. Defina o gatilho: a URL da página onde a campanha deve disparar e o tempo na página (em segundos) antes de exibir a mensagem. 8. Ajuste as preferências (ativar a campanha, disparar apenas em horário comercial) e salve. Configurações & opções - Título: identificação interna da campanha. - Mensagem: o texto proativo exibido no widget. - Caixa de entrada: o widget de site que mostrará a mensagem. - Remetente (enviado por): agente ou bot que aparece como autor. - URL: a página em que a campanha é elegível para disparar. - Tempo na página (segundos): quanto tempo o visitante deve permanecer antes do disparo. - Ativar campanha: liga ou desliga a campanha sem precisar excluí-la. - Disparar apenas em horário comercial: evita iniciar conversas fora do expediente. Casos de uso - Oferecer ajuda na página de preços após alguns segundos de navegação. - Apresentar um cupom a quem visita a página de um produto. - Convidar para uma demonstração quem está na página de planos. - Reduzir abandono em páginas de checkout com uma mensagem de apoio. Dicas, limites e boas práticas - Use mensagens curtas e específicas para a página em que aparecem. - Ajuste o tempo na página para não interromper cedo demais — dê tempo para o visitante ler. - Ative somente em horário comercial se você não tem cobertura 24/7, para não gerar conversas sem resposta. - Crie campanhas diferentes para páginas diferentes, em vez de uma única mensagem genérica. Solução de problemas - A mensagem não aparece: confirme que a campanha está ativada, que a URL corresponde à página visitada e que o tempo na página já foi atingido. - Aparece fora de hora: verifique a opção disparar apenas em horário comercial e os horários configurados na caixa de entrada. - O widget não carrega: confira se o widget do site está corretamente instalado. Veja também - Visão geral de Campanhas - Campanha de WhatsApp para listas de contatos - Templates HSM e variáveis

Campanha de WhatsApp para listas de contatos

Visão geral A campanha de WhatsApp envia uma mensagem para uma lista de contatos de uma só vez. Você define a audiência (por etiquetas), escolhe o conteúdo (um template HSM aprovado ou uma mensagem com variantes) e decide quando enviar. A plataforma envia em ritmo controlado e mostra o progresso (enviadas, entregues, lidas e respondidas). É a ferramenta certa para anúncios, promoções, avisos e reativação de contatos — sempre respeitando as regras do WhatsApp para mensagens em massa. Pré-requisitos - Acesso ao módulo Campanhas. - Uma caixa de entrada de WhatsApp conectada. - Contatos com etiquetas que definam a audiência. - Para campanhas baseadas em template: templates HSM aprovados na caixa de entrada (veja o artigo de templates e variáveis). Passo a passo 1. Abra Campanhas na barra lateral e selecione o tipo WhatsApp. 2. Clique em Criar campanha e dê um título. 3. Selecione a caixa de entrada de WhatsApp que fará o envio. 4. Defina a audiência selecionando as etiquetas dos contatos que devem receber. 5. Monte o conteúdo: - Template HSM: escolha o template, o idioma e preencha os valores das variáveis; ou - Mensagem com variantes: escreva a mensagem (usando o seletor de variáveis) e, se quiser, adicione variantes para que cada contato receba uma redação um pouco diferente. 6. Ajuste as configurações de envio (atraso mínimo/máximo entre mensagens, tamanho do lote e aleatorização) para um disparo mais natural. 7. Em Conversa criada pela campanha (quando o recurso estiver habilitado na conta), escolha o status da conversa de cada contato, o que acontece quando o cliente responde, a atribuição, as etiquetas e o que fazer com uma conversa que já existe. 8. Escolha quando enviar: enviar agora, agendar para uma data/hora ou salvar como rascunho. 9. Confirme e acompanhe o status e o progresso na lista de campanhas. Configurações & opções - Título: identificação interna da campanha. - Caixa de entrada: o número de WhatsApp que enviará as mensagens. - Audiência: contatos selecionados por etiquetas. - Conteúdo: template HSM (com variáveis) ou mensagem com variantes. - Configurações de envio: atraso mínimo e máximo (segundos), tamanho do lote e aleatorização de variantes — ajudam a reduzir o risco de bloqueio. - Agendamento: enviar agora, agendar ou rascunho. - Status: rascunho, agendada, enviando, pausada, concluída ou falha. - Ações: pausar, retomar ou cancelar uma campanha em andamento. Na API oficial (WhatsApp Cloud), uma campanha pode ser cancelada antes de começar, durante o envio ou enquanto está pausada; pausar e retomar ficam na página de detalhes da campanha. Pausar é reversível e, ao retomar, só recebe quem ainda aguarda. Cancelar é definitivo e pede uma confirmação que mostra o nome da campanha e quantos contatos ainda aguardam e serão pulados. Se a Meta recusar o template no meio do disparo, a campanha é pausada automaticamente (veja Resultados da campanha de WhatsApp). - Progresso: enviadas, entregues, lidas, respondidas e falhas. Conversa criada pela campanha Cada contato recebe a mensagem dentro de uma conversa. Esta seção define o que acontece com ela: | Opção | Valores | Padrão em campanha nova | | --- | --- | --- | | Status da conversa criada | Pendente · Aberta · Resolvida | Pendente | | Quando o cliente responder | Abrir a conversa · Manter a conversa pendente | Abrir a conversa | | Atribuição ao abrir | Regras da caixa de entrada · Agente específico · Time específico · Sem atribuição | Regras da caixa de entrada | | Etiquetas da conversa | nenhuma ou até 10 etiquetas da conta | nenhuma | | Conversa já existente do contato | Manter o status atual · Aplicar status e etiquetas | Manter o status atual | - Pendente: a conversa não aparece em Abertas e não notifica a equipe. Quando o cliente responde pela primeira vez, ela abre, recebe a atribuição escolhida e a equipe da caixa de entrada é notificada uma única vez. Automações, fluxos e webhooks recebem a abertura como qualquer mudança de status. - Automações do evento Conversa Criada recebem essa conversa já como pendente, e o evento não se repete quando ela abre. Para agir quando o cliente responde, use o evento Conversa Aberta. - Aberta: comportamento de sempre — a conversa entra em Abertas assim que a campanha é enviada. Campanhas criadas antes deste recurso continuam assim. - Notificação e lead score no envio em lote. Quando a campanha é enviada em lote, a conversa que ela cria, aberta ou pendente, não notifica a equipe nem soma o evento de atendimento ao lead score do contato no momento do envio. As duas coisas acontecem uma única vez, quando o cliente responde pela primeira vez. A atribuição a um agente continua notificando o responsável normalmente. - Resolvida: a conversa nasce resolvida e reabre sozinha quando o cliente responde, pelas regras normais da caixa de entrada. - Atribuição: acontece na primeira resposta e nunca substitui um agente que já esteja atribuído. - Conversa já existente: por padrão a campanha reaproveita a conversa sem mudar o status. A opção de aplicar o status não aceita Resolvida, porque resolver uma conversa em andamento enviaria a pesquisa de satisfação ao cliente logo antes da mensagem da campanha. Com Pendente, aplicar o status tira uma conversa que está em atendimento da lista Abertas do agente até o cliente responder, e cada conversa reaproveitada avisa webhooks e automações da mudança de status. - No detalhe da campanha, o card Abertas por resposta mostra quantas conversas pendentes a resposta do cliente abriu. Casos de uso - Anunciar uma promoção para clientes de uma etiqueta específica. - Enviar um aviso importante (mudança de horário, novo produto) ao público certo. - Reativar contatos inativos com uma oferta segmentada. - Confirmar presença em um evento ou lembrar de uma data. Dicas, limites e boas práticas - Para iniciar conversas com quem está fora da janela de 24 horas, o WhatsApp exige template HSM aprovado — mensagens de texto livre só funcionam dentro da janela de atendimento. - Use as configurações de envio com atrasos entre mensagens e lotes menores: disparos muito rápidos aumentam o risco de bloqueio (anti-ban). - Na API oficial, o ritmo segue o limite do número na Meta: 80 mensagens por segundo no início, até 1.000 se a Meta liberar o número, e 20 num número que também usa o app WhatsApp Business (coexistência). As campanhas usam até o limite menos 5: 75, 995 ou 15 mensagens por segundo. O limite vale para a soma de todos os envios automáticos do número (campanhas, follow-ups, fluxos, distribuição e recuperação de vendas). Enquanto a Meta não confirmar o nível do número nas últimas 24 horas, vale o limite padrão de 80. O detalhe da campanha mostra o ritmo em uso. - Segmente bem por etiquetas e envie apenas conteúdo relevante para reduzir descadastros e denúncias. - Teste com uma audiência pequena antes de um envio grande. - Acompanhe o progresso e pause a campanha se notar muitas falhas. - Se o envio de uma campanha da API oficial ficar parado por mais de 15 minutos, a campanha é pausada e os administradores recebem um aviso; é só usar Retomar, e ninguém recebe duas vezes. Com o envio em lotes habilitado na conta, a plataforma antes tenta retomar o disparo sozinha, até 3 vezes em uma hora. - Em campanhas grandes, prefira Pendente: a equipe só é avisada das conversas em que o cliente realmente respondeu, e a lista Abertas não é inundada. - Se um robô atende a caixa de entrada, a conversa pendente continua com ele quando o cliente responde; o robô a entrega à equipe quando for o caso. - Sem atribuição só impede a campanha de atribuir. Se a atribuição automática da caixa estiver ligada, a caixa ainda pode atribuir a conversa depois, na próxima distribuição. Solução de problemas - Não consigo selecionar a caixa de entrada: confirme que há uma caixa de entrada de WhatsApp conectada. - Audiência vazia: verifique se existem contatos com a etiqueta escolhida. - Template não aparece: confira se há templates aprovados na caixa de entrada selecionada. - Muitas falhas no envio: reduza o ritmo (aumente os atrasos e diminua o tamanho do lote) e confira a saúde do número de WhatsApp. - A conversa não abriu quando o cliente respondeu: confira se a campanha usa Abrir a conversa na resposta e se um robô atende a caixa de entrada — nesse caso a conversa segue pendente com ele. Conversas pendentes aparecem na lista Pendentes. - Não consigo aplicar o status a conversas existentes: a opção fica desabilitada com o status Resolvida; escolha Pendente ou Aberta. Veja também - Templates HSM e variáveis - Visão geral de Campanhas - Campanhas no site

Templates HSM e variáveis (seletor {{var}})

Visão geral Os templates HSM (Highly Structured Messages) são modelos de mensagem do WhatsApp aprovados pela Meta. Eles são obrigatórios para iniciar uma conversa fora da janela de 24 horas — por exemplo, em uma campanha para uma lista de contatos. Muitos templates têm variáveis (marcadores no formato {{1}}, {{2}} ou nomeados como {{nome}}) que são preenchidas com dados de cada contato. Na ConversaLabs, você preenche essas variáveis com o seletor de variáveis ({{var}}), e o valor é resolvido para cada destinatário no momento do envio. Pré-requisitos - Uma caixa de entrada de WhatsApp conectada. - Templates HSM aprovados na caixa de entrada (a aprovação é feita junto à Meta). - Contatos com os dados que você pretende usar nas variáveis (por exemplo, nome). Passo a passo 1. Em uma campanha de WhatsApp (ou ao enviar uma mensagem que exige template), selecione a caixa de entrada e escolha o template. 2. Selecione o idioma do template (e confira a categoria, definida na aprovação). 3. Se o template tiver um cabeçalho de mídia, selecione a imagem, o vídeo ou o documento que será enviado. A plataforma guarda esse arquivo no histórico da conversa, inclusive quando o WhatsApp usa uma referência temporária de mídia para fazer o envio. 4. Para cada variável do template, informe o valor: - digite um texto fixo; ou - use o seletor de variáveis ({{var}}) para inserir um campo dinâmico (como o nome do contato), que será substituído por destinatário. 5. Revise a pré-visualização do template já com os valores preenchidos. 6. Conclua o envio (ou agende a campanha). A plataforma resolve as variáveis por contato no momento do disparo. Configurações & opções - Template: o modelo aprovado que será enviado. - Idioma: a versão de idioma do template. - Categoria: a finalidade do template, definida na aprovação (por exemplo, marketing ou utilidade). - Variáveis: os marcadores {{...}} do template, preenchidos com texto fixo ou com o seletor de variáveis. - Cabeçalho de mídia: a imagem, o vídeo ou o documento específico daquele envio. O arquivo exibido no histórico corresponde ao que foi enviado, e não à mídia de exemplo usada na aprovação do template. - Seletor de variáveis ({{var}}): insere campos dinâmicos (contato, conta etc.) que são resolvidos individualmente para cada destinatário. - Pré-visualização: mostra como a mensagem ficará com os valores aplicados. Casos de uso - Personalizar a saudação com o nome do contato em um disparo em massa. - Enviar um código ou link específico por contato dentro de um template. - Reaproveitar o mesmo template em várias campanhas, mudando apenas os valores das variáveis. Dicas, limites e boas práticas - Preencha todas as variáveis do template — campos vazios podem impedir o envio para aquele contato. - Use variáveis dinâmicas com dados confiáveis; se um contato não tiver o dado, prefira um valor fixo de reserva para não deixar a mensagem incompleta. - Lembre-se de que o conteúdo do template é fixo (aprovado pela Meta) — você altera apenas os valores das variáveis, não o texto do modelo. - As variáveis são resolvidas no servidor, por destinatário — você não precisa montar uma mensagem diferente para cada contato. Solução de problemas - O template não aparece: confirme que ele está aprovado e na caixa de entrada correta. - O envio falha para alguns contatos: verifique se alguma variável ficou sem valor para esses contatos. - O nome (ou outro dado) não aparece: confirme que o campo existe no contato e que a variável certa foi selecionada no seletor. - O cabeçalho aparece sem mídia: confirme que o arquivo foi selecionado antes do envio e que o formato corresponde ao cabeçalho aprovado. A plataforma não substitui um arquivo desconhecido pela mídia de exemplo da Meta. Veja também - Campanha de WhatsApp para listas de contatos - Visão geral de Campanhas - Campanhas no site

Resultados e análise da campanha de WhatsApp

Visão geral Depois que uma campanha de WhatsApp é disparada, abra a página de detalhes da campanha para ver o desempenho completo: um funil de entrega (enviadas, entregues, lidas e respondidas), as taxas de cada etapa, os tempos médios de entrega e de leitura, o custo (quando aplicável), gráficos de tendência ao longo do tempo e a tabela de destinatários, onde é possível reenviar quem falhou. É a tela certa para medir o resultado de um envio, reprocessar falhas e decidir se deve pausar, retomar ou cancelar uma campanha em andamento. Pré-requisitos - Acesso ao módulo Campanhas. - Uma campanha de WhatsApp já enviada ou em envio (as métricas por destinatário só existem para campanhas de WhatsApp). - Para ver custo: a campanha precisa usar um número de WhatsApp Cloud (o WhatsApp Web não é cobrado pela Meta, então o custo não aparece). Passo a passo 1. Abra Campanhas na barra lateral e selecione o tipo WhatsApp. 2. Na lista, clique na campanha que deseja analisar. 3. Leia o cabeçalho: título, status (rascunho, agendada, enviando, pausada, concluída ou falha), a caixa de entrada usada e a data de envio/agendamento. 4. Na seção Análise, leia o funil de entrega e as taxas. 5. Veja os cartões de tempo médio de entrega e tempo médio de leitura e, em campanhas Cloud, os cartões de custo estimado e custo real. 6. Se houver dados suficientes, acompanhe os gráficos de tendência (entrega, leitura e resposta). 7. Role até a tabela de destinatários para ver o status individual e reenviar falhados. Configurações & opções Funil de entrega e taxas O funil mostra, de forma cumulativa, quantos contatos avançaram em cada etapa (um contato que leu também conta como entregue e enviado). As taxas são calculadas sobre o total de enviadas. | Etapa | O que significa | | --- | --- | | Enviadas | Mensagens despachadas para o WhatsApp | | Entregues | Chegaram ao aparelho do contato (taxa = entregues ÷ enviadas) | | Lidas | Foram abertas pelo contato (taxa = lidas ÷ enviadas) | | Respondidas | O contato respondeu (taxa = respondidas ÷ enviadas) | Estados que ficam fora do funil aparecem apenas quando ocorrem: - Falha: não foi possível entregar. - Ignorada: o contato foi pulado (por exemplo, sem número válido). - Na fila: ainda pendentes/processando, ou seja, aguardando disparo durante um envio ativo. Tempos médios - Tempo médio de entrega: média entre o envio e a confirmação de entrega. - Tempo médio de leitura: média entre o envio e a confirmação de leitura. Custo (somente WhatsApp Cloud) - Custo estimado: calculado no momento da criação, sobre a audiência. - Custo real: apurado sobre os destinatários cobrados (entregues, lidos e respondidos), atualizado conforme a campanha avança. Em moeda (padrão BRL). Gráficos de tendência Mostram a evolução das taxas de entrega, leitura e resposta ao longo do tempo, a partir de capturas periódicas (snapshots) do desempenho da campanha. Aparecem quando há pelo menos dois pontos de captura. Tabela de destinatários - Lista paginada com contato, status, horário de envio e de entrega e, em caso de erro, a mensagem de falha. - Filtro por status (todos, pendente, processando, enviada, entregue, lida, respondida, falha, ignorada). - Reenviar: botão por linha nas mensagens com falha e um botão Reenviar falhados para reprocessar todas as falhas de uma vez. O reenvio roda em segundo plano: um aviso informa quantos reenvios foram agendados e quantos destinatários ficaram de fora, e por quê. A tabela acompanha os reenvios sozinha por cerca de um minuto, e o botão Reenviar falhados fica desativado nesse tempo. - Reenviar mesmo assim: aparece na explicação das falhas que dependem de uma correção sua (template pausado ou recusado, número inválido, variável inválida). Depois de corrigir a causa, use-o para reenviar aquele destinatário; a confirmação lembra por que o envio falhou. - Limite de marketing da Meta (erro 131049): o contato recebeu mensagens de marketing demais. A Meta pede pelo menos 24 horas antes de reenviar, e reenviar antes pode bloquear a entrega a esse contato por até 24 horas, valendo para a conta inteira. Por isso a plataforma segura esse reenvio até completar 24 horas da falha, inclusive pelo botão da linha, e o aviso conta quantos destinatários ficaram esperando. - Contato que parou o marketing (erro 131050): quando o contato toca em parar mensagens de marketing deste número, uma campanha com template de marketing pula esse contato antes de enviar (aparece como ignorado, sem cobrança). Templates de utilidade e autenticação continuam chegando. Se a Meta recusar com 131050 um envio que já tinha saído, a linha aparece como falha e só deve ser reenviada de propósito depois que o contato voltar a aceitar. Ao criar a campanha com um template de marketing, a contagem do público e a estimativa de custo já deixam esses contatos de fora, e o formulário avisa quantos pararam de receber marketing deste número. Se o contato parar o marketing depois de uma falha, o Reenviar falhados não reenvia para ele: a linha passa a ignorada, e o aviso conta quantos destinatários ficaram de fora por isso. - Template ainda sincronizando (erro 134101): um template de marketing recém-criado ou alterado leva até 10 minutos para chegar à Marketing Messages API, e a Meta recusa o envio nesse intervalo. A plataforma reenvia sozinha essa mensagem uma vez, 10 minutos depois, pela mesma API; se ainda falhar, use o Reenviar da linha. - Template de autenticação para contato sem telefone: a Meta não aceita template de autenticação para o ID do WhatsApp, então esse contato aparece como ignorado. Envie para um contato com telefone. Ciclo de vida da campanha - Pausar: interrompe um envio em andamento. Numa campanha da API oficial (WhatsApp Cloud), o botão aparece enquanto o status é Processando. O envio para em poucos segundos, e quem ainda não recebeu fica aguardando. Mensagens que já estavam na fila no momento da pausa não saem e não são cobradas: elas voltam para a fila da campanha. - Retomar: continua um envio pausado. Só recebem os contatos que ainda aguardam; quem já recebeu, ou teve o envio recusado, nunca recebe de novo. - Cancelar: encerra a campanha de forma definitiva, inclusive no meio do envio. A confirmação mostra quantos contatos ainda aguardam; nenhum deles vai receber a campanha, e nada disso é cobrado. Pausa automática quando a Meta recusa o template Se a Meta recusar o template no meio do disparo, a plataforma pausa a campanha sozinha na primeira recusa, em vez de gastar o resto da audiência em envios que seriam recusados do mesmo jeito. Os administradores recebem uma notificação e a página da campanha mostra um aviso com o motivo: | Erro da Meta | O que significa | |---|---| | 132015 | A Meta pausou o template, normalmente por queda na avaliação de qualidade. | | 132016 | A Meta desativou o template; ele não pode mais ser enviado. | | 132001 | O template não existe neste idioma (foi excluído ou renomeado). | | 132005 | O texto do template, que não tem variáveis, ficou maior que o permitido. Se o template tem variáveis, o erro vale só para aquele contato: ele aparece como falha na tabela de destinatários e a campanha continua. | Isso vale também logo depois que a campanha aparece como concluída: as mensagens ainda na fila de envio são protegidas por algumas horas, e uma recusa nesse período pausa a campanha de novo. A pausa também acontece quando a Meta avisa que o template foi pausado, desativado ou arquivado, antes mesmo da próxima recusa. Enquanto o template não estiver aprovado de novo, o botão Retomar fica bloqueado e o aviso explica o próximo passo; assim que a Meta reativar o template, Retomar é liberado automaticamente e continua só com quem ainda aguarda. Pausa automática quando a Meta recusa a conta inteira Algumas recusas não dependem do template nem do contato: valem para a conta do WhatsApp inteira ou para o portfólio da empresa. Nesses casos todos os destinatários seriam recusados do mesmo jeito, então a plataforma também pausa a campanha na primeira recusa e avisa os administradores: | Erro da Meta | O que significa | |---|---| | 131063 | Os templates de marketing estão bloqueados na Cloud API desta conta. Envie marketing pela Marketing Messages API ou desligue esse bloqueio. A plataforma tenta o mesmo envio uma vez pela Marketing Messages API; a campanha só pausa se essa tentativa também falhar. | | 131064 | A conta atingiu o limite de envio por violações na classificação de templates. A Meta libera o limite sozinha depois do período de penalidade. | | 135000 | A Meta descartou mensagens que estava retendo para uma avaliação de qualidade do portfólio. Enquanto a avaliação durar, o portfólio não envia templates. | | 131042 | Há um problema na forma de pagamento da conta. Confira o faturamento no WhatsApp Manager. | | 131031 ou 368 | A conta está restrita ou desativada por violação de política. | A campanha também pausa quando a Meta responde ao envio que a mensagem ficou retida para avaliação de qualidade do portfólio: a Meta entrega as mensagens retidas aos poucos e pode descartá-las. Resolva a causa no WhatsApp Manager antes de usar Retomar. Como a causa não está no template, Retomar não espera a sincronização dos templates: o botão fica disponível, e retomar é decisão sua depois de resolver. Na tabela de destinatários, essas recusas não entram em Reenviar todos com falha; dá para reenviar um destinatário de propósito depois de resolver. Pausa automática quando o envio para de avançar Se o envio de uma campanha da API oficial ficar sem progresso por mais de 15 minutos (por exemplo, depois de uma reinicialização do servidor no meio do disparo), a plataforma age sozinha. Com o envio em lotes habilitado na conta, ela retoma o disparo automaticamente, até 3 vezes em uma hora, e só pausa a campanha se mesmo assim ele não avançar. Sem o envio em lotes, a campanha é pausada logo na primeira verificação. Quando a campanha é pausada automaticamente, os administradores recebem uma notificação e a página da campanha mostra um aviso. Use Retomar quando quiser: só recebem os contatos que ainda aguardam, e ninguém recebe duas vezes. Casos de uso - Medir a taxa de leitura e a taxa de resposta de um disparo para avaliar o engajamento. - Reprocessar quem falhou sem recriar a campanha, usando Reenviar falhados. - Pausar o envio ao perceber muitas falhas e investigar a saúde do número antes de retomar. - Acompanhar o custo real versus o estimado em campanhas Cloud. - Comparar a evolução das taxas pelos gráficos de tendência. Dicas, limites e boas práticas - Retomar recalcula a audiência: se o segmento, a etiqueta ou a lista ganharam contatos durante a pausa, esses contatos novos também recebem a campanha. Quem já recebeu não recebe de novo. - A mensagem que ficou retida na conversa por causa da pausa aparece como não enviada e não pode ser reenviada pelo botão da conversa: ao retomar, a campanha envia uma mensagem nova para o contato. - Reenviar falhados fica indisponível enquanto a campanha estiver enviando ou pausada; use depois que o envio terminar. - O reenvio afeta apenas destinatários com status falha — quem já foi entregue, lido ou respondido não é reenviado, e o reenvio nunca duplica um contato. - Falhas que só se resolvem depois de uma correção sua (template pausado, desativado ou inexistente, número inválido, variável inválida) ficam de fora do Reenviar falhados, porque falhariam de novo. Quando a causa estiver corrigida — por exemplo, o template voltou a ser aprovado —, reenvie cada uma pelo Reenviar mesmo assim da linha. - Falhas que nenhum reenvio resolve nunca são reenviadas: envio cancelado, contato sem telefone, consentimento recusado e contato excluído. Um envio cujo resultado ficou incerto (o WhatsApp não confirmou se a mensagem saiu) também não é reenviado, para o contato não receber duas vezes. Se o contato perdeu o telefone, recusou o consentimento ou foi excluído depois da falha, o reenvio o marca como ignorado. - Os gráficos de tendência e os snapshots existem somente em campanhas de WhatsApp e precisam de pelo menos duas capturas para aparecer. - O custo só é exibido em campanhas de WhatsApp Cloud (o WhatsApp Web não é cobrado pela Meta). - Muitas falhas geralmente indicam ritmo de envio agressivo ou número com baixa saúde — reduza o ritmo (maiores atrasos e lotes menores) na próxima campanha. - As taxas são sempre sobre o total de enviadas, não sobre a audiência inicial. Solução de problemas - A campanha pausou sozinha: a Meta recusou o template, ou o envio ficou sem progresso. Leia o aviso no topo da página. Se foi o template, confira o status dele nos templates da caixa de entrada e retome quando ele estiver aprovado de novo; se foi falta de progresso, basta Retomar. - Reenviar falhados agendou menos destinatários do que as falhas da tabela: os demais têm um erro que um reenvio não resolve, ou que depende de uma correção sua. O aviso mostra quantos ficaram de fora e cada linha explica o motivo; depois de corrigir a causa, use Reenviar mesmo assim na linha. - "Este reenvio já está sendo agendado": o mesmo reenvio foi pedido há menos de um minuto (um clique duplo, ou outro administrador ao mesmo tempo). Aguarde a tabela atualizar; não é preciso repetir. - Retomar está bloqueado: o template ainda não está aprovado, ou a plataforma ainda está confirmando o status atual com a Meta. A página se atualiza sozinha e libera o botão quando for possível. - Não aparecem gráficos de tendência: ainda não há snapshots suficientes (são necessários pelo menos dois pontos). Aguarde as próximas capturas e atualize a página. - Sem cartões de custo: a campanha não é de WhatsApp Cloud ou ainda não houve um custo apurável. - Muitas falhas: confira a saúde do número e o ritmo de envio; use Reenviar falhados após corrigir a causa. - Tabela vazia: confirme que a campanha já foi disparada (campanhas em rascunho ou agendadas ainda não têm destinatários processados). Veja também - Campanha de WhatsApp para listas de contatos - Templates HSM e variáveis - Visão geral de Campanhas

Calculadora de custo de disparo do WhatsApp e estimativa da campanha

Visão geral A Calculadora de custo de disparo mostra quanto uma campanha de WhatsApp vai custar antes de enviar e quanto ela custou depois. O cálculo se baseia na tarifa por mensagem que a Meta cobra por categoria de template (marketing, utilidade e autenticação) e no país do destinatário, convertida de USD para BRL pela cotação do dia. Apenas o WhatsApp Cloud é cobrado pela Meta. As caixas de WhatsApp Web não têm cobrança da Meta por mensagem, então aparecem como sem custo (billable: false). A calculadora cobre as três categorias que se disparam em campanha: marketing, utilidade e autenticação. As mensagens de serviço (texto livre dentro da janela de atendimento de 24 horas) não são disparadas em campanha e por isso não têm linha na calculadora. Desde 01/10/2026 há tarifa de serviço. A plataforma estima uma franquia de 1.000 mensagens de serviço gratuitas por mês para cada número, sem tratar esse limite como regra oficial da Meta. Franquia mensal estimada; a Meta não publica esse limite na documentação acompanhada. Acompanhe esse uso na Central de custos do WhatsApp. A plataforma usa esse mesmo número em dois lugares: a calculadora (uma simulação "e se") e a estimativa de custo do público que aparece no compositor da campanha. Pré-requisitos - Acesso ao módulo Campanhas. - Para custo cobrado: uma caixa de entrada de WhatsApp Cloud conectada (Web não gera custo Meta). - A categoria do template definida na campanha — marketing, utilidade ou autenticação. É a categoria que determina a tarifa por mensagem. Passo a passo 1. Abra Campanhas na barra lateral. 2. Abra a Calculadora de disparo (botão da calculadora na tela de campanhas). 3. Escolha o país dos destinatários no seletor (ex.: BR, US, MX...). 4. Para cada categoria (marketing, utilidade, autenticação), informe a quantidade de mensagens. 5. Veja, por linha, a tarifa por mensagem (em USD) e o total em BRL. 6. Confira o custo total estimado em destaque (USD e BRL) e o número de mensagens cobráveis. No compositor da campanha, ao definir a audiência e a categoria, a plataforma também mostra o custo estimado do público resolvido (etiquetas, contatos específicos, segmentos salvos ou todos), já em BRL. Configurações & opções - Tarifas por categoria (USD): cada categoria tem uma tarifa por mensagem por país, conforme a tabela oficial da Meta em vigor, hoje a de 01/10/2026. No Brasil ela não mudou em relação à anterior: marketing US$ 0,0625 e utilidade ou autenticação US$ 0,0068 por mensagem (na tabela em reais da Meta, R$ 0,3217 e R$ 0,0350). Em outros mercados houve mudanças, como México, Arábia Saudita, Emirados Árabes Unidos, Paquistão, Peru e África do Sul. - Data da tabela: a calculadora mostra a data da tabela oficial que está usando. Se nenhuma tabela oficial estiver carregada, ela avisa que usa a tabela de referência interna da plataforma, em vez de mostrar uma data. - Utilidade dentro da janela: desde 01/10/2026 a Meta cobra também a mensagem de utilidade enviada a quem está com a janela de atendimento de 24 horas aberta. Antes ela saía grátis nesse caso. - Conversão USD → BRL: usa a cotação ao vivo do dia (cache de ~1h). Use Atualizar para buscar uma cotação nova ignorando o cache, ou Ajustar para informar manualmente uma taxa "e se". - Origem da cotação: o selo indica se a taxa é ao vivo, estimada (fallback quando a cotação não está disponível) ou manual. - Tarifa editável pelo admin (override): a Meta não tem API de preços, então um administrador pode editar a tarifa por categoria/país com o preço real negociado. A linha ganha o selo personalizada. Deixar o campo da tarifa em branco e salvar restaura a tarifa oficial/ sincronizada. - Sincronizar (oficial): lê a tabela de tarifas publicada pela Meta (a tabela em USD da página de preços para desenvolvedores) e atualiza as tarifas por país e categoria. As linhas atualizadas passam a aparecer com origem sincronizada. Um override do administrador continua vencendo a tarifa sincronizada — sincronizar não apaga o preço que você negociou. Se a leitura falhar, nada é alterado: a tabela editável/base continua valendo. - Fonte alternativa de tarifas: se preferir alimentar as tarifas por conta própria, aponte a variável de ambiente WHATSAPP_PRICING_SOURCE_URL para um endpoint JSON ou CSV com a tarifa por país e categoria. A plataforma usa essa fonte no lugar da página oficial. - Estimativa de custo do público (no compositor): ao escolher audiência + categoria, a plataforma resolve os contatos com telefone e devolve o custo estimado em BRL e se é cobrável. - Custo estimado vs. custo real na campanha: a campanha guarda o custo estimado (estimated_cost), o custo real (actual_cost) e a moeda (currency, padrão BRL). O custo estimado é gravado na criação (apenas Cloud); o custo real vai sendo acumulado conforme as mensagens cobráveis (entregues/lidas/respondidas) são contabilizadas. - Com a Central de custos do WhatsApp ligada: o custo real passa a ser a soma das mensagens que a Meta confirmou como entregues e cobráveis, calculada mensagem a mensagem pela tabela oficial, no mercado do número e na moeda da WABA, e é atualizado em cerca de 10 segundos. Falhas e mensagens ignoradas nunca somam, e um reenvio soma ao destinatário. O preço congelado no envio continua visível como Estimativa no disparo. A calculadora continua funcionando como antes (USD por país); a tarifa por mercado e moeda se edita em Relatórios → Custos do WhatsApp → Tabelas de preço. Casos de uso - Orçar uma promoção: simule 10.000 mensagens de marketing para o Brasil e veja o total em BRL antes de aprovar. - Comparar categorias: veja a diferença de preço entre marketing, utilidade e autenticação para escolher o melhor formato. - Validar a cobrança: registre o preço real negociado com a Meta na tarifa editável e compare o custo estimado com o custo real ao fim da campanha. Dicas, limites e boas práticas - WhatsApp Web não tem custo Meta: linhas e campanhas de Web aparecem como sem custo (billable: false) e não somam ao orçamento. - Restaurar a tarifa oficial: para desfazer um override, deixe o campo da tarifa em branco e salve — isso volta para a tarifa oficial/sincronizada. - Tarifa = preço real: como a Meta não expõe preços por API, mantenha a tarifa editável alinhada ao seu contrato para que a estimativa fique fiel à fatura. - Cotação: se a taxa estiver marcada como estimada, é um fallback — atualize para obter a cotação ao vivo antes de fechar um orçamento. Solução de problemas - Custo aparece R$ 0 ou ausente: a campanha é de WhatsApp Web (sem cobrança Meta) ou o público é muito grande e ultrapassou o limite de estimativa (acima de ~5.000 contatos), caso em que a estimativa é omitida para não travar a criação — o custo real ainda é contabilizado durante o envio. - A tabela não sincroniza: a mensagem diz por quê — a fonte respondeu com erro, não pôde ser acessada, ou respondeu sem tarifas legíveis. Em todos os casos a plataforma mantém a tabela editável/base como fonte de verdade. Se persistir, aponte WHATSAPP_PRICING_SOURCE_URL para um endpoint JSON/CSV próprio ou ajuste a tarifa manualmente. - Sincronizei e a tarifa não mudou: existe um override do administrador para aquele país e categoria — o override vence a tarifa sincronizada. Deixe o campo em branco e salve para restaurar. - Cotação marcada como "estimada": a cotação ao vivo não estava disponível; use Atualizar ou informe uma taxa manual. - A calculadora diz que usa a tabela de referência interna: nenhuma tabela oficial está carregada no momento. A plataforma carrega as tabelas oficiais sozinha; um administrador pode forçar a leitura em Relatórios → Custos do WhatsApp → Tabelas de preço → Sincronizar tabela oficial, que mostra o resultado real, inclusive uma falha. Veja também - Campanha de WhatsApp para listas de contatos - Templates HSM e variáveis - Visão geral de Campanhas - Central de custos do WhatsApp

Campanha de SMS para listas de contatos

Visão geral A campanha de SMS envia uma mensagem de texto para uma lista de contatos de uma só vez, seguindo a mesma lógica das campanhas de WhatsApp. Você define a audiência (por etiquetas), escreve a mensagem e decide quando enviar. A plataforma percorre os contatos da audiência e envia o SMS para cada um que tenha número de telefone. É a ferramenta certa para avisos curtos, confirmações e lembretes — especialmente para alcançar quem não usa WhatsApp, usando o número de SMS da sua conta. Pré-requisitos - Acesso ao módulo Campanhas. - Uma caixa de entrada de SMS conectada (do tipo Twilio SMS ou SMS). - Contatos com número de telefone preenchido — contatos sem telefone são ignorados no envio. - Etiquetas aplicadas aos contatos para definir a audiência. Passo a passo 1. Abra Campanhas na barra lateral e selecione o tipo SMS. 2. Clique em Criar campanha e dê um título. 3. Selecione a caixa de entrada de SMS que fará o envio. 4. Defina a audiência selecionando as etiquetas dos contatos que devem receber. 5. Escreva a mensagem de texto. Você pode inserir variáveis (por exemplo, o nome do contato) para personalizar cada envio. 6. Escolha quando enviar: enviar agora, agendar para uma data/hora ou salvar como rascunho. 7. Confirme e acompanhe o status da campanha na lista. Configurações & opções - Título: identificação interna da campanha. - Caixa de entrada: o número de SMS (Twilio SMS ou SMS) que enviará as mensagens. - Audiência: contatos selecionados por etiquetas; o envio alcança apenas quem tem número de telefone. O compositor mostra uma prévia da quantidade de contatos que serão alcançados. - Mensagem: texto livre, com suporte a variáveis para personalização. SMS é somente texto — não envia imagens ou anexos. - Agendamento: enviar agora ou agendar para uma data/hora futura. - Status: rascunho, agendada, enviando e concluída — acompanhe a evolução pela lista de campanhas. Casos de uso - Enviar um aviso curto (mudança de horário, manutenção, lembrete) ao público certo. - Confirmar um agendamento, pedido ou presença. - Lembrar sobre uma data, vencimento ou compromisso. - Alcançar quem não usa WhatsApp, garantindo a entrega por SMS. Dicas, limites e boas práticas - SMS tem limite de caracteres por mensagem e custo por mensagem cobrado pelo provedor (por exemplo, Twilio). Mensagens longas podem ser divididas em mais de um SMS e cobradas como tal — seja objetivo. - Segmente bem por etiquetas e envie apenas conteúdo relevante para reduzir descadastros e denúncias. - Inclua uma forma de descadastro (por exemplo, instruções para parar de receber), conforme as boas práticas e a regulamentação local. - Teste com uma audiência pequena antes de um envio grande. Solução de problemas - Não consigo selecionar a caixa de entrada: confirme que há uma caixa de entrada de SMS (Twilio SMS ou SMS) conectada na conta. - Audiência vazia: verifique se existem contatos com a etiqueta escolhida e com número de telefone — contatos sem telefone são ignorados. - Falhas no envio: confira a configuração do provedor de SMS (credenciais e saldo da Twilio, por exemplo) e se o número de origem está ativo. Cada envio com erro é registrado e o próximo contato segue normalmente. Veja também - Campanha de WhatsApp para listas de contatos - Visão geral de Campanhas

Definir o público da campanha (etiquetas, contatos, segmentos, CRM e empresas)

Visão geral O público (audiência) define quem recebe uma campanha. Na ConversaLabs você pode mirar por etiquetas (aplicadas aos contatos ou às conversas), contatos específicos, um segmento salvo (de contatos, de conversas ou de empresas), um funil do CRM, empresas ou toda a base. No compositor de campanha, o seletor de público mostra em tempo real quantos contatos com telefone seriam alcançados — antes de você salvar — e, quando houver template e categoria, a estimativa de custo. A diferença que mais confunde: uma etiqueta aplicada a uma conversa não fica no contato. São dois lugares diferentes. Por isso o modo Etiquetas pergunta onde a etiqueta foi aplicada — escolher a origem errada é a causa mais comum de um público que dá zero. Pré-requisitos - Acesso ao módulo Campanhas e uma caixa de entrada conectada (WhatsApp, SMS ou API). - Contatos com telefone preenchido — nos canais que disparam por telefone, só eles entram na contagem e no envio. A exceção é o WhatsApp Cloud: um contato que esconde o número atrás de um nome de usuário e já conversou com a caixa entra pelo ID do WhatsApp vinculado à empresa (BSUID). Um template de autenticação não chega a esses contatos, porque a Meta não o aceita para um BSUID, e eles aparecem como pulados no resultado. A equipe de operação da plataforma libera esse alcance depois de validar um envio de teste. Até lá, esses contatos ficam de fora da campanha, como sempre ficaram. - Conforme o tipo de público escolhido: - Etiquetas: etiquetas aplicadas a contatos e/ou a conversas. - Segmento salvo: um segmento/pasta já salvo (veja Onde criar segmentos, abaixo). - Funil do CRM: um funil com negócios abertos. - Empresas: empresas cadastradas no módulo Empresas. Passo a passo 1. Abra Campanhas, crie ou edite uma campanha e vá até o campo Público. 2. Escolha o tipo de público: Etiquetas, Contatos específicos, Segmento salvo, Funil do CRM, Empresas ou Todos os contatos. 3. Preencha conforme o tipo: - Etiquetas: escolha onde a etiqueta foi aplicada (Nos contatos · Nas conversas · Nos dois). Ao incluir conversas, aparece também a situação da conversa (Todas · Abertas · Pendentes · Adiadas · Resolvidas). Depois selecione uma ou mais etiquetas. - Contatos específicos: digite ao menos 2 letras para buscar e clique para adicionar; os escolhidos viram chips removíveis. - Segmento salvo: escolha a origem (Segmentos de contatos · Pastas de conversas · Segmentos de empresas) e marque um ou mais. - Funil do CRM: escolha o funil e, opcionalmente, uma etapa. - Empresas: escolha entre Segmento salvo de empresas ou Empresas específicas (busca por nome, com 2 letras no mínimo). - Todos os contatos: não há seleção adicional. 4. Confira a prévia ao vivo da contagem (e a estimativa de custo, quando aplicável). 5. Continue montando a campanha e salve. Configurações & opções Os tipos de público: | Tipo | Quem é incluído | |---|---| | Etiquetas | Contatos com qualquer uma das etiquetas, lidas nos contatos, nas conversas ou nos dois | | Contatos específicos | Os contatos escolhidos manualmente na busca | | Segmento salvo | Quem satisfaz um segmento de contatos, uma pasta de conversas ou um segmento de empresas | | Funil do CRM | Contatos dos negócios abertos do funil (opcionalmente de uma etapa só) | | Empresas | Todas as pessoas ligadas às empresas escolhidas | | Todos os contatos | Toda a base da conta | - Origem da etiqueta: Nos contatos é o comportamento histórico (campanhas antigas continuam funcionando exatamente como antes). Nas conversas alcança os contatos por trás das conversas etiquetadas. Nos dois soma as duas leituras. - Situação da conversa: só aparece quando a origem inclui conversas. Todas é o padrão. - CRM — só negócios abertos: um funil mira os negócios que ainda estão em jogo. Negócios ganhos, perdidos ou arquivados não entram. - Empresas — todo mundo, não só o principal: inclui tanto o contato marcado como principal quanto os demais vinculados por participação na empresa. - União de critérios: um contato que atende a mais de um critério entra uma única vez. Selecionar várias etiquetas amplia o alcance (qualquer uma delas), não restringe. - Prévia ao vivo: fica verde quando há pelo menos 1 contato alcançável e âmbar quando é 0. Nos canais por telefone, considera apenas contatos com número preenchido. - Estimativa de custo: com categoria do template e provedor definidos, a prévia mostra o custo estimado em BRL. Vale só para WhatsApp Cloud (cobrado pela Meta); o WhatsApp Web não é cobrado. Acima de 5.000 contatos no Cloud a estimativa é omitida para não travar a tela. A Meta cobra pelo país do telefone do destinatário. Para um contato alcançado só pelo ID do WhatsApp, a estimativa usa o país indicado no próprio ID, e esse valor é uma aproximação. - Lista de descadastro: quem está na lista de descadastro de campanhas da conta nunca recebe campanha, de qualquer categoria ou canal, e a prévia avisa quantos ficaram de fora. - Sem WhatsApp (131026, WhatsApp Cloud): quem teve a última mensagem de campanha recusada com 131026 nos últimos 90 dias, e não escreveu desde então, fica de fora por padrão. A prévia mostra quantos são, e Incluir contatos sem WhatsApp os coloca de volta. - Consentimento (LGPD): quando a conta exige consentimento, quem recusou o tratamento de dados é removido do público — e a prévia avisa quantos foram excluídos. - Quem parou o marketing (WhatsApp Cloud): com um template de marketing, a contagem e a estimativa de custo deixam de fora os contatos que pararam de receber marketing do número da caixa, e a prévia avisa quantos são. - Contatos sem telefone (WhatsApp Cloud): a prévia avisa quantos contatos sem telefone têm o ID do WhatsApp. Depois da liberação, eles são alcançados por esse ID, e o resultado da campanha mostra quantos destinatários foram enviados assim. Antes dela, a prévia avisa que eles ficam de fora até a validação do envio. Onde criar segmentos Cada tipo de segmento nasce em uma tela diferente, e cada um tem um nome próprio na interface. É por isso que um segmento criado em Conversas não aparece na lista de Contatos: | Público | Onde criar | Como se chama na interface | |---|---|---| | Contatos | Contatos → Filtrar → aplicar → Salvar segmento | Segmentos | | Conversas | Conversas → Filtrar → aplicar → salvar | Pastas | | Empresas | Empresas → filtro → salvar | Segmentos | Depois de salvo, o item aparece na origem correspondente do seletor de público. Casos de uso - Falar com quem foi atendido e etiquetado na conversa (ex.: orçamento-enviado), sem precisar etiquetar contato por contato. - Reengajar só as conversas resolvidas de uma etiqueta, para pedir avaliação. - Disparar para um segmento salvo de clientes ativos. - Avisar todos os negócios abertos de uma etapa específica do funil. - Comunicar uma mudança contratual para todas as pessoas de um grupo de empresas. - Enviar para uma lista pontual de contatos escolhidos a dedo. Dicas, limites e boas práticas - Confira a prévia da contagem antes de salvar — ela evita disparos vazios. - Deu zero com etiqueta? Troque a origem para Nas conversas e veja o número mudar. - Para filtros precisos (condições combinadas), crie um segmento e use o tipo Segmento salvo. Várias etiquetas somam (qualquer uma), não fazem interseção. - Mantenha os telefones preenchidos e válidos. - Use Todos os contatos com cautela em bases grandes e combine com o ritmo de envio anti-ban. - A estimativa de custo é uma referência (Cloud); o custo real é apurado sobre os destinatários efetivamente cobrados. Solução de problemas - Contagem 0 com etiqueta: quase sempre a origem está errada. Se você etiqueta conversas, escolha Nas conversas (ou Nos dois). - Contagem 0 com situação da conversa: a situação escolhida pode não ter nenhuma conversa etiquetada. Volte para Todas e confira. - Segmento não aparece na lista: confira a origem selecionada — pastas de conversas não aparecem em segmentos de contatos, e vice-versa. Se ainda não existir, crie na tela indicada em Onde criar segmentos. - Segmento com resultado vazio: confira as condições do filtro salvo. Um filtro inválido não bloqueia a campanha, mas contribui com zero contatos. - Funil sem ninguém: o funil pode não ter negócios abertos — ganhos e perdidos não entram. - Empresa sem ninguém: verifique se há contatos vinculados à empresa. - Custo não aparece: a estimativa só surge com categoria e provedor definidos; no WhatsApp Web não há cobrança. Veja também - Campanha de WhatsApp para listas de contatos - Descadastro de campanhas - Proteção de qualidade, aquecimento e higiene nas campanhas de WhatsApp - Visão geral de Campanhas - Disparos em massa do Flow Builder

Proteção de qualidade, aquecimento e higiene nas campanhas de WhatsApp

Visão geral A Meta avalia a qualidade de cada número de WhatsApp e de cada template. A avaliação usa o retorno dos clientes dos últimos 7 dias, com mais peso para os dias recentes: bloqueios, denúncias, conversas silenciadas e arquivadas. Quando a qualidade cai, a Meta reage sozinha: - um template com qualidade vermelha é pausado por 3 horas na primeira vez, 6 horas na segunda e desativado na terceira (erros 132015 e 132016); - um número que recebe templates de baixa qualidade com frequência pode ter a própria qualidade rebaixada. Para que a campanha não descubra isso tarde demais, depois que a maior parte do público já foi recusada, a plataforma age antes: 1. Pausa preventiva: durante o disparo, consulta a qualidade do número e do template a cada 5 minutos e pausa a campanha quando o número sai do verde ou quando o template cai para amarelo ou vermelho. 2. Confirmação no início: não começa uma campanha num número que não está verde sem a sua confirmação, e não começa em número ou template vermelho. 3. Aquecimento (opcional): começa devagar e só acelera enquanto tudo está verde, com um teto diário opcional. 4. Aviso de disparo paralelo: avisa quando outra campanha já dispara pelo mesmo número. 5. Higiene do 131026: deixa de fora, por padrão, os contatos cujo último envio falhou com 131026 (número sem WhatsApp, termos não aceitos ou aplicativo desatualizado). As regras da Meta citadas aqui foram conferidas na documentação oficial em 01/10/2026. Pré-requisitos - Uma caixa de entrada de WhatsApp conectada pela API oficial (Cloud). - Acesso de administrador para criar, retomar e configurar campanhas. Passo a passo Ver a qualidade antes de disparar 1. Abra Campanhas → WhatsApp e crie uma campanha. 2. Ao escolher a caixa de entrada, veja a qualidade do número (verde, amarela, vermelha ou ainda não avaliada) e a do template escolhido. 3. Se o número estiver amarelo ou ainda não avaliado, ou o template estiver amarelo, a plataforma pede que você confirme que quer disparar mesmo assim, mostrando o motivo. 4. Se o número ou o template estiver vermelho, a campanha não começa. Espere a qualidade voltar ou troque o template. Quando a campanha é pausada pela qualidade 1. Na página da campanha, uma faixa explica o motivo, por exemplo "a qualidade do número caiu para amarela" ou "o template caiu para vermelha", e repete a regra da Meta. 2. Os contatos que ainda não receberam a campanha ficam esperando: ninguém recebe duas vezes. 3. Quando a qualidade voltar ao verde, clique em Retomar. Se quiser continuar num nível amarelo, use Retomar mesmo assim e confirme. A campanha só volta a pausar se a qualidade cair ainda mais. Ligar o aquecimento 1. No formulário da campanha, abra Proteção de qualidade e ligue Aquecimento. 2. Defina a velocidade inicial, de quanto em quanto tempo ela aumenta e, se quiser, um teto diário de mensagens. 3. A velocidade nunca passa do limite do número na Meta. Ao atingir o teto diário, a campanha espera e continua sozinha depois da meia-noite, no fuso da conta. Contatos sem WhatsApp (131026) 1. Quando um envio de campanha falha com 131026, o contato recebe a marca Sem WhatsApp (131026). 2. Nas próximas campanhas, esses contatos ficam de fora por padrão, e a prévia da audiência mostra quantos são. 3. Para incluí-los mesmo assim, marque Incluir contatos sem WhatsApp na audiência. Configurações & opções | Opção | Padrão | Efeito | |---|---|---| | Proteção de qualidade | ligada | Pausa a campanha quando o número sai do verde ou o template cai para amarelo ou vermelho. | | Aquecimento | desligado | Começa em 1 mensagem por segundo e dobra a cada 30 minutos enquanto tudo está verde, até o limite do número. | | Teto diário | vazio | Máximo de mensagens da campanha por dia, no fuso da conta. | | Incluir contatos sem WhatsApp | desligado | Envia também para quem falhou com 131026 nos últimos 90 dias. | A marca do 131026 se desfaz sozinha quando o contato escreve para a empresa, quando o telefone dele muda ou depois de 90 dias. Casos de uso - Base antiga ou comprada: ligue o aquecimento com teto diário para descobrir cedo se a base gera denúncias. - Várias campanhas na mesma semana: escalone os disparos pelo mesmo número em vez de rodá-los em paralelo. - Template novo: acompanhe a qualidade nas primeiras horas. Templates novos começam como "ainda não avaliados". Dicas, limites e boas práticas - Disparos paralelos para a mesma base aceleram as denúncias e derrubam a qualidade do número. - Depois que um template utility é pausado, a Meta pode reter por 7 dias os templates utility novos ou que não estão verdes (pacing). As mensagens retidas são liberadas aos poucos ou descartadas. - O webhook da Meta sobre o número informa só mudanças de vazão. Por isso a plataforma consulta a qualidade a cada 5 minutos, em vez de esperar um aviso. - O 131026 também acontece com quem não aceitou os termos novos ou usa um aplicativo antigo. Por isso a exclusão é temporária. Solução de problemas - A campanha não começou e está pausada: o número não estava verde no horário agendado. Confira a qualidade no WhatsApp Manager e retome confirmando o nível, se for o caso. - "Retomar" está bloqueado: o número ou o template está vermelho, ou o template não está aprovado. Espere a Meta liberar ou troque o template. - Um contato com WhatsApp ficou de fora: abra o contato e veja a marca do 131026. Ela some quando ele escrever para a empresa, ou inclua os contatos sem WhatsApp na campanha. Veja também - Campanha de WhatsApp para listas de contatos - Resultados e análise da campanha de WhatsApp - Descadastro de campanhas - Audiência da campanha

Descadastro de campanhas

Visão geral A lista de descadastro é da conta inteira. Um contato que está nela não recebe nenhuma campanha, de qualquer categoria (marketing, utilidade ou autenticação) e em qualquer canal (WhatsApp oficial ou Web, SMS e API). O contato entra na lista de três formas: - envia exatamente uma das palavras de descadastro, como "parar" ou "sair"; - toca num botão de resposta rápida do template cujo texto é uma dessas palavras, por exemplo "Pausar mensagens"; - um administrador o adiciona pela tela de descadastro. Esta lista é diferente do "Parar promoções" do próprio WhatsApp, que o cliente aciona dentro do aplicativo. Aquele vale só para marketing e só para o número que ele bloqueou, e a plataforma já o respeita sozinha. As duas proteções funcionam juntas. Pré-requisitos - Acesso de administrador para ver a lista, adicionar ou tirar contatos e mudar as configurações. - Para o botão funcionar, o template precisa de um botão de resposta rápida com o texto da palavra de descadastro. Passo a passo Ver a lista 1. Abra Campanhas → Descadastros. 2. Busque por nome, telefone ou e-mail. 3. Cada linha mostra como o contato entrou, desde quando, a palavra que ele enviou e o link da conversa. Configurar as palavras e a confirmação 1. Clique em Configurar descadastro. 2. Revise as palavras de descadastro, uma por linha. Acentos, maiúsculas, emojis e pontuação nas pontas são ignorados: "⏸️ Pausar mensagens" vale como "pausar mensagens". 3. Opcional: defina palavras para voltar a receber campanhas. 4. Opcional: ligue Enviar confirmação ao contato e escreva o texto em português, inglês e espanhol. 5. Clique em Salvar configurações. Adicionar ou tirar um contato 1. Adicionar contato: escolha o contato, escreva uma observação (por exemplo "pediu por telefone") e confirme. 2. Tirar da lista: clique em Tirar da lista na linha do contato e confirme. Faça isso só quando o contato pedir para voltar a receber campanhas. Configurações & opções | Opção | Padrão | Observação | |---|---|---| | Reconhecer palavras de descadastro | ligado | Desligado, só administradores adicionam contatos. | | Palavras de descadastro | parar, sair, pausar mensagens, descadastrar, stop, unsubscribe, baja | A mensagem inteira precisa ser igual à palavra. | | Palavras para voltar | vazio | Tiram o contato da lista. | | Enviar confirmação ao contato | desligado | Ligue só se nenhum fluxo ou robô já responde ao botão. | Casos de uso - Botão "Pausar mensagens" no template: o toque do cliente passa a descadastrá-lo de verdade, em vez de só virar uma mensagem de texto na conversa. - Pedido por telefone ou e-mail: o administrador adiciona o contato com uma observação. - Auditoria LGPD: o histórico mostra quando e como cada contato entrou ou saiu. Dicas, limites e boas práticas - A correspondência é exata: "não quero sair agora" não descadastra ninguém, só "sair" sozinho. - Prefira palavras curtas e inequívocas. Evite palavras comuns numa conversa, como "ok" ou "não". - Se um fluxo já responde ao botão de descadastro, deixe a confirmação desligada para o contato não receber duas respostas. - A prévia da audiência mostra quantos contatos ficaram de fora por estarem na lista. - Limitação conhecida: a lista fica no histórico de consentimentos do contato. Se os dados do contato forem eliminados a pedido do titular (LGPD), o lugar dele na lista é eliminado junto. Um contato recriado depois volta a receber campanhas até se descadastrar de novo. Solução de problemas - O contato tocou no botão e não entrou na lista: confira se o texto do botão está nas palavras de descadastro e se o reconhecimento está ligado. - O contato recebeu duas respostas: desligue Enviar confirmação ao contato ou o fluxo que responde ao botão. - Um contato que saiu da lista continua sem receber: confira se ele parou as promoções dentro do WhatsApp. Esse bloqueio é do próprio cliente e vale para campanhas de marketing. Veja também - Proteção de qualidade, aquecimento e higiene nas campanhas de WhatsApp - Audiência da campanha - Campanha de WhatsApp para listas de contatos