Conexão do WhatsApp

📌 O que é

WhatsApp → Conexão é onde a clínica escolhe como o WhatsApp fica ligado ao sistema. Sem nenhum conectado, a tela mostra dois cartões grandes — um para cada caminho — e você clica no que preferir.

Uma faixa no alto diz sempre o que está entregando as mensagens hoje, mesmo que seja uma integração externa. Ela fala do que está no ar, nunca do que está apenas salvo. (Com o WhatsApp oficial no ar a faixa dá lugar à linha de status da conta — veja abaixo.)

Com o WhatsApp oficial (Meta) conectado, a Conexão vira a casa do canal: no alto da tela aparecem as abas Conta · Modelos de mensagem · Formulários. Sem a Meta conectada, as abas não existem — QR code não tem modelos nem formulários.

👥 Quem pode usar

Administração e Recepção conectam, desconectam e enviam teste. Quem atende (médico, dentista, terapeuta) vê o estado, sem os botões. A clínica precisa ter o módulo de WhatsApp liberado — se não tiver, a tela avisa e pede contato com o suporte.

🔀 Os dois caminhos

🟢 WhatsApp da clínica (QR code) — mais rápido de começar

Você conecta lendo um código com o celular, como no WhatsApp Web.

• Pronto em 2 minutos — só precisa do celular com o chip da clínica na mão.
• Sem custo por mensagem.
• As conversas dos pacientes aparecem aqui dentro, e sua equipe responde por aqui.
• Funciona com o número que a clínica já usa.
• ⚠️ O WhatsApp pode bloquear o número se ele disparar muita mensagem de uma vez ou receber denúncia. Use um chip só da clínica — nunca o pessoal.
• O celular precisa ficar ligado e com internet.

🟣 WhatsApp oficial (Meta) — recomendado para volume alto

Você conecta pela própria Meta, dona do WhatsApp.

• Sem risco de bloqueio — é a via oficial.
• Selo de conta verificada no WhatsApp do paciente.
• Não depende de celular ligado.
• ⚠️ A Meta cobra por conversa iniciada pela clínica (as respostas do paciente nas 24 horas seguintes são gratuitas). A partir de 01/10/2026 cada mensagem que a clínica manda conta — inclusive a resposta livre dentro da janela, depois de 1.000 grátis por mês. O bloco Consumo da API oficial (abaixo) mostra o mês.
• ✅ Funciona com número novo ou com o número que já roda no WhatsApp Business do celular (coexistência — o aplicativo continua funcionando).
• ⚠️ A Meta precisa aprovar os textos das mensagens automáticas.

🟣📱 Conexão híbrida — respostas sem custo no número oficial

O que é. Para quem conectou o WhatsApp oficial no número que já roda no WhatsApp Business do celular (coexistência), dá para parear esse mesmo celular como um aparelho conectado ao sistema. Aí o caminho de cada mensagem fica assim:

Mensagem	Sai por
O que o paciente manda	Canal oficial (Meta), como hoje
Resposta da equipe dentro da janela de 24 horas	Celular pareado — sem custo
Modelo aprovado, confirmação, campanha, régua, aviso	Canal oficial (Meta)
Qualquer coisa fora da janela	Só modelo aprovado, pelo canal oficial

Quem pode usar. Administração e Recepção, e só num número em coexistência. O cartão Respostas sem custo pelo celular aparece embaixo do cartão do WhatsApp oficial.

O ganho. A partir de 01/10/2026 a Meta cobra R$ 0,035 por cada resposta que a clínica manda dentro da janela de 24 horas. Pelo celular pareado, essas respostas continuam grátis. Uma recepção que responde 1.500 vezes por mês poupa cerca de R$ 52.

Os riscos — leia antes de ativar.

• A Meta não recomenda aparelhos extras num número em coexistência: o celular pode desconectar com frequência. Quando isso acontece, as respostas voltam a sair pelo canal oficial (cobradas) e a tela avisa.
• O aparelho conectado não é um caminho oficial do WhatsApp. Se o WhatsApp bloquear o número, o bloqueio atinge o mesmo número que carrega o canal oficial, as confirmações e as campanhas.
• Alguns pacientes podem ver “Aguardando esta mensagem” por alguns instantes antes de o texto aparecer.
• O celular precisa ficar ligado e com internet.

