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 leva de horas a dias, pois a verificação do Meta Business é necessária.
• O número não deve estar registrado no WhatsApp — você aluga um novo aqui ou traz um não registrado.
• Custo: aluguel de número a partir de 50 créditos por mês (o cartão do número mostra seu preço exato), mais taxas de modelo da Meta repassadas a preço de custo. Se você conectou sua própria chave Anthropic (BYOK), as mensagens do WhatsApp via Twilio gerenciado custam 0,05 créditos cada, de entrada e saída. Em todas as outras contas, esses custos de entrega já estão cobertos pela sua taxa de crédito de IA, portanto, não há cobrança separada por mensagem. Consulte 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 inicial com pessoas que denunciam você ainda pode resultar em restrição do número.
• Limites de mensagens por níveis (de 250 a ilimitado, definidos no nível do portfólio).
• Confirmações completas de entrega e leitura.
• Confiabilidade: totalmente baseada 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 adicional por mensagem.

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 conversas — também traz o histórico de mensagens dos contatos importados (pode levar alguns minutos). 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; desative por contato posteriormente quando estiver pronto.
3. Clique em Obter código QR para continuar com o fluxo de leitura padrão (Passo 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.

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.

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.

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

• Avançar ou retroceder o dia de aquecimento (1–60) — avançar desbloqueia limites maiores mais cedo para um número que você sabe que tem histórico real; apenas o aumento exige que você marque uma caixa de reconhecimento de risco.
• Ultrapassar o aumento automatizado (apenas quando um número estiver totalmente aquecido, dia 58+) — defina um limite manual de 750 até 5.000 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.

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.

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.

Se sua equipe responde pelo celular, verifique isso primeiro. Quando várias pessoas gerenciam o mesmo número de WhatsApp, é normal que a maioria das conversas seja alternada silenciosamente para o modo 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 campanha.

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.

Limitações #

• Sem chats em grupo. Mensagens em 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.
• Rastreamento de entrega limitado. Você ainda pode ver os tiques azuis (confirmações de leitura) no próprio WhatsApp, mas o rastreamento do status de entrega dentro do aplicativo é mais limitado do que com a API Business.
• 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 práticas recomendadas abaixo.
• Dispositivo único. A conexão conta como um dos seus dispositivos vinculados; o WhatsApp permite até 4.
• Sem verificação de “este número está no WhatsApp”. O aplicativo nunca pergunta ao WhatsApp se um número está registrado, propositalmente: consultas em massa a partir de um número comercial são um padrão que o WhatsApp trata como scraping, e um número novo fazendo isso para algumas centenas de contatos desconhecidos é restringido rapidamente. Uma mensagem para um número que não está no WhatsApp aparece como enviada, mas nunca é entregue, e ainda conta para o limite diário do número, portanto, limpe sua lista antes de carregá-la (veja Escalando o alcance do WhatsApp com segurança).

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.

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á para Configurações → Canais → Canais, desconecte a sessão existente e configure uma nova conexão.

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.