WhatsApp Web #

Conecte sua conta do WhatsApp existente (pessoal ou comercial) à plataforma pareando seu telefone — não é necessária verificação do Meta Business. Isso funciona exatamente como conectar o WhatsApp Web em um navegador, mas, em vez de um navegador, suas conversas do WhatsApp fluem diretamente para o aplicativo.

O que é a integração do WhatsApp Web? #

A integração com o WhatsApp Web permite que você conecte seu número do WhatsApp existente à plataforma sem passar pelo processo oficial de configuração da API do WhatsApp Business. Em vez de comprar um novo número de telefone e concluir a verificação do Meta Business, você pareia seu telefone pelo aplicativo em menos de um minuto.

Isso é ideal para empresas que desejam começar rapidamente com sua presença atual no WhatsApp.

WhatsApp Web vs. API Business #

O que o WhatsApp Web oferece a você #

• Configuração em minutos — você emparelha seu telefone e nenhuma verificação do Meta Business é necessária.
• Use seu número do WhatsApp existente, pessoal ou comercial. (Um número alugado através da plataforma não pode ser usado aqui — ele não possui um telefone por trás, portanto, conecta-se através da API do Business.)
• Custo: 50 créditos por mês por número conectado, sem taxa por mensagem.
• O risco de banimento é baixo ao enviar mensagens para pessoas que optaram por recebê-las. A sessão é executada em um servidor privado com um proxy dedicado; o risco vem de enviar mensagens em massa para estranhos que podem denunciá-lo.
• Limites de envio padrão do WhatsApp, com um aumento gradual automático de aquecimento.
• Rastreamento básico de entrega de mensagens apenas.
• Confiabilidade: a sessão é executada em nossos servidores, portanto, seu telefone pode ficar offline por até 14 dias.
• Ideal para pequenas empresas, um início rápido e números pessoais.

O que a API do WhatsApp Business oferece a você #

• A configuração requer uma conta Meta Business. A verificação da empresa é opcional, mas uma empresa não verificada começa com 250 contatos únicos a cada 24 horas.
• O número não deve estar registrado no WhatsApp — você aluga um novo aqui ou traz um não registrado.
• Custo: o aluguel do número custa a partir de 50 créditos por mês (o cartão do número mostra seu preço exato), mais as taxas de modelo da Meta de acordo com a tarifa da Meta para o país de destino. Se você conectou sua própria chave da Anthropic (BYOK), as mensagens do WhatsApp via Twilio gerenciado custam 0,05 créditos cada, recebidas e enviadas; em todas as outras contas, esses custos de entrega são cobertos pela sua taxa de crédito de IA. A partir de 1º de outubro de 2026, cada número gerenciado será cobrado por mensagem, recebida e enviada, independentemente de você usar sua própria chave ou não. Veja Custos do WhatsApp e a Mudança de Outubro de 2026 para saber o que muda em 1º de outubro de 2026.
• O risco de banimento é baixo porque o canal é oficial da Meta, mas o contato frio (cold outreach) com pessoas que denunciam você ainda pode levar à restrição de um número.
• Limites de mensagens por nível (de 250 a ilimitado, definidos no nível do portfólio).
• Confirmações completas de entrega e leitura.
• Confiabilidade: totalmente baseado na nuvem, sem necessidade de telefone.
• Ideal para remetentes de alto volume, empresas e setores regulamentados.

WhatsApp Web e a API Business lado a lado #

Quanto custa o WhatsApp Web: 50 créditos por mês por conexão, sem taxa por mensagem #

O WhatsApp Web está disponível em todos os planos atuais. Cada número conectado custa 50 créditos por mês, e não há taxa por mensagem adicional. Se sua conta for configurada por uma agência, a agência pode definir um preço diferente por número; a tela de pareamento e o cartão do número mostram o valor que você paga.

Se o seu saldo estiver muito baixo quando a mensalidade vencer, esse mês será ignorado e uma nova tentativa será feita cerca de 30 dias depois. Um mês ignorado nunca é cobrado posteriormente, recarregar o saldo não aciona uma cobrança e o número permanece conectado, já que é o seu próprio número.

Cada número pode, em vez disso, ser colocado em Respostas de IA ilimitadas, onde a conexão custa 250 créditos a cada 30 dias e o trabalho da IA nas conversas desse número não tem custo adicional para agentes nos planos Max e Mini. Agentes no plano Pro continuam pagando por resposta. Você escolhe o modo ao parear o número e pode alterá-lo posteriormente. Veja IA ilimitada em um número do WhatsApp Web.

Configurando o WhatsApp Web #

Passo 1: Abra o Fluxo de Conexão #

1. Na barra lateral esquerda, clique em Configurações perto da parte inferior.
2. Na barra lateral esquerda de Configurações, em Canais, clique em Canais.
3. Encontre o cartão WhatsApp Web e clique em Conectar (ele mostrará Adicionar número assim que você já tiver um pareado).

Passo 2: Inserir o número de telefone e opções de importação #

Um pop-up intitulado Conectar WhatsApp Web será aberto.

1. Insira o número de telefone da conta do WhatsApp que você deseja conectar, incluindo o código do país.
2. Ative Importar contatos existentes se você quiser trazer seus contatos atuais do WhatsApp para a caixa de entrada na primeira conexão. Ativar isso revela opções adicionais:
   • Tornar contatos privados — as mensagens dos contatos importados não serão armazenadas nem enviadas pela plataforma, e a IA permanecerá desativada para eles. Use isso para um telefone cheio de conversas pessoais.
   • Importar histórico de chat — também traz o histórico de mensagens dos contatos importados (pode levar alguns minutos). Não há limite de dias do nosso lado: tudo o que seu telefone fornecer será importado, portanto, o período retroativo depende do que o WhatsApp enviar a partir do telefone. Com essa opção desativada, nada anterior à conexão é importado. As mensagens importadas preenchem a conversa em Chats, mas são excluídas dos números e gráficos do seu Dashboard, para que conversas anteriores à conexão não distorçam suas estatísticas.
   • Manter IA pausada para contatos importados — recomendado e ativado por padrão. Deixe ativado para que a IA não envie mensagens automaticamente para seus contatos existentes; você pode desativar individualmente por contato mais tarde, quando estiver pronto.