🪜 Passo a passo — conectar pelo QR code

1. WhatsApp → Conexão → Conectar com QR code.
2. Prepare o celular. A tela mostra o caminho no aparelho: WhatsApp → Aparelhos conectados → Conectar aparelho. Só clique em Já estou com o celular na mão quando estiver com ele aberto nessa tela — o código tem validade curta.
3. Escaneie o código. Ele se renova sozinho enquanto você olha e fica na tela até ser lido — pode escanear com calma. Se travar, clique em Gerar novo código.
4. Depois da leitura aparece, embaixo do código, “Parece que o código foi lido. Finalizando a conexão…”. Não feche a página — leva alguns segundos.
5. Pronto! Aparecem a foto, o nome e o número. As conversas antigas são trazidas para a caixa de entrada e o sistema leva você até ela.

🪜 Passo a passo — conectar o WhatsApp oficial

1. WhatsApp → Conexão → Conectar com a Meta.
2. Diga a situação do número. O primeiro passo pergunta como está o número hoje, e os dois caminhos existem:
   • Já uso esse número no WhatsApp Business — o aplicativo continua funcionando no celular e o sistema entra junto, no mesmo número (o app precisa estar na versão 2.24.17 ou mais nova; deixe o celular por perto para confirmar). Nas conversas de 1 a 1, a Meta desliga mensagens temporárias, “ver uma vez” e localização em tempo real; listas de transmissão ficam só de leitura e grupos não entram no sistema. As conversas dos últimos 6 meses e os contatos do aparelho vêm para a caixa de entrada — chegam em partes, em alguns minutos. E o que a equipe responder pelo celular também aparece na conversa, como “Celular da clínica”.
   • É um número novo, sem WhatsApp — a Meta registra o número na conexão oficial; ele deixa de funcionar em aplicativo de celular. Nos dois casos: acesso ao Facebook da clínica e uns 10 minutos.
3. Janela da Meta. O cadastro acontece numa janela da própria Meta. Se ela não abrir, seu navegador bloqueou o pop-up — libere e tente de novo.
4. Pronto — ou Quase lá, quando a Meta ainda não ativou o número. Nesse caso a tela mostra o motivo e o botão Tentar ativar de novo.

🪜 Passo a passo — ativar a conexão híbrida

1. WhatsApp → Conexão, com o WhatsApp oficial já conectado em coexistência. Embaixo do cartão dele está o cartão Respostas sem custo pelo celular — clique em Ativar conexão híbrida.
2. Antes de ativar. Leia a lista: o que muda, o que continua igual e os riscos. Você precisa do celular da clínica com o WhatsApp Business na versão 2.24.17 ou mais nova.
3. Prepare o celular. No mesmo celular que roda o WhatsApp Business da clínica: Aparelhos conectados → Conectar aparelho. Se ele avisar sobre limite de aparelhos, desconecte um aparelho antigo antes.
4. Escaneie o código. Igual ao pareamento por QR: o código se renova sozinho e fica na tela até ser lido.
5. Conexão híbrida ativada. A partir daqui, as respostas dentro da janela de 24 horas saem pelo celular. O cartão passa a mostrar o estado do celular pareado, quanto foi poupado nos últimos 30 dias e quantas conversas já têm foto.

Fotos dos contatos. O WhatsApp oficial não fornece a foto do paciente; o celular pareado fornece. Assim que ele pareia, o sistema busca a foto das conversas mais recentes; depois, busca a cada mensagem que chega e quando você abre uma conversa sem foto. Quer trazer todas de uma vez? Atualizar fotos dos contatos, no cartão da conexão híbrida — se sobrar, ele avisa quantas faltam e você clica de novo. Contato sem foto (ou com a privacidade fechada) fica com a inicial colorida.

Para desligar, use Desativar conexão híbrida no mesmo cartão. Nada é desconectado do WhatsApp oficial: as respostas só voltam a sair por ele, cobradas.

