Central de Dúvidas · 100 respostas
Dúvidas sobre a API oficial do WhatsApp
Respostas diretas para quem está saindo de ferramentas não oficiais, recuperando números bloqueados ou começando a operar pela WhatsApp Cloud API.
10 respostas
Migração e bloqueio
Número banido, ferramentas não oficiais e como migrar para a API oficial com segurança.
Ver perguntas10 respostas
Fundamentos da API
O que é a WhatsApp Business Platform, Cloud API, BSP, WABA e Embedded Signup.
Ver perguntas8 respostas
Preços da Meta
Precificação por mensagem, utilidade, marketing, autenticação e janelas grátis.
Ver perguntas8 respostas
Templates e limites
Templates aprovados, tiers de envio, qualidade do número e opt-in.
Ver perguntas8 respostas
Dúvidas técnicas
Webhooks, CRM, CTWA, CAPI, Google Ads e embed do inbox.
Ver perguntas6 respostas
Operação e casos de uso
Agências, white-label, LGPD, IA, ROI e e-commerce no WhatsApp oficial.
Ver perguntas10 respostas
Disparo seguro e volume
Campanhas em massa pela API oficial: planilha, tags, agendamento, limites e acompanhamento.
Ver perguntas9 respostas
Atendimento e equipes
Setores, múltiplos atendentes, tags, notas internas, filtros e métricas da operação.
Ver perguntas11 respostas
Rastreamento de leads e ROI
Origem do anúncio, UTMs, custo por conversa, CAPI, Google Ads e leads quentes/frios.
Ver perguntas8 respostas
Automação e IA
Agentes de IA, follow-up automático, janela de 24 horas, cooldown e combinação com humano.
Ver perguntas7 respostas
Gestão comercial e contatos
Kanban de orçamentos, catálogo, importação de contatos, funil e templates na plataforma.
Ver perguntas5 respostas
Integração, embed e agências
Embed no CRM, API pública, multi-tenant, white-label e conexão OAuth com Ads.
Ver perguntasMigração e bloqueio
Número banido, ferramentas não oficiais e como migrar para a API oficial com segurança.
- Meu número de WhatsApp foi banido. O que fazer agora?Verifique o motivo do banimento dentro do próprio app, solicite revisão pelo suporte oficial da Meta e, se usava uma ferramenta não oficial, migre para a API oficial do WhatsApp para evitar novos bloqueios.
- Por que a Meta bloqueia números que usam ferramentas não oficiais?Ferramentas não oficiais, como WhatsApp Web modificado, apps multidispositivo não autorizados ou APIs não homologadas, violam os Termos de Serviço do WhatsApp e comprometem a segurança dos usuários, por isso a Meta detecta e bane esses números.
- Como migrar de uma ferramenta não oficial para a API oficial do WhatsApp?A migração envolve escolher um provedor (BSP) homologado pela Meta, verificar a empresa, registrar o número na WABA e, quando possível, usar o modo de coexistência para reduzir o impacto da transição.
- Posso recuperar um número banido do WhatsApp?Sim, em muitos casos é possível solicitar revisão do banimento diretamente no app ou pelo suporte da Meta, mas a chance de recuperação cai bastante quando o número usava ferramentas não oficiais.
- Como usar o mesmo número no aplicativo e na API oficial (modo coexistência)?O modo de coexistência da Meta permite manter o WhatsApp Business app e a API oficial ativos no mesmo número simultaneamente, sincronizando contatos e parte do histórico durante a transição.
- Perco meu histórico de conversas ao migrar para a API oficial?Depende do caminho escolhido: migrar do app para a API usando o modo de coexistência preserva parte do histórico, mas migrar de uma ferramenta não oficial ou trocar de número normalmente não transfere as conversas antigas.
- Qual a diferença entre banimento temporário e permanente no WhatsApp?O banimento temporário costuma durar horas ou poucos dias e pode ser revertido automaticamente ou por revisão, enquanto o permanente bloqueia o número definitivamente e tem baixa chance de reversão mesmo após contestação.
- Como saber se a ferramenta que uso é oficial ou não oficial?Ferramentas oficiais usam a WhatsApp Business Platform por meio de um BSP homologado pela Meta e não exigem escanear QR code ou manter o celular conectado; se a sua pede isso, provavelmente é não oficial.
- Quanto tempo leva para migrar para a API oficial do WhatsApp?Uma migração simples pode levar de 1 a 3 dias úteis, mas o prazo total depende da verificação da empresa pela Meta, que pode variar de algumas horas a algumas semanas em casos que exigem documentação extra.
- Meus contatos e grupos continuam funcionando na API oficial?Seus contatos continuam recebendo mensagens normalmente após a migração, mas a API oficial do WhatsApp Business Platform não tem suporte a grupos: ela funciona apenas para conversas individuais entre a empresa e cada cliente.
Fundamentos da API
O que é a WhatsApp Business Platform, Cloud API, BSP, WABA e Embedded Signup.
- O que é a API oficial do WhatsApp (WhatsApp Business Platform)?É a plataforma da Meta para empresas enviarem e receberem mensagens de WhatsApp de forma programática e em escala, integrada a sistemas como CRM e chatbots, seguindo regras de qualidade e cobrança por template.
- Qual a diferença entre WhatsApp Business (app) e WhatsApp Business API?O WhatsApp Business é um aplicativo gratuito para um único usuário por número, enquanto a API é uma plataforma sem interface própria, feita para múltiplos atendentes, automações e alto volume de mensagens.
- O que é a WhatsApp Cloud API e qual a diferença para a On-Premise?A Cloud API é hospedada diretamente pela Meta, com configuração mais rápida e sem servidor próprio, enquanto a On-Premise exigia infraestrutura própria da empresa ou do BSP e está descontinuada para novos cadastros.
- O que é um BSP (Business Solution Provider) da Meta?Um BSP é uma empresa homologada pela Meta para oferecer acesso à API oficial do WhatsApp a outros negócios, cuidando de infraestrutura, suporte técnico e, em muitos casos, de uma plataforma de atendimento.
- O que é uma WABA (WhatsApp Business Account)?A WABA é a conta que representa sua empresa dentro do ecossistema oficial do WhatsApp, agrupando números de telefone, templates aprovados, métricas de qualidade e configurações de cobrança.
- O que é o Embedded Signup da Meta?É o fluxo oficial da Meta que permite conectar ou criar uma WABA, verificar a empresa e registrar um número de telefone diretamente dentro do painel do provedor, sem precisar configurar tudo manualmente no Meta Business Manager.
- Preciso de CNPJ para usar a API oficial do WhatsApp?Não é obrigatório ter CNPJ para começar a configuração, mas a verificação completa da empresa (Meta Business Verification) e o selo de negócio verificado geralmente exigem documentação de pessoa jurídica.
- A API oficial do WhatsApp tem aplicativo? Como envio e recebo mensagens?Não existe um aplicativo oficial para a API: as mensagens são enviadas e recebidas por integração de sistema (webhooks e requisições) ou por meio de um painel/inbox fornecido por um provedor BSP sobre a Cloud API.
- Posso ter mais de um atendente no mesmo número com a API oficial?Sim, esse é um dos principais motivos para migrar: a API oficial permite múltiplos atendentes trabalhando simultaneamente no mesmo número, com distribuição de conversas e controle de acesso por usuário.
- O que é verificação da empresa (Meta Business Verification) e quando é exigida?É o processo em que a Meta confirma a identidade legal do negócio, exigido para aumentar limites de mensagens, obter o selo verde de verificado e habilitar recursos mais avançados da API.
Preços da Meta
Precificação por mensagem, utilidade, marketing, autenticação e janelas grátis.
- Quanto custa a API oficial do WhatsApp? Como funciona a precificação da Meta?Desde 1º de julho de 2025 a Meta cobra por mensagem de template entregue, dividida nas categorias marketing, utilidade e autenticação, com valores que variam por país; mensagens de atendimento dentro da janela de 24h são gratuitas.
- O que são mensagens de utilidade (utility) e quanto custam?Mensagens de utilidade são templates transacionais relacionados a uma compra ou conta já existente, como confirmações e atualizações de pedido; custam menos que marketing e são gratuitas quando enviadas dentro de uma janela de atendimento aberta.
- O que são mensagens de marketing no WhatsApp e quanto custam?São templates promocionais ou de comunicação não essencial, enviados fora do atendimento; é a categoria mais cara da Meta, com custo aproximado de US$ 0,0625 por mensagem entregue no Brasil.
- O que são mensagens de autenticação e quando usar?São templates usados para enviar códigos de verificação (OTP) e confirmar identidade em processos como login ou recuperação de senha; têm um dos menores custos entre as categorias pagas, com descontos por volume.
- O que é a janela de atendimento de 24 horas e o que é gratuito dentro dela?É o período de 24 horas após a última mensagem do cliente em que a empresa pode responder livremente com mensagens de sessão e templates de utilidade sem custo adicional por mensagem.
- Conversas iniciadas por anúncio (CTWA) são gratuitas? Como funciona a janela de 72 horas?Sim: quando um cliente clica em um anúncio Click to WhatsApp e inicia a conversa, todas as mensagens trocadas nas 72 horas seguintes são gratuitas, incluindo templates que normalmente seriam cobrados.
- Como a Meta cobra: por conversa ou por mensagem? O que mudou na precificação?Até junho de 2025 a Meta cobrava por conversa de 24 horas; desde 1º de julho de 2025 o modelo passou a ser por mensagem de template entregue, tornando o custo mais proporcional ao volume real de envios.
- Como reduzir o custo por mensagem na API oficial do WhatsApp?Priorize responder dentro da janela de atendimento de 24 horas, use a categoria correta de template (utility em vez de marketing quando aplicável), aproveite a janela gratuita de CTWA e acompanhe descontos por volume.
Templates e limites
Templates aprovados, tiers de envio, qualidade do número e opt-in.
- O que são templates de mensagem e por que a Meta exige aprovação?Templates são modelos de mensagem pré-aprovados pela Meta, usados para iniciar conversa fora da janela gratuita de 24 horas. A aprovação prévia garante que mensagens enviadas sem uma troca ativa não sejam spam, phishing ou abuso.
- Como criar um template que a Meta aprova (e os motivos mais comuns de rejeição)?Um template aprova mais rápido quando segue as políticas comerciais da Meta, usa variáveis coerentes com o contexto, evita linguagem genérica ou enganosa e está na categoria correta. A maioria das rejeições acontece por conteúdo promocional classificado como utilidade, variáveis sem contexto ou uso de termos proibidos.
- Quais são as categorias de template (marketing, utilidade, autenticação) e como a Meta classifica?A Meta divide templates em três categorias, marketing, utilidade e autenticação, de acordo com a finalidade do conteúdo, não com o texto literal. A classificação é feita por revisão automatizada e humana, e pode ser corrigida pela Meta mesmo que a empresa tenha marcado outra categoria na submissão.
- O que são os limites de envio (tiers) e como aumentar o meu?Tier é o número máximo de contatos únicos que um número pode iniciar conversa por template em uma janela de 24 horas. O limite sobe automaticamente quando o número mantém boa qualidade e usa volume consistente próximo do teto atual por um período contínuo, sem intervenção manual da empresa.
- O que é a classificação de qualidade do número (verde, amarelo, vermelho)?É um indicador da Meta que resume como os contatos reagem às mensagens do número nos últimos dias, com base em bloqueios, denúncias e feedback de conversa. Verde é saudável, amarelo é atenção e vermelho pode levar à pausa temporária de envios por template.
- Posso fazer disparo em massa pela API oficial sem ser bloqueado?A API oficial não bane números do mesmo jeito que ferramentas não oficiais, mas impõe limites de tier, exige templates aprovados e penaliza queda de qualidade. Disparo em massa é possível dentro desses limites, desde que a lista tenha opt-in real e o volume respeite o tier atual do número.
- O que acontece se muitos contatos denunciarem ou bloquearem meu número?Denúncias e bloqueios são o principal insumo da classificação de qualidade. Em volume alto, derrubam a qualidade para vermelho, podem congelar ou reduzir o tier de envio e, em casos extremos e recorrentes, levar à restrição da conta de WhatsApp Business (WABA) pela Meta.
- O que é opt-in no WhatsApp e por que é obrigatório?Opt-in é o consentimento explícito do contato para receber mensagens da empresa pelo WhatsApp, dado em formulário, checkbox, SMS ou outro canal. A Meta exige opt-in documentado, e sua ausência é a principal causa de denúncias, bloqueios e queda de qualidade do número.
Dúvidas técnicas
Webhooks, CRM, CTWA, CAPI, Google Ads e embed do inbox.
- O que são webhooks do WhatsApp e para que servem?Webhooks são chamadas HTTP que a Meta envia automaticamente para um servidor da empresa sempre que algo acontece na conta: mensagem recebida, mudança de status de entrega, atualização de qualidade ou aprovação de template. Sem webhook configurado, a empresa não tem como saber em tempo real que um cliente respondeu.
- Como funciona a integração da API oficial com CRM?A integração usa webhooks para receber mensagens e status e chamadas de API para enviar, sincronizando contatos e histórico com o CRM. Pode ser feita com desenvolvimento próprio, por um provedor que entrega a ponte pronta ou por um widget embutido no próprio CRM.
- O que é o selo de verificação (antiga conta verde) e como conseguir?O selo de verificação confirma que o número pertence a uma empresa autenticada pela Meta, mas não é liberado automaticamente ao contratar a API oficial. Ele depende de aprovação separada de identidade de negócio (Business Verification) e, em muitos casos, da assinatura do Meta Verified for Business.
- Como configurar nome de exibição (display name) do número na API oficial?O nome de exibição é definido na submissão do número dentro do Meta Business Manager e passa por revisão da Meta antes de valer para os usuários. Ele precisa refletir o nome real da empresa ou marca registrada, sem termos genéricos, promocionais ou enganosos.
- O que é CTWA (click to WhatsApp) e como rastrear anúncios que levam ao WhatsApp?CTWA são anúncios da Meta com botão que abre diretamente uma conversa de WhatsApp. O rastreamento é mais difícil que em um site comum porque não existe pixel dentro do aplicativo de WhatsApp: a origem do clique precisa ser capturada no momento do clique e associada manualmente à conversa que se abre em seguida.
- O que é a API de Conversões (CAPI) da Meta e como devolver conversões do WhatsApp?CAPI é a API de Conversões da Meta, que permite enviar eventos de conversão diretamente do servidor da empresa, sem depender de pixel no navegador. Para o WhatsApp, ela é o único caminho viável de atribuição, já que a conversa acontece fora de qualquer página web rastreável.
- Como rastrear leads do Google Ads que chegam pelo WhatsApp (gclid)?O gclid, identificador de clique do Google Ads, precisa ser capturado no momento do clique e associado à conversa que se abre no WhatsApp. Quando a conversa converte, o resultado volta ao Google Ads como conversão offline referenciando esse gclid.
- É possível embutir o atendimento do WhatsApp dentro de outro sistema (iframe/SDK)?Sim. É um padrão comum para software houses: um SDK em JavaScript carrega o inbox de WhatsApp dentro de um iframe embutido na interface do sistema host, autenticado por token, trocando eventos com a página por mensagens entre janelas.
Operação e casos de uso
Agências, white-label, LGPD, IA, ROI e e-commerce no WhatsApp oficial.
- Como agências gerenciam vários números de WhatsApp de clientes em uma plataforma?Agências precisam de estrutura multi-conta: um número de WhatsApp por cliente, permissões separadas por equipe e templates e relatórios isolados por conta. É diferente de operar vários clientes na mesma conta de WhatsApp, algo que a Meta não recomenda.
- O que é white-label em plataforma de WhatsApp?White-label é operar a plataforma de atendimento de WhatsApp com a marca do parceiro (agência ou software house), não a marca do fornecedor original: domínio próprio, logo próprio e, em alguns casos, cobrança própria ao cliente final, enquanto a infraestrutura técnica continua sendo do provedor.
- A API oficial do WhatsApp atende LGPD? Quais cuidados com dados dos contatos?A API oficial é uma infraestrutura de mensageria, não uma certificação automática de conformidade: o cumprimento da LGPD depende do uso, coleta de opt-in, finalidade declarada do contato e forma de armazenamento e exclusão do histórico de conversas.
- Chatbot e agente de IA funcionam na API oficial do WhatsApp?Sim, chatbots e agentes de IA funcionam normalmente na API oficial, integrando um modelo de linguagem à camada de webhooks e envio de mensagem. A regra da janela de 24 horas também vale para respostas automáticas: fora dela, mesmo uma resposta de IA precisa ser um template aprovado.
- Como medir ROI de campanhas que geram conversas no WhatsApp?Medir ROI no WhatsApp exige juntar três números que normalmente vivem em sistemas separados: custo de mídia (anúncio), custo de mensageria (categoria do template usado) e resultado de negócio gerado pela conversa. Sem unir essas três pontas, o WhatsApp aparece como custo isolado em vez de canal de receita.
- WhatsApp oficial para e-commerce: carrinho, catálogo e mensagens de pedido, como funciona?A API oficial permite exibir catálogo de produtos dentro da conversa, receber pedidos com carrinho nativo e enviar atualizações de pedido (confirmação, envio, entrega) como templates de utilidade, geralmente integrados a uma plataforma de e-commerce por trás.
Disparo seguro e volume
Campanhas em massa pela API oficial: planilha, tags, agendamento, limites e acompanhamento.
- Como disparar mensagens em massa no WhatsApp sem ser bloqueado?Na API oficial, disparo em massa seguro depende de opt-in real, template aprovado pela Meta, volume dentro do tier do número e ritmo de envio controlado. Sem esses cuidados, a qualidade do número cai e o envio pode ser limitado.
- Como enviar mensagens em massa no WhatsApp a partir de uma planilha?Enviar em massa pela API exige chamar o endpoint de mensagem uma vez por contato, com template e variáveis de cada linha. Plataformas de disparo fazem isso a partir de uma planilha Excel com contatos e colunas de personalização.
- Como personalizar disparos com nome e dados de cada cliente (variáveis)?Templates da API oficial aceitam variáveis (como {{1}}) preenchidas de forma diferente para cada destinatário, permitindo personalizar nome, valor, data ou qualquer outro dado no texto aprovado pela Meta.
- Como agendar um disparo de WhatsApp para data e horário específicos?A API oficial não tem agendamento nativo: ela envia no momento da chamada. Agendar data e horário, e cancelar enquanto a campanha ainda está programada, é função da ferramenta de disparo por cima da API.
- Como disparar mensagens para contatos segmentados por tags?A API oficial não tem tags nativas de contato: a segmentação fica a cargo de quem gerencia a base. Tags aplicadas aos contatos na plataforma de atendimento podem servir de audiência para uma campanha, no lugar de uma planilha.
- Qual volume de mensagens posso enviar por dia no WhatsApp oficial?O volume máximo é definido pelo tier do número: de cerca de 250 contatos únicos por 24 horas no tier inicial até 100 mil ou mais em tiers avançados. Os tetos são da Meta e podem mudar.
- Como acompanhar uma campanha de disparo em tempo real (enviadas e falhas)?A API oficial retorna o status de cada mensagem individualmente, sem visão agregada pronta. Uma plataforma de disparo consolida enviadas, falhas e progresso da campanha em tempo real conforme o envio avança.
- Por que mensagens de um disparo falham e como corrigir?As causas mais comuns de falha são número inválido ou sem WhatsApp, template pausado ou rejeitado, e volume acima do tier disponível no dia. Acompanhar a taxa de falha por campanha ajuda a achar se o problema está na lista, no template ou no limite.
- Como aumentar o limite de envio de um número novo (aquecimento)?O aumento de tier é automático e depende de manter qualidade estável com volume consistente ao longo do tempo. Não existe pedido manual. Aquecer com ritmo controlado e uso gradual do limite acelera a evolução.
- Disparo em massa ou anúncio click to WhatsApp: quando usar cada um?Disparo em massa é a empresa iniciando contato com uma base que já existe; CTWA é o próprio usuário clicando em um anúncio para começar a conversa. São canais complementares: um reengaja quem já é contato, o outro capta gente nova que ainda não conhece a empresa.
Atendimento e equipes
Setores, múltiplos atendentes, tags, notas internas, filtros e métricas da operação.
- Como organizar o atendimento do WhatsApp em setores (comercial, suporte, financeiro)?A API oficial entrega mensagens em um único fluxo por número, sem separação nativa por área. É a plataforma de atendimento que organiza conversas em setores (comercial, suporte, financeiro) e permite filtrar o inbox por essa divisão.
- Como vários atendentes usam o mesmo número de WhatsApp ao mesmo tempo?Diferente do WhatsApp comum, a API oficial não depende de um único aparelho logado. Várias pessoas podem atender ao mesmo tempo pelo mesmo número através de uma plataforma multiusuário com login próprio para cada atendente.
- Como atribuir conversas do WhatsApp a atendentes específicos?A API oficial trata todas as mensagens de um número de forma igual, sem noção de responsável por conversa. É a plataforma de atendimento que implementa a atribuição manual ou automática a um atendente específico.
- Como usar tags para organizar e filtrar conversas e contatos?Tags não existem na API oficial. São um recurso da plataforma de atendimento. Aplicadas aos contatos, servem para filtrar o inbox e também como audiência de campanhas de disparo.
- Como registrar notas internas na conversa sem o cliente ver?A API oficial não separa mensagem visível de anotação interna: tudo que passa por ela vai para o cliente. Notas internas ficam só na camada de atendimento, visíveis à equipe, sem nunca serem enviadas ao contato.
- Como filtrar conversas por status, setor, atendente e origem do lead?A API oficial entrega as mensagens em ordem cronológica, sem filtros. Quem organiza é a plataforma de atendimento, com filtros por status, atendente, tag, setor, origem do lead, busca e período.
- Como enviar e receber áudio, imagem, vídeo e documentos pela API oficial?A Cloud API suporta texto, imagem, áudio, nota de voz, vídeo, documento, localização, figurinha e template. Em um inbox sobre a API, esses formatos aparecem e podem ser enviados na mesma conversa.
- Como medir a operação de atendimento no WhatsApp: conversas novas, resolvidas e por atendente?A API oficial não gera relatório de operação: cada evento chega isolado via webhook, cabendo à plataforma consolidar isso em métricas. Um painel típico reúne conversas novas, resolvidas, em aberto e a distribuição por setor e atendente.
- Como funciona a resolução automática de conversas inativas?A API oficial não fecha conversa sozinha. O conceito de conversa resolvida existe só na plataforma de atendimento. É comum configurar horas de inatividade após as quais a conversa é marcada como resolvida automaticamente.
Rastreamento de leads e ROI
Origem do anúncio, UTMs, custo por conversa, CAPI, Google Ads e leads quentes/frios.
- Como saber de qual anúncio veio cada lead do WhatsApp?Não existe pixel dentro do WhatsApp: a referência do anúncio precisa ser capturada na primeira mensagem via webhook e amarrada à conversa, classificando a origem em canais como CTWA, Google Ads, site ou direto.
- Como rastrear UTMs de campanhas que levam ao WhatsApp?UTMs funcionam em uma URL de site, mas se perdem quando o link vai direto ao WhatsApp, a menos que sejam capturados antes do redirecionamento e associados à conversa criada em seguida.
- Como medir custo por conversa em campanhas Meta Ads e Google Ads?Custo por conversa cruza o investimento em mídia com o número de conversas de WhatsApp geradas. Conta que Meta Ads e Google Ads não fazem sozinhos, exigindo ligar cada conversa ao canal e à campanha de origem.
- Como identificar leads quentes e frios no WhatsApp?A API do WhatsApp não classifica leads: isso é uma camada de análise sobre o histórico da conversa. Contatos podem ser marcados como quentes ou frios conforme engajamento e origem, para priorizar o time comercial.
- Como enviar conversões do WhatsApp de volta para o Meta Ads (CAPI)?A API de Conversões (CAPI) da Meta permite enviar pelo servidor um evento de conversão ligado ao clique original do anúncio. É o caminho viável para reportar vendas do WhatsApp sem depender de pixel no navegador.
- Como enviar conversões do WhatsApp para o Google Ads?O Google Ads recebe conversões de fora do site por upload offline, referenciando o gclid capturado no clique. É preciso guardar o gclid junto à conversa e enviar a conversão quando o funil indica resultado de negócio.
- O que são sessões de rastreamento e como ligam o clique do site à conversa?Uma sessão de rastreamento é o registro criado no momento do clique, com UTM, gclid, fbclid ou outro identificador disponível, que fica aguardando até a primeira mensagem de WhatsApp chegar para então ser associada àquela conversa específica. É essa ponte que permite ligar origem de mídia paga a um atendimento real.
- Como comparar canais de origem: CTWA, Google Ads, site orgânico e direto?Cada canal de origem representa uma forma diferente de o lead chegar ao WhatsApp, com custo e intenção distintos. Classificar conversas por canal permite comparar volume, custo por conversa e avanço no funil lado a lado.
- Como identificar a campanha pela primeira mensagem do lead (sem parâmetro de clique)?Sem gclid, fbclid ou referência do anúncio, a origem é inferida por outros sinais: número usado, conteúdo da primeira mensagem ou uma sessão de rastreamento aberta pouco antes do contato.
- Como ver métricas de Meta Ads e Google Ads junto com as conversas geradas?Meta Ads e Google Ads mostram gasto, cliques e impressões, mas não sabem quantas conversas de WhatsApp cada campanha gerou. É preciso conectar as contas e cruzar investimento com conversas atribuídas.
- Como provar o ROI do tráfego pago que gera conversas no WhatsApp?Provar ROI exige juntar três pontas: quanto foi investido em mídia, quantas conversas de WhatsApp o investimento gerou e quanto virou negócio, da origem do clique à conversão devolvida às plataformas de ads.
Automação e IA
Agentes de IA, follow-up automático, janela de 24 horas, cooldown e combinação com humano.
- Como colocar um agente de IA para atender no WhatsApp?Configura-se um agente com prompt de sistema, modelo e parâmetros de geração, habilitam-se os serviços que ele pode acionar, consultar produtos, criar orçamento, e testa-se o comportamento em um chat de teste antes de publicar no atendimento.
- Como fazer follow-up automático com leads que pararam de responder?Cria-se uma automação com uma condição baseada em tempo desde a última mensagem do contato (combinada, se quiser, com status, setor ou tags) e uma ação de envio de texto livre ou template. Se o tempo parado já ultrapassou a janela de 24 horas, a ação precisa ser obrigatoriamente um template aprovado.
- Como enviar mensagem automática antes da janela de 24 horas expirar?Configura-se uma condição baseada no tempo já decorrido desde a última mensagem do contato, disparando texto livre enquanto a janela de atendimento ainda está aberta. Não é possível estender a janela, a automação só aproveita o tempo que ainda resta dela antes de fechar.
- Como a IA consulta produtos e cria orçamentos durante a conversa?O agente de IA usa serviços pré-definidos habilitados na sua configuração, como consultar produtos e buscar ou criar orçamento, chamando essas ações durante a conversa quando o contexto e o prompt indicam necessidade, sem depender de um atendente humano digitando os dados manualmente no sistema.
- Como limitar automações por dias da semana e horário?Cada automação pode ter uma janela ativa configurada por dias da semana e por horário de início e fim; fora desse intervalo, a automação simplesmente não é avaliada nem disparada, mesmo que a condição configurada esteja tecnicamente satisfeita.
- Automação com texto livre ou template: quando usar cada um?A ação de uma automação só pode ser de dois tipos: enviar texto livre (SEND_TEXT) ou enviar template (SEND_TEMPLATE). A escolha não é uma preferência de estilo, ela depende exclusivamente da janela de 24 horas: dentro dela, texto livre é permitido e mais barato; fora dela, só template aprovado funciona.
- Como evitar mensagens automáticas repetidas (cooldown e limite de disparos)?Cada automação pode ter um cooldown, que é o tempo mínimo entre dois disparos para o mesmo contato, e um número máximo de disparos, evitando que a mesma condição continue acionando a mesma mensagem repetidamente para o mesmo lead.
- Agente de IA substitui atendente humano no WhatsApp? Como combinar os dois?Não integralmente. O modelo é de convivência: a IA cobre triagem, dúvidas recorrentes e ações como consulta de produto e criação de orçamento, enquanto o prompt e o vínculo com um agente humano definem quando a conversa fica com uma pessoa.
Gestão comercial e contatos
Kanban de orçamentos, catálogo, importação de contatos, funil e templates na plataforma.
- Como gerenciar orçamentos e negociações do WhatsApp em um kanban?Cada orçamento passa por um funil com status próprios, Rascunho, Orçamento, Atendimento, Aguardando pagamento, Pago, Reativação e Concluído, além de Cancelado, e pode ser acompanhado tanto em um kanban, arrastando cartões entre colunas, quanto em uma visão de lista, usando a mesma base de dados.
- Como montar um catálogo de produtos para orçamentos no WhatsApp?Cada item é cadastrado como produto físico, digital ou serviço, com preço, SKU, tags e, quando fizer sentido, controle de estoque. Esse catálogo alimenta os orçamentos montados durante o atendimento, seja manualmente pelo time, seja automaticamente pelo agente de IA.
- Como importar contatos por planilha com tags?É possível importar uma planilha nos formatos .xlsx ou .xls com a lista de contatos e, de forma opcional, atribuir uma ou mais tags a todos os contatos importados de uma só vez, sem precisar marcar contato por contato depois da importação.
- Como segmentar a base de contatos para campanhas?A segmentação é feita por tags atribuídas aos contatos, na importação em massa por planilha ou manualmente durante o atendimento , , permitindo filtrar exatamente quem deve receber uma campanha de template sem depender de exportar e cruzar planilhas separadas.
- Como acompanhar o funil do primeiro contato até o pagamento?O funil conecta a origem da conversa, o histórico de atendimento e o status do orçamento, do rascunho até pago ou concluído, em uma visão única, permitindo enxergar em que etapa cada lead trava entre o primeiro contato e o pagamento.
- Como criar e enviar templates para aprovação da Meta dentro da plataforma?O template é criado diretamente na plataforma, escolhendo categoria (marketing, utilidade ou autenticação), escrevendo o corpo com variáveis no formato {{1}}, e adicionando cabeçalho, rodapé e botões quando fizer sentido, e enviado para análise da Meta sem precisar acessar diretamente o Gerenciador de Negócios.
- Como receber alertas de eventos importantes da operação de WhatsApp?É possível cadastrar alertas com prioridade e status para acompanhar ocorrências da operação, funcionando como um registro central de itens que precisam de atenção, hoje é um recurso de criação e acompanhamento de alertas, e não um construtor visual de regras complexas de disparo automático.
Integração, embed e agências
Embed no CRM, API pública, multi-tenant, white-label e conexão OAuth com Ads.
- Como embutir o atendimento do WhatsApp dentro do meu CRM ou sistema?O padrão é embutir o inbox via iframe autenticado e um SDK JavaScript no sistema host: um botão flutuante abre o atendimento de WhatsApp sem reconstruir a tela de conversas dentro do CRM ou produto próprio.
- Como integrar o WhatsApp ao meu software com API pública e webhooks?A plataforma expõe uma API pública e webhooks documentados em /docs/api, permitindo enviar mensagens, consultar dados de conversa e orçamento, e receber eventos em tempo real diretamente no seu próprio sistema, uma alternativa para quem prefere construir a própria interface em vez de usar o embed visual do inbox.
- Como uma agência gerencia vários clientes de WhatsApp com dados isolados?A estrutura é multi-tenant: cada cliente vive em um tenant separado, com conversas, orçamentos, contatos e configuração de marca isolados entre si, enquanto a agência acessa todos os tenants a partir de um único login operacional.
- Como aplicar minha marca na plataforma de WhatsApp (white-label)?Cada tenant pode configurar logo, logo compacto, favicon e cores primária e secundária, aplicando a marca do parceiro (agência ou software house) em toda a interface da plataforma, sem expor a marca original do fornecedor de tecnologia.
- Como conectar contas de Meta Ads e Google Ads via OAuth?A conexão é feita por OAuth diretamente na plataforma: o usuário autoriza o acesso à conta de anúncios da Meta ou do Google, e essa autorização passa a ser usada para ligar cliques de anúncio (como CTWA ou gclid) aos dados de conversa e conversão registrados no WhatsApp.