3. Marque Eu entendo que minha conta será cobrada em 50 créditos/mês por esta conexão. O botão abaixo permanecerá desativado até que você faça isso; reconectar um número que já está pareado ignora esta etapa.
4. Clique em Obter código QR para continuar com o fluxo de leitura padrão (Etapa 3 abaixo), ou clique em Vincular com número de telefone, logo abaixo do botão, se preferir inserir um código curto no seu telefone em vez de escanear.

Números alugados através da plataforma não podem ser emparelhados aqui. O WhatsApp Web vincula um telefone que já executa o WhatsApp no número que você inserir. Um número que você comprou na página Canais é um número virtual sem um telefone por trás, portanto, não há nada para escanear o QR code, e o aplicativo impedirá a ação caso você tente. Para colocar um número alugado em funcionamento, use Concluir configuração na linha do número na página Canais — isso o conecta através da API do WhatsApp Business.

Conectando um número que você também usa pessoalmente? Tudo bem, e o modal também informa isso. Apenas lembre-se de que a IA responde a cada chat no número assim que ele estiver ativo. As duas chaves que impedem isso — Manter IA pausada para contatos importados e Tornar contatos privados — só aparecem quando Importar contatos existentes está ativado, e elas cobrem apenas os contatos trazidos naquele momento. Qualquer pessoa que enviar uma mensagem após você conectar o número chegará como um chat totalmente novo com a IA ativa, portanto, deixe seu agente desligado até que sua lista de contatos real esteja carregada e você esteja pronto para começar. Observe que reconectar um número posteriormente não mantém essas escolhas — defina-as novamente na nova conexão.

A importação só é executada quando o número é vinculado pela primeira vez. O WhatsApp só envia seus contatos na primeira vez que um dispositivo é vinculado. Se o número já foi conectado anteriormente e você o reconecta, o WhatsApp reconhece o dispositivo e pula essa etapa, portanto, as opções de importação não têm nada com que trabalhar — a conexão ainda é bem-sucedida, ela apenas não traz nenhum contato. Para forçar uma nova vinculação, abra o WhatsApp no seu telefone, vá para Configurações > Aparelhos conectados, desconecte o dispositivo Your AI Connector e, em seguida, conecte o número novamente com as opções de importação desejadas.

Clicar em Link with phone number instead alterna a tela no mesmo lugar: o botão torna-se Get pairing code, e o link muda para Scan QR code instead para que você possa alternar de volta.

Passo 3: Vincular seu telefone #

Escanear um código QR (padrão):

1. Um código QR aparecerá com a instrução: abra o WhatsApp no seu celular → Configurações → Aparelhos conectados → Conectar um aparelho, e então escaneie o código exibido.
2. Aguarde alguns segundos para que a conexão seja estabelecida. O status é atualizado automaticamente após o pareamento, e seu número de telefone aparecerá na página de Canais.

Conectando com um número de telefone:

1. Clique em Conectar com número de telefone.
2. Um código curto aparecerá com a instrução: no seu celular, vá em WhatsApp → Aparelhos conectados → Conectar um aparelho → “Conectar com número de telefone”, e então insira o código exibido.
3. Aguarde alguns segundos. Uma vez conectado, a conexão é concluída automaticamente, assim como no escaneamento.

Você pode alternar entre os dois métodos a qualquer momento nesta tela usando Escanear código QR / Conectar com número de telefone.

Uma vez conectado, suas conversas do WhatsApp tornam-se acessíveis através da plataforma, e um Agente de IA atribuído a este canal pode responder às mensagens recebidas.

Gerenciamento de Sessão #

Verificando o Status da Conexão #

O status da sua conexão do WhatsApp Web é exibido ao lado do número na página Canais (Configurações → Canais → Canais). Os status possíveis incluem:

Reconectando #

Se sua sessão for desconectada (problemas de rede, reinicialização do celular, etc.), abra Configurações → Canais → Canais, encontre o número no cartão do WhatsApp Web e use a ação de reconectar. O sistema tentará restaurar a sessão anterior automaticamente; se falhar, um novo código QR (ou código de pareamento) aparecerá da mesma forma que na configuração inicial.

Você não precisa procurar por isso. Quando um número está offline, uma barra de WhatsApp desconectado aparece no topo de cada página no aplicativo com um botão Reconectar que inicia o mesmo fluxo; ela é exibida imediatamente quando o WhatsApp desconecta o dispositivo (uma nova leitura de QR code é a única solução) e após alguns minutos no caso de uma queda comum que não foi resolvida automaticamente. Você também recebe uma notificação de sino e um e-mail, para que um número que fique inativo durante a noite não passe despercebido. Até que ele esteja de volta, a IA não responderá por esse número.

Link de reconexão para quem estiver com o telefone #

O telefone associado a um número muitas vezes não está com a pessoa que gerencia a conta: um cliente, um colega na recepção, um proprietário de loja. Forneça a eles um link de reconexão para que possam reconectar o número por conta própria, sem precisar fazer login.

1. Abra Configurações → Canais → Canais e clique no ícone de link ao lado do número do WhatsApp Web.
2. Clique em Criar link, depois em Copiar e envie para quem estiver com o telefone.
3. Quando o número for desconectado, a pessoa abre o link. A página exibirá seu logotipo e nome, o número (parcialmente oculto) e o status da conexão. Ela pode escanear o código QR com o WhatsApp (Configurações → Aparelhos conectados → Conectar um aparelho) ou, no próprio telefone, usar o código de 8 caracteres: Aparelhos conectados → Conectar um aparelho → Conectar com número de telefone, e então digitar o código.