🗂️ As abas da Conexão (só com o WhatsApp oficial)

Aba	O que tem
Conta	Os dados da conta lidos da Meta, a linha de status e os recursos do canal (híbrido, saúde, movimento, consumo).
Modelos de mensagem	A lista de modelos aprovados, em análise e recusados, e o botão de criar — veja Modelos de mensagem.
Formulários	Os formulários do WhatsApp, o construtor e a instalação dos formulários do Cliniset — veja Formulários do WhatsApp.

Os endereços antigos (WhatsApp → Modelos de mensagem e WhatsApp → Formulários no menu lateral) abrem a aba certa — nenhum link salvo quebra.

🪪 Aba Conta

No canto direito do cabeçalho fica Atualizar dados: é a sincronização completa com a Meta — lê de novo o número (status, aprovação do nome, limite, qualidade), a conta (verificação da empresa, status, linha de crédito, pendências), o perfil da empresa e sincroniza os modelos de mensagem e os formulários, tudo num clique. Sem clicar, o sistema relê sozinho a cada 6 horas. Enviar mensagem de teste e Desconectar conta ficam na seção Conexão, no fim da aba.

O bloco da conta mostra:

Campo	O que é
Nome de exibição	O nome que o paciente vê. O chip ao lado diz se a Meta aprovou (Aprovado / Em análise / Recusado). O selo verde ao lado do nome aparece quando a conta é oficial (verificada pela Meta).
Número conectado	O número da conta, com botão de copiar.
ID da conta do WhatsApp Business	O identificador da conta na Meta (útil ao falar com o suporte). O chip Coexistência aparece quando o número também roda no WhatsApp Business do celular.
Limite de mensagens	Quantas conversas novas por dia a Meta libera para o número (250, 1.000, 10.000…). Sobe sozinho com uso e boa qualidade.

E a linha de status:

Status	Verde	Âmbar	Vermelho
Status do número	Conectado	Pendente / Sinalizado	Restrito / Desconectado
Verificação da empresa	Verificada	Em análise / Não verificada	Recusada
Status da conta	Ativa	Limitada / Em análise	Bloqueada / Restrita
Linha de crédito	Ativa	Não configurada	—
Qualidade do número	Alta	Média	Baixa

Sem informação em cinza quer dizer que a Meta ainda não devolveu esse dado — clique em Atualizar dados. A verificação da empresa é feita no Gerenciador de Negócios da Meta e é obrigatória para publicar formulários. Linha de crédito é a forma de pagamento ligada à conta na Meta: sem ela, a Meta não entrega mensagens cobradas (modelos e respostas depois do grátis).

Quando a Meta aponta algo que limita ou bloqueia o envio (forma de pagamento faltando, empresa não verificada, aplicativo com pendência), a lista aparece em âmbar logo abaixo da linha de status, com o motivo e o que fazer.

Perfil da empresa mostra o que o paciente vê ao abrir o perfil do número no WhatsApp: categoria, descrição, e-mail, site e endereço. É editado no aplicativo WhatsApp Business ou no Gerenciador do WhatsApp da Meta; aqui ele é só lido.

Abaixo, Recursos do canal reúne o cartão da conexão híbrida, o Por onde saiu · 30 dias — uma linha por canal: WhatsApp oficial (Meta) com quantos modelos e quantas respostas livres, Celular pareado (híbrido) (sem custo) e Integração externa (n8n) quando existe, cada um com enviadas e recebidas, e o total no rodapé —, a Saúde do WhatsApp oficial e o Consumo da API oficial.

🧭 O que a faixa do topo quer dizer

