# Integrabot no WhatsApp: oficial, coexistência e WhatsApp Web

Atualizado em 2026-11-03. Fonte: o painel do Integrabot e https://docs.integrabot.ai/pt/canais.

No fim do cadastro, a pessoa escolhe onde o Agente começa a atender: WhatsApp oficial (recomendado) ou WhatsApp Web, lado a lado, ou o widget no site.

O Agente de IA do Integrabot atende no WhatsApp de dois jeitos: pela API oficial da Meta, que é o recomendado, ou pelo WhatsApp Web, por QR Code, como alternativa fora da API oficial. Também atende num widget no site. No WhatsApp e no widget, o Agente usa a mesma base de conhecimento, as mesmas regras e as mesmas automações, e as conversas aparecem juntas no painel.

## Os dois jeitos de conectar o WhatsApp

| | WhatsApp oficial (recomendado) | WhatsApp Web (alternativa) |
|---|---|---|
| Como conecta | Pela conta da Meta, no cadastro incorporado da Meta | Por QR Code (no computador) ou por código de pareamento (no celular) |
| Base | WhatsApp Business Platform, Cloud API da Meta | WhatsApp Web, fora da API oficial |
| Risco para o número | É o caminho autorizado pela Meta | O número pode ser bloqueado ou banido pelo WhatsApp a qualquer momento, sem aviso, e o histórico vai junto |
| Mesmo número do celular | Sim, com a coexistência | Sim |
| Modelos aprovados, retomadas e lembretes automáticos | Sim | Não |
| Fotos, áudios e arquivos recebidos | Chegam pela API oficial | Podem não chegar ao Agente |
| Estabilidade | Não depende do celular ligado | Cai quando o celular fica sem internet, sai do WhatsApp Web ou o WhatsApp atualiza, e pede um QR Code novo |
| Cobrança da Meta por mensagem | Sim, à parte, direto para a Meta | Não |
| Requisitos | Conta empresarial na Meta e forma de pagamento na Meta | Celular com o WhatsApp do número |

Para o número principal do negócio, o recomendado é o WhatsApp oficial. A diferença para o WhatsApp Web não é só preço: é o risco de perder o número.

## WhatsApp oficial (Cloud API)

- A conexão é feita pelo cadastro incorporado da Meta: a pessoa entra com a conta do Facebook que administra o negócio, escolhe ou cria o portfólio empresarial, informa o número e volta para o Integrabot. Leva poucos minutos.
- Número novo: a Meta confirma por SMS ou ligação.
- A análise da conta, a verificação da empresa e a aprovação de modelos de mensagem seguem os prazos da Meta, que o Integrabot não controla. Enquanto isso, dá para começar pelo widget no site.
- Mensagem por iniciativa do negócio só com modelo (template) aprovado pela Meta; conversa livre só dentro da janela de 24 horas aberta pelo cliente. O painel tem uma área para criar e acompanhar os modelos.

### Coexistência: o mesmo número, com o app no celular

Com a coexistência, o negócio conecta à API oficial o mesmo número que já usa no app WhatsApp Business e continua usando o app no celular.

- Não precisa trocar de número.
- Na conexão, a Meta mostra um QR Code no computador; a pessoa confirma pelo app WhatsApp Business no celular, que precisa estar atualizado.
- O Integrabot pede à Meta os contatos e o histórico de conversas do app; vem o que a Meta disponibilizar. O histórico importado não faz o Agente responder mensagens antigas.
- Quando alguém da equipe responde pelo app, a mensagem aparece no painel como enviada pela equipe e o Agente para de responder naquela conversa.

### Requisitos da Meta

1. Uma conta empresarial na Meta (portfólio empresarial, antigo Business Manager), de preferência com a empresa verificada.
2. Uma forma de pagamento aceita pela Meta (cartão) na conta do WhatsApp Business. É por ela que a Meta cobra as mensagens.
3. Um número que não esteja conectado à API do WhatsApp por outro provedor, ou o número do app WhatsApp Business, com a coexistência.

### Dicas para a conexão dar certo

- Fazer a conexão pelo navegador do computador, com pop-ups liberados para integrabot.ai, e com o celular por perto.
- Se a Meta diz que o número está vinculado a listas automáticas, desativar as listas em Ferramentas comerciais, no app WhatsApp Business, e tentar de novo.
- Número em outro provedor da API: desconectar lá antes.

### Custos da Meta

A Meta cobra por mensagem, conforme a categoria da mensagem e o país de quem recebe, direto no cartão da conta do WhatsApp Business. O que é cobrado e o que é gratuito, inclusive as respostas dentro da janela de 24 horas, segue as regras vigentes da Meta. É separado do plano do Integrabot. Tabela oficial: https://business.whatsapp.com/products/platform-pricing

## WhatsApp Web (QR Code)

- Aparece ao lado da conexão oficial no fim do cadastro e na aba WhatsApp do Agente, como alternativa.
- Antes de conectar, a pessoa lê os riscos e marca que os aceita; sem esse aceite, a conexão não é criada. A responsabilidade pelo número é de quem conecta.
- Depois do aceite, a conexão é feita pelo WhatsApp do celular, em aparelhos conectados: lendo o QR Code que o painel mostra no computador, ou digitando o código de pareamento que o painel mostra quando a pessoa está no celular.
- O Agente responde as mensagens que chegam. Sem modelos aprovados pela Meta, não há retomadas, lembretes nem a fila de ações nesse canal.

## Widget no site

- Uma janela de conversa no canto do site, para quem não quer ou ainda não pode conectar o WhatsApp, ou para atender também quem chega pelo site.
- No Agente, aba Widget: informar os sites que podem mostrar o widget (até 10), ativar, copiar o código e colar no site.
- Funciona assim que o código é colado. Não tem cobrança da Meta. Está em todos os planos.

## Instagram e Messenger

O Agente de IA não atende no Instagram nem no Messenger.