O link funciona apenas para aquele número específico, não expira e abre em seu próprio domínio caso você tenha configurado o white label. A página serve apenas para reconectar o número, nunca para desconectá-lo ou exibir qualquer outra informação da sua conta. A mesma janela mostra quando o link foi aberto pela última vez e quando o número foi reconectado por meio dele pela última vez. Novo link substitui o anterior (o antigo para de funcionar imediatamente) e Desativar desliga o recurso.

Quando um número está inativo, a barra WhatsApp desconectado também possui um botão Copiar link de reconexão, e o e-mail de desconexão inclui o link assim que você o tiver criado.

Quando o WhatsApp continua encerrando a sessão #

De vez em quando, o WhatsApp desconecta um dispositivo vinculado logo após ele se reconectar. O aplicativo tenta primeiro reparar a sessão por conta própria; se o WhatsApp continuar encerrando-a dentro de algumas horas, o número é marcado como precisando de uma nova leitura e a barra de desconexão, a notificação de sino e o e-mail aparecem como em qualquer desconexão. Leia o código QR novamente (ou use o código de pareamento) para restabelecê-lo.

Mantenha o telefone ativo (regra de 14 dias do WhatsApp) #

O WhatsApp desconecta todos os dispositivos vinculados quando o próprio telefone não utiliza o WhatsApp por cerca de 14 dias. Essa é uma regra do próprio WhatsApp e aplica-se a esta conexão como a qualquer outro dispositivo vinculado. Isso acontece com mais frequência com telefones guardados em uma gaveta ou telefones com dois perfis do WhatsApp em que um deles nunca é aberto. Quando isso ocorre, o número aparece como desconectado, a barra de desconexão é exibida e apenas uma nova leitura de QR code pode restabelecer a conexão.

Para se antecipar a isso, o Your AI Connector monitora a atividade do telefone em cada número conectado (uma mensagem digitada no telefone, um chat lido no telefone). Após cerca de 10 dias sem nenhuma atividade, uma barra dizendo Abra o WhatsApp no seu telefone aparece no topo de cada página no aplicativo, e você recebe uma notificação de sino e um e-mail com o mesmo título. Abra o WhatsApp nesse telefone, no perfil correto caso o telefone tenha mais de um, e é só isso; o aviso é enviado uma vez por período de inatividade. Um telefone que está online, mas nunca é tocado, também pode receber este aviso. Abrir o WhatsApp uma vez ainda é a medida mais segura.

As mensagens que as pessoas enviam enquanto um número está desconectado permanecem no seu telefone. Após reconectar, o Your AI Connector importa as mensagens que chegaram enquanto ele estava offline, para que a conversa possa continuar no aplicativo.

Desconectando #

Para desconectar intencionalmente, encontre o número na página Canais e use a ação de remover/desconectar. Isso encerrará a sessão e removerá o número da sua conta. Você poderá reconectar mais tarde pareando novamente.

Problemas para conectar? Use a extensão do navegador #

Às vezes, uma conexão ou reconexão não é concluída porque o WhatsApp adiciona uma etapa de segurança extra — ele solicita uma chave de acesso (passkey) que a conexão normal via código QR ou código numérico não consegue completar sozinha. Quando isso acontecer, use uma pequena extensão de navegador chamada Your AI Connector, que é executada no seu próprio Chrome, onde essa etapa da chave de acesso funciona normalmente.

Você só precisa fazer isso uma vez. Após o seu número ser conectado, a extensão terá cumprido seu papel e tudo funcionará na nuvem como de costume.

Antes de Começar #

• Isso funciona atualmente apenas no Google Chrome em um computador ou laptop.
• A extensão é um auxiliar de uso único — ela não interfere em nada após a conexão ser estabelecida.

Passo a passo #

1. Na tela de conexão do WhatsApp Web, escolha Problemas para conectar? A chave de acesso está bloqueando? Use a extensão do navegador.
2. Baixe a extensão. Ela será salva no seu computador como um arquivo compactado (zip).
3. Descompacte o arquivo — isso criará uma pasta comum.
4. No Chrome, abra uma nova aba e vá para chrome://extensions.
5. Ative o Modo do desenvolvedor (canto superior direito).
6. Clique em Carregar sem compactação.
7. Selecione a pasta que você descompactou.
8. De volta à tela de conexão, clique em Conectar. Uma aba do WhatsApp Web abrirá automaticamente com seu código de conexão já carregado, para que a extensão o capture sozinha.
9. Faça login no WhatsApp nessa aba como de costume — como este é o seu próprio Chrome, a etapa da chave de acesso funcionará aqui. Ela será importada automaticamente e a tela exibirá Conectado.
10. Feche a aba do WhatsApp Web agora que ela diz Conectado. Isso é importante: se você deixar o WhatsApp Web aberto no seu navegador, ele manterá uma segunda cópia da mesma sessão em execução que competirá com a nossa, o que pode fazer com que seu número fique offline. Seu celular permanece conectado normalmente — apenas a aba do navegador precisa ser fechada.

O botão Conectar não abriu o WhatsApp Web? Use a opção Avançado: colar o código manualmente — abra o web.whatsapp.com por conta própria, faça login, clique na extensão do navegador, cole o código de conexão exibido na tela de conexão e pressione Importar.

Um Agente por Número #

Conecte dois ou mais números do WhatsApp Web e cada um poderá ter seu próprio Agente de IA. Na página de Agentes de IA, o painel Quem responde a novas conversas mostra um bloco por número para o WhatsApp Web com um seletor para cada número conectado: deixe um número em Igual ao WhatsApp Web para seguir o Agente do canal, ou escolha um Agente diferente (ou Ninguém responde) apenas para aquele número. Um cliente que enviar uma mensagem para o seu segundo número receberá o Agente daquele número, e todas as respostas serão enviadas a partir do mesmo número para o qual ele escreveu. Detalhes: Pontos de Entrada → Um Agente por número do WhatsApp.

Chamadas #