Cor	Texto	Significa
🟢 Verde	No ar: WhatsApp da clínica	Tudo certo, saindo pelo número da clínica
🟣 Roxo	No ar: WhatsApp oficial (Meta)	Tudo certo, saindo pela via oficial
🟣 Roxo	No ar: WhatsApp oficial (Meta) + celular pareado · respostas sem custo	Conexão híbrida no ar: respostas na janela saem pelo celular
🟡 Âmbar	O celular pareado desconectou — as respostas estão saindo pelo canal oficial, cobradas	Reconecte o celular no cartão da conexão híbrida; nada parou de sair
🟡 Âmbar	WhatsApp da clínica desconectado	Caiu — leia a frase inteira: ela diz se a integração externa assumiu ou se nada está saindo
🟡 Âmbar	O número ainda não foi ativado	A Meta está conectada, mas nenhuma mensagem sai até ativar
⚪ Cinza	Não consegui falar com o servidor agora	Nada foi desconectado — só não deu para perguntar. Costuma se resolver sozinho
🔵 Azul	Suas mensagens saem pela integração externa (n8n)	Nenhum WhatsApp conectado aqui; quem entrega é a automação externa

🎛️ Botões do canal conectado

• Enviar mensagem de teste — manda uma mensagem para o próprio número. No WhatsApp oficial fica na seção Conexão, no fim da aba Conta.
• Sincronizar conversas — traz de novo as conversas do aparelho (só para quem atende no inbox).
• Verificar de novo — pergunta o estado outra vez. Aparece quando o servidor não respondeu; não desconecta nada.
• Reconectar — abre o pareamento de novo, quando a sessão caiu.
• Desconectar — encerra a conexão. As conversas continuam salvas no sistema. No WhatsApp oficial é o Desconectar conta da seção Conexão, no fim da aba.
• Atualizar dados — só no WhatsApp oficial: lê de novo na Meta os dados da conta (nome, status, limite, verificação).
• Ativar conexão híbrida / Reconectar celular / Desativar conexão híbrida — no cartão da conexão híbrida, embaixo do WhatsApp oficial em coexistência.

🔁 Se o WhatsApp cair, ninguém fica na mão

Com a integração externa (n8n) configurada, ela assume sozinha as confirmações quando o WhatsApp desconecta — e a faixa avisa. Reconectou? Volta tudo para o número da clínica, também sozinho.

No inbox, a desconexão aparece num aviso no topo com o botão Reconectar; enviar mensagem pelo chat fica bloqueado até voltar.

🩺 Saúde do WhatsApp oficial

Com a conta da Meta conectada, o cartão do canal ganha cinco quadros:

Quadro	O que mostra	O que fazer
Qualidade do número	Alta, Média ou Baixa — a nota que a Meta dá pelo que os pacientes fazem com suas mensagens (bloqueios, denúncias).	Baixa reduz o limite de envio: revise textos e volume.
Limite de envio	Quantas conversas novas por dia a Meta libera (ex.: até 1.000).	Sobe sozinho com uso e boa qualidade.
Modelos	Quantos aprovados, em análise e recusados.	Recusado em vermelho? Abra Ver modelos e veja o motivo.
Formulários	Quantos formulários estão publicados e quantos a Meta bloqueou; se os formulários dinâmicos estão ativados.	Bloqueado? Abra a aba Formulários, clique em Sincronizar agora e, se persistir, fale com o suporte.
Recebimento	“último evento da Meta há X” — prova de que a Meta está entregando mensagens ao Cliniset.	Verde = recebendo. Cinza “nenhum evento ainda” = o webhook ainda não foi ligado no painel da Meta.

Testar recebimento: mande uma mensagem do seu celular para o número da clínica. Em até 1 minuto ela aparece no Atendimento e o quadro vira “há instantes”. Se em 2 minutos nada mudar, a Meta não está entregando os eventos — fale com o suporte.

Quem conectou em coexistência (o número segue funcionando no WhatsApp Business do celular) vê a etiqueta no topo do cartão e, ao lado dela, o andamento do histórico do aparelho: solicitado — aguardando a Meta, importando (40%) e, no fim, importado. Enquanto importa, a tela se atualiza sozinha a cada 15 segundos. Se aparecer não solicitado, a Meta recusou o pedido na hora da conexão (o motivo vem junto) — as conversas antigas não virão, mas tudo daquele momento em diante funciona normalmente.

