Visão geral
O módulo WhatsApp é a caixa de entrada do número oficial da clínica na API da Meta (Cloud API): as mensagens dos clientes chegam em tempo real, com foto, áudio, vídeo e documento renderizados na conversa, e a equipe responde do painel — com resposta citada, reações, recibo de leitura (tiques azuis) e indicador de "digitando…" no aparelho do cliente. Cada conversa pode ter um dono na equipe, e notas internas (amarelas) registram contexto sem nunca chegar ao cliente.
Conceitos-chave
- Janela de 24h: a Meta só permite texto livre até 24h após a última mensagem do cliente; fora dela, apenas templates aprovados — o compositor troca sozinho e lista os templates direto da Meta.
- Opt-in duplo (LGPD): mensagem INICIADA pela clínica (confirmação, lembrete) exige WhatsApp habilitado na unidade + aceite do cliente; RESPONDER quem escreveu primeiro é atendimento e não é barrado.
- Loop de confirmação: o pedido de confirmação da Agenda sai por aqui; a resposta SIM confirma o agendamento sozinha (e NÃO sinaliza remarcação), com auditoria.
- Vínculo com o cadastro: a conversa liga ao tutor pelo telefone; com mais de um cadastro no mesmo número, ninguém escolhe sozinho — a equipe vincula à mão.
- Dono da conversa: atendimento atribuído a alguém da equipe; filtros Minhas/Sem dono organizam a fila.
- Nota interna: mensagem amarela com cadeado, visível só no painel — nunca é enviada.
Como usar
Abra WhatsApp para ver a caixa de entrada (não lidas ficam com selo verde).
Selecione a conversa e responda — anexe arquivo pelo clipe, cite com o botão de responder, reaja passando o mouse na mensagem.
Assuma o atendimento no seletor de responsável do cabeçalho.
Com a janela de 24h fechada, use Reabrir com template e escolha um template aprovado.
Use o cadeado para registrar uma nota interna (o cliente não recebe).
Casos de uso
- Cliente manda foto do machucado: a imagem aparece na conversa; responda citando a foto e registre nota interna para o veterinário.
- Confirmação de agenda: o pedido sai da Agenda, o SIM do cliente confirma sozinho e a conversa guarda o histórico.
- Equipe dividida: cada atendente filtra Minhas e vê só o que assumiu.
Boas práticas
Erros comuns e soluções
Integrações
As credenciais oficiais da Meta (token, número, WABA, app secret e verify token do webhook) são configuráveis em Configurações → WhatsApp (canal oficial) — envs WHATSAPP_* valem como fallback. A Agenda dispara a confirmação por aqui; o opt-in LGPD vem do CRM; o chat do portal segue no módulo Conversas.
Permissões
Atender pelo WhatsApp (whatsapp.manage) — ler e responder conversas, enviar mídia e templates, assumir atendimento, notas internas e arquivar. Nasce para toda a equipe (admin/owner/vet/staff).
Dúvidas frequentes
- Preciso de WhatsApp configurado?
Sim — token, phone number ID, app secret e verify token, em Configurações → WhatsApp (canal oficial); o WABA ID habilita o picker de templates. Sem credencial, o recebimento registra e o envio fica bloqueado. A caixa só aparece em unidade com o toggle WhatsApp ligado (Dados da unidade).
- Reagir/citar funciona de verdade no aparelho do cliente?
Sim — reação, citação, recibo de leitura e "digitando…" usam os recursos oficiais da Cloud API; o cliente vê como em qualquer conversa de WhatsApp.
- Nota interna pode vazar?
Não. Ela nunca é enviada à Meta — só existe no painel, e nem aparece no preview da lista.