Cada chamada de voz ou vídeo em um número do WhatsApp Web aparece no chat desse contato como uma pequena linha centralizada, da mesma forma que o próprio WhatsApp as exibe: Chamada de voz perdida, Chamada de voz · 3:12 para uma que você atendeu (com a duração dela) e Chamada de voz recusada. Apenas as chamadas que um contato faz para o seu número são exibidas: o WhatsApp não repassa as chamadas que você faz pelo telefone para dispositivos conectados, portanto, elas nunca aparecem no chat. Uma chamada perdida move o chat para o topo da sua lista, marcado como não lido como uma nova mensagem, e seu Agente de IA vê as chamadas na conversa, então “você ligou duas vezes ontem” é algo que ele sabe. As chamadas não podem ser atendidas, gravadas ou transcritas pelo aplicativo: o áudio chega apenas ao telefone. Quem liga para você gera um registro de contato no momento em que a chamada termina, então eles aparecem nos Chats mesmo que nunca tenham enviado uma mensagem.

Responder chamadas perdidas com texto #

A maneira mais simples de atender a uma chamada perdida é o interruptor no próprio número. Em Configurações → Canais, cada número do WhatsApp Web possui um interruptor Responder chamadas perdidas com texto abaixo de sua linha. Ative-o, mantenha ou altere a mensagem (ela começa como “Desculpe, perdemos sua ligação. Como podemos ajudar? Responda aqui e entraremos em contato com você imediatamente.”) e salve. A partir de então, no momento em que uma chamada para esse número não for atendida, esse texto será enviado pelo mesmo número e, quando quem ligou responder, a conversa será tratada pelo Agente de IA do número, como qualquer novo chat. O mesmo interruptor encontra-se no cartão SMS via Twilio, caso você tenha conectado seu próprio número Twilio para SMS, onde a resposta é enviada como um texto e a chamada pode tocar primeiro em um telefone de sua escolha — veja Responder chamadas perdidas com texto no seu número SMS.

Por trás do botão há uma automação comum chamada Resposta de texto para chamada perdida · seu número, portanto, ela aparece em Estúdio de IA → Automações e cada execução usa os 0,25 créditos habituais. Quer mais, como um texto diferente durante o horário de atendimento, um agente específico para quem ligou e perdeu a chamada, ou um acompanhamento caso não respondam? Abra-a em Automações e edite-a lá; depois de alterar seu formato, a página Canais mostrará Personalizado em Automações e manterá suas edições, enquanto o botão ainda a liga e desliga.

Para qualquer coisa além de um texto, o gatilho Chamada perdida em Automações é disparado no momento em que a chamada termina sem ser atendida, seja porque quem ligou desligou ou porque tocou até cair, com quem ligou já salvo como contato, então uma etapa Enviar mensagem pode respondê-los no WhatsApp em segundos e seu agente assume a conversa a partir daí. Com vários números conectados, o campo Número do gatilho limita-o a chamadas para um deles. Chamadas que você atende ou recusa não contam, e as chamadas ainda não podem ser atendidas pelo próprio aplicativo. Passo a passo: Exemplo: transformar uma chamada perdida do WhatsApp em um chat.

Limites de Envio e Aquecimento #

Cada número do WhatsApp Web pareado possui seus próprios medidores de Limites de Envio e Aquecimento, exibidos diretamente abaixo de sua linha na página Canais:

• Mensagens enviadas hoje e novos contatos hoje, cada um exibido em relação ao limite do dia.
• Um selo de dia X de 61 enquanto ainda estiver em fase de aumento, ou Em capacidade total após o aquecimento completo.
• Prévia do limite de amanhã e dias restantes até a capacidade total.
• Um explicativo Por que estou limitado? com a justificativa.

Números novos começam com um limite diário baixo (50 mensagens no primeiro dia) que aumenta automaticamente ao longo de aproximadamente 60 dias para proteger contra banimentos. Esse aquecimento é normal e importante — um número novo que envia mensagens demais muito cedo é a maneira mais rápida de ser banido. Veja Escalando o Alcance no WhatsApp com Segurança para a fórmula completa de aumento e como acelerá-la para números com histórico real comprovado.

Cada balão conta. O limite contabiliza mensagens enviadas, não conversas, e seu Agente de IA normalmente divide uma resposta em vários balões curtos. Uma resposta em 5 balões utiliza 5 do limite diário, portanto, no primeiro dia, 50 mensagens podem ser gastas por um punhado de conversas. Quando um número atinge seu limite, o banner Limite diário do WhatsApp atingido na parte superior do aplicativo informa isso e oferece duas saídas: Aumentar limite (o painel de aquecimento abaixo) e Responder em menos balões, que abre a configuração Máximo de mensagens por resposta do Agente de atendimento — defina como 2 ou 3 e ative Impor máximo de mensagens se quiser que isso seja garantido. Veja Limites de resposta. As respostas que você mesmo digita pelo aplicativo também contam; mensagens enviadas pelo próprio telefone não contam. Você também recebe um e-mail (e um alerta de sino) na primeira vez que um número atinge seu limite em um determinado dia, no máximo uma vez por número por dia, como parte da categoria de notificação Mudanças de Status do WhatsApp.

Os limites são por número, portanto, conectar mais números aumenta o espaço: uma transmissão no WhatsApp Web é distribuída entre todos os seus números conectados e ritmada de acordo com o limite combinado deles. Veja Enviando de vários números do WhatsApp Web.

Os limites diários não são a única proteção para o número. O que a mensagem diz também conta: se dez mensagens de abertura quase idênticas forem enviadas de um número dentro de uma hora para contatos que nunca escreveram para você, as subsequentes serão interrompidas e marcadas como falhas no chat, e você receberá um e-mail sobre isso. Respostas e seu Agente de IA nunca são afetados. É por isso que as transmissões no WhatsApp Web solicitam variações de mensagem antes de serem iniciadas. Veja Aberturas idênticas fazem com que números sejam restritos para saber o que aciona a proteção e como enviar novamente após isso ocorrer.

Clique em Aumentar limite diário nos medidores de um número para abrir o painel Limite de envio diário, onde você pode:

