Como conectar seu WhatsApp ao HomeChat
Conecte seu número em Configurações → Canais. Recomendamos o WhatsApp Official (API oficial da Meta); também existe uma opção rápida por QR Code.
O HomeChat oferece duas formas de conectar um número de WhatsApp: o "WhatsApp Official", que usa a API oficial da Meta (o caminho recomendado, com o número na sua própria conta comercial), e o "WhatsApp", uma conexão mais simples por QR Code, pensada para quem quer começar rápido sem passar pelo processo de verificação da Meta. Este artigo cobre as duas.
Antes de começar
Abra a tela de conexão de canais:
- No menu do HomeChat, acesse Configurações → Canais.
- Se você ainda não tem nenhum canal conectado, clique em "Conectar Canal". Se já existe pelo menos um canal, o botão fica no topo da tela com o rótulo "Novo Canal".
- Na janela "Novo Canal" que abre, você verá três opções: WhatsApp, WhatsApp Official e Instagram.
Opção recomendada: WhatsApp Official (API oficial da Meta)
Essa é a opção que mantém o número na sua própria conta comercial (WABA) na Meta — o HomeChat não "empresta" nem migra o número, ele passa a atender por ele usando a API oficial. É a opção recomendada para quem já usa (ou vai usar) um número dedicado à empresa.
- 1Escolha o cartão "WhatsApp Official"
Na janela "Novo Canal", clique no cartão "WhatsApp Official".
- 2Clique em "Conectar com Meta"
Isso abre um popup oficial da Meta. Você loga na conta comercial da sua empresa e autoriza a conexão em poucos cliques, sem precisar copiar ou colar nenhum token.
- 3Aguarde a confirmação automática
Depois de autorizar no popup, o HomeChat recebe automaticamente os identificadores da sua conta comercial (WABA) e do número — o canal já aparece conectado na lista, sem passo manual adicional.
Se o botão "Conectar com Meta" não estiver disponível na sua conta, ou se você já tem um número configurado manualmente na Meta Business Suite, existe um link "Já tenho um token — usar manualmente" na mesma janela. Ele abre um formulário com os campos Nome do canal, Phone Number ID, Access Token, App Secret, Business Account ID (WABA) (opcional) e Webhook Verify Token (opcional) — esses dados vêm do seu próprio painel de desenvolvedor da Meta.
Opção rápida: WhatsApp por QR Code
Essa opção não usa a API oficial da Meta — é uma conexão do tipo "espelho", parecida com o WhatsApp Web, pensada para testar o HomeChat rapidamente ou para quem ainda não quer passar pela verificação de conta comercial na Meta. Como não é a API oficial, ela depende da sessão do WhatsApp continuar ativa no aparelho usado para escanear o QR Code.
- 1Escolha o cartão "WhatsApp"
Na janela "Novo Canal", clique no cartão "WhatsApp" (o segundo, diferente de "WhatsApp Official").
- 2Aguarde o provisionamento automático
O HomeChat cria a instância de conexão automaticamente, sem pedir nenhum dado nesse primeiro passo.
- 3Escaneie o QR Code
Clique em "Ver QR code" no card do canal recém-criado. No celular com o número que você quer conectar, abra o WhatsApp → Aparelhos conectados → Conectar um aparelho, e aponte a câmera para o QR Code exibido na tela.
Se o provisionamento automático não estiver disponível no seu servidor, o HomeChat mostra um aviso e cai automaticamente para o modo manual, com campos para Nome do canal, Token e Webhook Secret (opcional).
Depois de conectado
Cada canal conectado aparece como um card na tela de Canais, com:
- Um indicador "Ativo"/"Inativo".
- No caso do WhatsApp por QR Code, um aviso "WhatsApp desconectado" se a sessão do celular cair — nesse caso, basta escanear o QR Code novamente.
- Botões de ação como "Testar Conexão", "Reassinar Webhook" e, no WhatsApp Official, "Templates" (para ver os modelos de mensagem aprovados na Meta).
- Um menu "⋮" com as opções Editar credenciais, Tornar privado/público na organização e Remover.
Remover um canal não apaga o histórico: as mensagens e conversas continuam preservadas, o canal só fica inativo.
Dúvidas comuns sobre esse passo a passo.
Para uso contínuo com uma equipe, recomendamos o WhatsApp Official — é a API oficial da Meta, o número fica na sua conta comercial e a conexão não depende de um celular permanecer online. A opção por QR Code é mais rápida de configurar, mas depende da sessão do aparelho usado para escanear continuar ativa.
No WhatsApp Official, não — a API oficial da Meta exige um número dedicado à conta comercial (WABA), diferente do número já ativo no app comum. Na opção por QR Code, a conexão é feita a partir do número que você escanear.
Sim, nas duas opções. Depois de conectado, o número passa a ser atendido dentro do HomeChat pela equipe inteira, com as conversas organizadas por atendente.
Outras páginas que podem ajudar.
Fale com a gente que a resposta sai rápido.
Se esse artigo não resolveu, é só chamar — respondemos por e-mail ou WhatsApp.