As conversas trazidas do aparelho entram na caixa de entrada com a data real de cada mensagem. As que já tinham mais de 24 horas sem movimento chegam concluídas — para não lotar a visão Abertos com meses de conversa antiga. Basta o paciente escrever de novo para a conversa reabrir. Nomes salvos na agenda do celular batizam as conversas; quem já tinha nome diferente aqui é renomeado com o da agenda.

Mensagem enviada pelo celular não abre a janela de 24 horas; a do paciente, sim.

Com a conexão híbrida ativa, o Atendimento mostra o chip híbrido · respostas sem custo no topo, a etiqueta da janela diz por onde a resposta vai (sem custo pelo celular ou modelo aprovado (cobrado)), e cada mensagem enviada ganha um ícone de celular (saiu pelo celular, sem custo) ou da Meta (canal oficial).

Mensagem de teste no WhatsApp oficial usa um modelo aprovado sem variáveis da própria conta. Se a clínica ainda não tem nenhum, o botão avisa: crie um em Modelos de mensagem (ou instale os modelos de fábrica), espere a aprovação da Meta e tente de novo.

💸 Consumo da API oficial

Logo abaixo da saúde, o bloco Consumo da API oficial mostra o mês corrente:

Linha	O que é
Mensagens cobráveis	Quantas mensagens a clínica mandou pelo canal oficial que a Meta cobra (modelos e, a partir de 01/10/2026, respostas livres além das grátis).
Respostas grátis restantes	Quantas das 1.000 respostas grátis por mês ainda sobram no número.
Custo estimado	Uma conta aproximada, na tarifa de utilidade (cerca de R$ 0,035 por mensagem). O valor exato é o da fatura da Meta.
Poupado	Quanto a clínica deixou de pagar com o celular pareado (conexão híbrida) e com os formulários (uma mensagem no lugar de uma conversa).

O que o paciente manda nunca é cobrado. Para gastar menos, veja Formulários do WhatsApp e a conexão híbrida acima.

⚠️ Erros comuns

• “Nenhum WhatsApp conectado” — é o estado normal de quem ainda não conectou. Escolha um dos dois cartões.
• O código sumiu antes de eu escanear — não acontece mais. O código só sai da tela quando o celular confirma a conexão.
• A janela da Meta não abriu — pop-up bloqueado pelo navegador.
• “A rede da clínica pode estar bloqueando” — o cadastro da Meta não carregou; costuma ser bloqueio de rede/antivírus da clínica.
• Mensagens não entregues nas últimas 24 horas — aparece uma tarja vermelha com a contagem e o botão Tentar de novo, que devolve tudo para a fila. Use depois de resolver a causa (WhatsApp reconectado, por exemplo).
• “As conversas antigas ainda não foram trazidas” — acontece quando a página é recarregada logo depois de parear. Clique em Trazer minhas conversas.
• “A Meta autorizou, mas não informou a conta e o número escolhidos” — a janela da Meta foi fechada antes da última tela. Tente de novo e vá até o fim.
• “A conta tem N números e a Meta não indicou qual está no WhatsApp Business” — na coexistência, o sistema descobre o número pela conta; com vários números e nenhum marcado como do aplicativo, ele não escolhe por você. Fale com o suporte informando o número da clínica.
• “Este número já está conectado em outra clínica” — cada número pertence a uma clínica só. Fale com o suporte.
• O celular pareado cai toda hora — é o comportamento que a Meta avisa para aparelhos extras na coexistência. Enquanto está caído, nada para: as respostas saem pelo canal oficial, cobradas. Reconecte pelo cartão; se cair demais, considere desativar.
• “O celular pareado é outro número” — o QR foi lido por um celular que não é o do número conectado na Meta. Pareie o celular certo.
• Paciente viu “Aguardando esta mensagem” — pode acontecer com respostas pelo celular pareado num número em coexistência. Costuma resolver em instantes; se persistir com um paciente, responda a ele pelo canal oficial (modelo) ou desative o híbrido.

🗑️ Apagar conversa

Para apagar uma conversa, use o menu ˅ dela no inbox. Isso remove as mensagens do sistema — não apaga nada no WhatsApp do paciente.

🔗 Relacionados

• Atendimento (inbox) · Confirmador · Agente de IA · Formulários do WhatsApp