• Adiantar ou atrasar o dia de aquecimento (1–60) — avançá-lo desbloqueia limites mais altos mais cedo para um número que você sabe que tem um histórico real; apenas um aumento exige que você marque uma caixa de reconhecimento de risco.
• Ir além da rampa automatizada (apenas uma vez que um número esteja totalmente aquecido, dia 58+) — defina um limite manual de 750 até 1.500 mensagens/dia, em incrementos de 250. Isso traz um risco real de banimento e exige um reconhecimento explícito mais forte antes de ser aplicado.

Nota. Números do WhatsApp Web recém-conectados têm acompanhamentos automatizados desativados por padrão como medida de segurança, exibidos como a chave Acompanhamentos automatizados abaixo dos medidores de cada número. Ela permanece desativada até que três etapas de aquecimento sejam superadas (idade do número, aumento de atividade e engajamento recente de contatos, cada um medido ao longo de ~30 dias) — a chave permanece utilizável durante todo o processo, mas o painel mostra quais etapas ainda não foram superadas. Assim que seu número estiver aquecido e estável, reative os acompanhamentos para ele.

Números que não estão no WhatsApp #

Uma mensagem para um número de telefone que não possui uma conta no WhatsApp não é enviada. Em vez de ficar esperando eternamente por um tique cinza, ela é marcada como falha no chat com o motivo “Este número não está no WhatsApp”. O gatilho de automação Mensagem falhou é disparado para isso, para que você possa reagir, por exemplo, enviando uma mensagem para o contato através de outro canal ou marcando-o para que uma pessoa verifique o número. O contato também é definido como Não Perturbe no WhatsApp, para que os acompanhamentos parem de tentar um número que não pode recebê-los.

IA ilimitada em um número do WhatsApp Web #

Cada número do WhatsApp Web é cobrado em um dos dois modos, e um número pode alternar entre eles a qualquer momento.

O modo é oferecido apenas em contas para as quais foi ativado. Se seus números não exibirem a opção, sua conta ainda não a possui.

Se sua conta executa a IA usando sua própria chave de API, a IA ilimitada não é oferecida: as respostas em seus números já não custam créditos.

O que a IA ilimitada cobre #

Em um número alternado para IA ilimitada, tudo o que a IA faz dentro de uma conversa nesse número é gratuito:

• As próprias respostas, nos níveis de qualidade Max e Mini.
• As ferramentas que a IA usa ao responder, como agendar um compromisso ou buscar algo em sua base de conhecimento.
• A verificação que decide se uma conversa foi finalizada e o tratamento quando alguém escreve no meio de uma resposta.
• As etiquetas que a IA coloca em um contato, o nome e o endereço de e-mail que ela extrai de um chat e os resumos contínuos que ela mantém de conversas longas.
• Transcrição de notas de voz e áudio de vídeos que as pessoas enviam para você, para que a IA possa respondê-los.
• Mensagens de acompanhamento automatizadas que o Agente envia nesse número, incluindo acompanhamentos de transmissão, nos níveis Max e Mini.
• Tarefas que o resumo diário noturno cria sobre uma conversa nesse número.

Cada resposta gratuita ainda aparece no seu histórico de uso de créditos como uma Mensagem de IA com 0 créditos, para que você possa ver o que o número processou.

Não cobre:

• Respostas no nível Pro, que continuam sendo cobradas por ação. Coloque o Agente de atendimento no nível Max ou Mini para obter a tarifa gratuita.
• Trabalho de configuração fora de uma conversa, como gerar ideias de etiquetas ou modelos de acompanhamento no editor do Agente.
• A redação do resumo diário em si, que cobre toda a sua conta em vez de apenas um número.
• Qualquer coisa cobrada pelo WhatsApp ou por uma operadora em vez de por nós.

A IA ilimitada aplica-se ao número que você alternou. Seus outros números e outros canais não são afetados.

Escolhendo o modo #

Ao parear um novo número, a opção aparece antes do código QR: Medido ou IA Ilimitada. O número começa com a opção que você escolher.

Posteriormente, o modo fica no cartão do número em Configurações → Canais → Canais. Alterne por lá e uma janela de confirmação mostrará o número exato de créditos que serão debitados ou devolvidos antes de você confirmar.

Quanto custa uma alteração #

A alteração é calculada em dias inteiros, para que você nunca pague duas vezes pelo mesmo dia.

De Medido para IA Ilimitada. Você paga 250 créditos, menos os dias inteiros da taxa mensal que você já pagou e não utilizou. Se sua última taxa mensal de 50 créditos foi cobrada há 12 dias, restam 18 dias pagos, valendo 30 créditos, portanto a alteração custa 220 créditos. Um número que você acabou de parear não tem nada a subtrair, então custa os 250 completos. O período de 30 dias começa no momento em que você altera.

De IA Ilimitada para Medido. Os dias inteiros restantes no seu período de 30 dias retornam ao seu saldo, e a taxa mensal normal de 50 créditos é então cobrada por um novo mês começando naquele dia. Se alterar de volta com 9 dias restantes, 75 créditos são devolvidos e 50 são debitados, deixando você com um saldo positivo de 25 créditos.

Um número pode ser alterado uma vez em cada direção a cada 24 horas. Se você acabou de alterar, o cartão informa quando a próxima alteração estará disponível.

Renovação e o que acontece se o seu saldo for insuficiente #

Um número de IA Ilimitado é renovado a cada 30 dias por mais 250 créditos, debitados automaticamente. O cartão mostra a data de renovação. Os 30 dias contam a partir do momento em que você o ativou, não por mês civil, e o dia da renovação não pode ser alterado (para o dia 1º do mês, por exemplo).

Se a recarga automática estiver ativada e o saldo estiver muito baixo para a renovação, nós recarregamos primeiro e depois renovamos, mesmo quando seu saldo ainda estiver acima do seu limite de recarga. Contas de clientes de uma agência recebem o mesmo através do faturamento da agência quando a agência tem a recarga automática ativada para eles.

Se ainda não houver créditos suficientes no dia da renovação (recarga automática desativada ou a recarga falhou), o número volta para o modo Medido, nós enviamos um e-mail sobre isso e a taxa mensal normal de 50 créditos passa a ser aplicada a partir desse dia. O número permanece conectado o tempo todo e continua enviando e recebendo: apenas a IA volta a custar créditos por resposta. Recarregue o saldo e alterne de volta sempre que desejar.

Indicadores de Digitação #

A integração com o WhatsApp Web suporta indicadores de digitação — aquele balão “digitando…” que seus contatos veem quando a IA está preparando uma resposta. Isso é ativado automaticamente e não requer configuração.

Responder a si mesmo pausa a IA #

Se você responder a uma conversa manualmente, a IA será pausada para aquele contato específico para que ela não fale por cima de você. Isso acontece independentemente de você responder pelo Chats no aplicativo ou diretamente pelo WhatsApp no seu celular, e é fácil confundir os dois: responder a um chat no seu celular parece que nada aconteceu no aplicativo, mas a IA parou silenciosamente de responder àquela pessoa.

O mesmo vale para qualquer outro aplicativo ou dispositivo vinculado à mesma conta do WhatsApp (em Aparelhos conectados no celular): uma mensagem enviada por ele para um contato conta como uma resposta sua, portanto, a IA também pausa nesse chat. O chat informa quando esse é o motivo da interrupção da IA: uma linha no topo da conversa e no painel de contato diz “IA pausada: uma mensagem foi enviada pelo celular ou outro aplicativo vinculado a este WhatsApp.”, com Retomar IA logo ao lado.

A IA permanece pausada para aquele contato até que alguém a reative. Ela não retoma o funcionamento sozinha após uma hora, um dia ou a próxima mensagem do contato. Abra a conversa em Chats e use a chave seletora na parte superior — ela exibirá “IA pausada” quando a IA estiver desativada, e selecioná-la reativará a IA.

As mensagens de saudação e de ausência do WhatsApp Business são reconhecidas automaticamente. Se o aplicativo WhatsApp Business no telefone pareado estiver com a Mensagem de saudação ou Mensagem de ausência ativadas (Ferramentas comerciais no aplicativo), esse texto automático é enviado segundos após a mensagem de um contato. Assim que o mesmo texto automático for enviado para dois contatos, ele é reconhecido como uma mensagem automática: a IA permanece ativa para esses chats e uma nota aparece no número em Configurações → Canais. O primeiro contato que ela alcança também é reativado nesse momento. O contato recebe tanto sua mensagem automática quanto a resposta do Agente de IA, portanto, se você quiser que apenas a IA responda, desative a mensagem de saudação e de ausência e deixe o Agente de IA fazer a saudação. Chats que foram pausados antes disso ser reconhecido podem ser retomados com Retomar IA no filtro IA pausada em Chats.

Se sua equipe responde pelo celular, verifique isto primeiro. Quando várias pessoas gerenciam o mesmo número de WhatsApp, é normal que a maioria das conversas acabe sendo alterada silenciosamente para manual sem que ninguém tenha decidido fazer isso. Se a IA parecer ter “parado de funcionar”, abra alguns chats e verifique a chave seletora da IA antes de alterar qualquer configuração de agente.

Outro bot vinculado ao mesmo WhatsApp pausa a IA onde quer que ele responda. Se um segundo chatbot ou ferramenta de resposta automática estiver vinculado ao número, cada mensagem que ele enviar desligará a IA naquele chat. Quando o mesmo texto é enviado três vezes para um chat dentro de um minuto, ou para muitos chats dentro de dez minutos, uma entrada aparece no Registro de Erros (código APP-1115) citando o texto repetido, no máximo uma vez por dia por número. Desvincule o outro aplicativo em Aparelhos conectados no WhatsApp ou desative suas respostas automáticas e, em seguida, retome a IA nos chats afetados.

Uma resposta automática do lado do contato não é reconhecida. As duas verificações acima referem-se a mensagens automáticas enviadas do seu próprio número. Quando a pessoa com quem você está falando possui seu próprio respondedor automático (uma mensagem de ausência, um aviso de fora do escritório, o chatbot de outra empresa), nada marca a mensagem dela como automática: a IA a trata como qualquer outra mensagem e pode respondê-la, e cada resposta utiliza créditos normalmente. O mesmo vale para a API do WhatsApp Business, SMS, Telegram, Instagram e Messenger. Se você vir dois bots trocando mensagens em um chat, desative a IA para essa conversa usando a chave na parte superior da conversa. O e-mail é a exceção: e-mails automatizados são arquivados e nunca respondidos (consulte E-mail).

O painel Caixa de entrada do seu dashboard mostra uma contagem de chats nos quais você pausou a IA e está respondendo manualmente, o que é a maneira mais rápida de identificar isso em toda a conta.

O que é copiado para o aplicativo (e o que não é) #

Emparelhar seu telefone funciona da mesma forma que vincular o WhatsApp em um laptop: a partir do momento em que a vinculação está ativa, as conversas individuais nesse número fluem para o aplicativo e são armazenadas lá, para que a IA e sua equipe possam trabalhar nelas. Vale a pena saber exatamente o que isso abrange antes de conectar um número que você também usa pessoalmente.

O que é importado:

• Cada conversa individual nesse número a partir do momento em que você se conecta, em ambas as direções — incluindo mensagens que você mesmo envia do seu telefone.
• Contatos existentes e, opcionalmente, seu histórico, mas apenas se você ativar Importar contatos existentes ao se conectar (veja o Passo 2 acima). Deixe desativado e nada anterior à conexão será copiado.

O que nunca é importado:

• Conversas em grupo. As mensagens de grupo são ignoradas completamente — elas não criam um contato, não aparecem na sua caixa de entrada, não são armazenadas e a IA nunca responde em um grupo. Nada que você envia do aplicativo vai para um grupo também. Seus grupos continuam funcionando normalmente no WhatsApp do seu telefone; o aplicativo simplesmente não os vê.
• Atualizações de status e listas de transmissão.
• Conversas em outros números. Apenas o número que você emparelhou é conectado.

Se você estiver conectando um número que também usa para conversas pessoais, duas opções mantêm essas conversas privadas:

• Ative Tornar contatos privados durante a importação. As mensagens desses contatos não são armazenadas nem enviadas pela plataforma, e a IA permanece desativada para eles.
• Ou use um número diferente para negócios. Essa é a separação mais clara, e é o que sugerimos se suas conversas pessoais forem confidenciais.

Lembre-se de que ambas as opções de importação cobrem apenas os contatos trazidos no momento da conexão. Qualquer pessoa que enviar uma mensagem para o número após a conexão chegará como uma nova conversa normal.

Removendo conversas que foram copiadas #

Tudo o que a conexão trouxe são dados comuns da conta, e você os remove da mesma forma que remove qualquer outra coisa:

• Uma conversa ou contato — exclua o contato em Contatos. Excluir um contato remove o histórico de conversas dele imediatamente.
• Vários de uma vez — selecione-os em Contatos ou em uma lista e exclua-os juntos, ou exclua a lista inteira.
• Tudo — desconecte o número em Configurações → Canais, depois exclua os contatos que ele trouxe. Desconectar interrompe a chegada de novas mensagens, mas não exclui o que já foi importado.

Excluir aqui não afeta o WhatsApp no seu telefone: suas conversas permanecem onde estão no aplicativo WhatsApp. Se você quiser uma cópia de algo antes de excluí-lo, veja Baixar seus dados.

Contatos cujo número está oculto #

O WhatsApp nem sempre revela o número de telefone de um contato para um dispositivo conectado. Em vez disso, ele fornece um ID interno longo (um código de 14 ou 15 dígitos) e compartilha o número real mais tarde, às vezes apenas quando o contato escreve novamente ou você o salva na agenda do telefone. Até lá, o aplicativo não tem nenhum número para mostrar para esse contato.

Esse contato exibe Número oculto onde o número de telefone normalmente estaria: no cabeçalho do chat, na lista de conversas, no cartão de contato e na tabela de Contatos. A conversa em si funciona normalmente: as mensagens chegam, a IA responde, os acompanhamentos são enviados, porque o WhatsApp os roteia por esse ID interno. Apenas o número está faltando, então não há nada para ligar ou copiar ainda.

Assim que o WhatsApp compartilha o número real, o contato é atualizado automaticamente: o número aparece onde estava o rótulo e as mensagens já presentes no chat são mantidas. Você também pode abrir Editar contato e digitar o número você mesmo, caso o contato o tenha fornecido no chat; o campo de telefone fica vazio para um contato com número oculto, não preenchido com o código interno, e salvar sem um número mantém o contato como está.

Na API e em uma exportação de contatos, um número oculto permanece oculto. A API retorna phone_number como null para esse contato, com number_hidden definido como true e o ID interno do WhatsApp em whatsapp_lid; todos os outros contatos possuem number_hidden: false. A exportação em CSV deixa a coluna Phone Number vazia e preenche as colunas Number Hidden e WhatsApp LID. Para corresponder ao contato de outro sistema, use whatsapp_lid: passá-lo como o número de telefone na busca de contatos encontrará o contato.

Locais Compartilhados #

Um local que o contato compartilha (um alfinete, um lugar salvo ou um local em tempo real) chega à IA como texto na conversa: o nome do lugar e o endereço quando o WhatsApp os envia, além das coordenadas, na forma [THE CONTACT SHARED A LOCATION] Playa Delfines, Cancún (21.1619, -86.8515). O agente pode usar o endereço em sua resposta, seguir instruções que dependem de onde o contato está ou passar a latitude e longitude para uma função personalizada ou webhook. Um local em tempo real chega uma vez, com a posição no momento em que foi compartilhado; o aplicativo não acompanha o alfinete em movimento. A API do WhatsApp Business entrega o mesmo formato.

Em Conversas, você a vê como um cartão, não como aquela linha de texto: um alfinete com o nome e o endereço do local, e um link Abrir no Google Maps que abre o local exato em uma nova guia. Uma legenda que o contato digitou junto com ela aparece abaixo. A lista de conversas mostra um alfinete e o nome do local como a mensagem mais recente.

Limitações #

• Alguns contatos chegam sem um número de telefone. O WhatsApp pode ocultar o número de um contato de um dispositivo vinculado e compartilhá-lo posteriormente; o contato exibirá Número oculto até lá e será preenchido automaticamente. Veja Contatos cujo número está oculto.
• Sem chats em grupo. Mensagens de grupo são ignoradas em ambas as direções e a IA nunca responde em um grupo — veja O que é copiado para o aplicativo acima.
• Sem mensagens de modelo. Você não pode enviar mensagens de modelo pré-aprovadas. Todas as mensagens são de formato livre. Isso também significa que não há etapa de aprovação de modelo no WhatsApp Web: as transmissões que você envia neste canal saem diretamente como mensagens comuns da sua própria conta do WhatsApp, sem nada enviado à Meta e sem nada para aguardar. A aprovação de modelo pertence apenas à API do WhatsApp Business.
• Seu telefone precisa ficar online pelo menos uma vez a cada 14 dias. A sessão do WhatsApp Web em si é executada em nossos servidores, portanto, as mensagens continuam fluindo enquanto seu telefone está em repouso ou desligado. Mas se o seu telefone permanecer offline por mais de 14 dias, o WhatsApp desconecta todos os dispositivos vinculados e você precisará parear novamente.
• Integração não oficial. Não é oficialmente suportada pela Meta; alterações do lado deles podem afetar esse recurso.
• O rastreamento de entrega segue os próprios tiques do WhatsApp. Uma mensagem mostra um pequeno relógio até que o WhatsApp confirme que a recebeu (normalmente em menos de um segundo), depois um tique assim que o WhatsApp a aceita, dois tiques assim que é entregue ao telefone do contato, e o detalhe ao passar o mouse sobre a mensagem mostra quando ela foi lida. Se o WhatsApp nunca confirmar uma mensagem dentro de 10 minutos — geralmente uma conexão que caiu no momento errado — ela é marcada como Não entregue com um ! vermelho para que você possa enviá-la novamente. Uma mensagem para um número que não está no WhatsApp não é enviada: ela é marcada como falha com “Este número não está no WhatsApp” (veja Números que não estão no WhatsApp). Um contato que bloqueou seu número ainda mostrará um tique.
• Risco para a conta. Automação excessiva ou comportamento semelhante a spam pode resultar em banimentos temporários ou permanentes do WhatsApp. Siga o aquecimento e as melhores práticas abaixo.
• Dispositivo único. A conexão conta como um dos seus dispositivos vinculados; o WhatsApp permite até 4.

Solução de problemas #

A tela de conexão não carrega um código #

• Atualize a página e tente novamente.
• Certifique-se de ter uma conexão estável com a internet.
• Se o problema persistir, desconecte qualquer sessão existente primeiro e comece do zero.

A conexão continua caindo #

• Verifique se o seu telefone tem uma conexão confiável com a internet (Wi-Fi recomendado).
• Certifique-se de que as configurações de otimização de bateria do seu telefone não estejam fechando o WhatsApp em segundo plano.
• Reconecte a sessão a partir da página Canais.

Número desconecta dentro de um minuto após a conexão #

Se um número aparece como Conectado e cai novamente dentro de um minuto ou mais, toda vez que você o vincula, o próprio WhatsApp está removendo o dispositivo vinculado daquela conta; nada no aplicativo o excluiu. O WhatsApp não informa o motivo, mas vincular, excluir e adicionar novamente o mesmo número várias vezes em um curto período pode causar isso. No telefone, abra WhatsApp → Configurações → Aparelhos conectados e encerre as sessões antigas, atualize o WhatsApp, aguarde algumas horas e, em seguida, conecte o número uma vez e deixe-o conectado. Se o WhatsApp exibir um aviso no telefone, aguarde até que ele desapareça antes de vincular novamente.

Mensagens não estão sendo enviadas #

• Verifique se o status da conexão mostra Conectado.
• Verifique se você tem créditos suficientes em sua conta.
• Certifique-se de que o número do destinatário esteja correto e tenha o WhatsApp instalado.
• Se você atingiu recentemente o limite diário de envio, aguarde a redefinição ou revise os medidores de aquecimento.

Quando uma mensagem falha, o aplicativo mostra o motivo na mensagem dentro do chat, em vez de apenas “falhou”. Motivos comuns:

• O WhatsApp está limitando mensagens para este contato. O destinatário pode ter bloqueado seu número, ou o WhatsApp ainda não está permitindo que seu número inicie uma nova conversa com ele. Tentar repetidamente piora a situação — aguarde até que o contato envie uma mensagem para você primeiro ou entre em contato por outro canal.
• Problema temporário de conexão com o WhatsApp. Uma falha pontual — a próxima mensagem para esse contato geralmente é enviada normalmente.

“O Reconectar continua pedindo uma chave de acesso” #

Essa etapa de segurança não pode ser concluída apenas pela conexão normal via QR ou código — consulte Problemas de conexão? Use a extensão do navegador acima.

O telefone mostra “Desconectado” #

Sua sessão foi encerrada pelo lado do telefone. Vá em Configurações → Canais → Canais, desconecte a sessão existente e configure uma nova conexão. Se ninguém tocou no telefone, consulte Mantenha o telefone ativo acima: o WhatsApp desconecta dispositivos vinculados após cerca de 14 dias sem que o telefone utilize o WhatsApp, e o e-mail de aviso do 10º dia é o sinal para abri-lo.

A IA parou de responder em alguns chats #

Abra um desses chats. Se aparecer “IA pausada: uma mensagem foi enviada pelo celular ou outro aplicativo vinculado a este WhatsApp.”, alguém respondeu pelo celular ou outro aplicativo vinculado ao número enviou uma mensagem, e a IA recuou para aquele contato. Clique em Retomar IA para ligá-la novamente. Se muitos chats forem afetados de uma só vez, verifique Configurações → Registro de Erros para uma entrada APP-1115: isso aponta para outro aplicativo vinculado ao número que continua enviando a mesma mensagem. Veja Responder você mesmo pausa a IA.

O WhatsApp me enviou um aviso #

Às vezes, o WhatsApp exibe um aviso no seu telefone logo após você vincular um novo dispositivo — frequentemente acompanhado pela desconexão do dispositivo vinculado. Este é um alerta automatizado do WhatsApp sobre uma nova conexão, e é mais provável que ocorra quando o número é novo ou quando as mensagens são enviadas para pessoas que não salvaram seu número ou não enviaram mensagens para você primeiro. Isso não significa que você foi banido e, geralmente, não tem relação com o volume de mensagens.

O que fazer:

1. Continue usando o número normalmente no aplicativo WhatsApp no seu telefone por alguns dias.
2. Reconecte a sessão e, durante a primeira ou segunda semana, deixe que a IA responda principalmente às pessoas que enviarem mensagens — evite transmissões e primeiras mensagens de contato frio.
3. Se você enviar mensagens de saída, espace-as e varie o texto — textos repetidos idênticos são o gatilho clássico.
4. Para envios regulares em volume, use a WhatsApp Business API em vez disso: os modelos são aprovados pela Meta antecipadamente, portanto, os envios não colocam seu número nesse tipo de risco.

Se a mensagem que você recebeu disser que sua conta está realmente banida (não apenas um aviso), entre em contato com o suporte com uma captura de tela.

Melhores práticas #

• Mantenha seu telefone online pelo menos uma vez a cada 14 dias — o WhatsApp desvincula todos os dispositivos conectados após esse período.
• Use Wi-Fi no seu telefone para obter a conexão mais estável.
• Preste atenção aos medidores de limite de envio para proteger sua conta do WhatsApp contra restrições.
• Comece com um volume baixo de automação e aumente gradualmente à medida que estabelece um padrão de mensagens.
• Considere a API do WhatsApp Business se precisar de maior volume, mensagens de modelo ou confiabilidade garantida.