Integração WhatsApp
Conectando o WhatsApp
Configure a integração com WhatsApp Business API (Meta Cloud API) para que a Tera atenda pacientes no WhatsApp.
Conectando o WhatsApp
Para que a Tera atenda pacientes via WhatsApp, é necessário configurar a integração com a API do WhatsApp Business (Meta Cloud API).
Pré-requisitos
- Plano Pro ativo no ProTerapia
- Uma conta no Meta Business Suite
- Um número de telefone dedicado para o WhatsApp Business da clínica
Passo a passo
1. Criar conta no Meta Business Suite
Se você ainda não tem, crie uma conta em business.facebook.com. Essa é a plataforma da Meta para gerenciar negócios no WhatsApp, Facebook e Instagram.
2. Configurar o WhatsApp Business
- No Meta Business Suite, acesse Configurações > WhatsApp
- Crie um aplicativo WhatsApp Business (se ainda não existir)
- Adicione e verifique o número de telefone da clínica
- A verificação pode ser feita por SMS ou chamada telefônica
3. Obter as credenciais da API
Após a verificação, você precisará de:
- Phone Number ID — identificador do número no Meta
- WhatsApp Business Account ID — identificador da conta
- Access Token — token de acesso permanente para a API
Essas informações estão disponíveis no painel do desenvolvedor da Meta em Configurações do App > WhatsApp > API Setup.
4. Configurar no ProTerapia
- Acesse Configurações no ProTerapia
- Vá em Integrações > WhatsApp
- Insira as credenciais obtidas:
- Phone Number ID
- WhatsApp Business Account ID
- Access Token
- Clique em Conectar
- O sistema vai verificar a conexão e confirmar o status
5. Configurar o Webhook
O ProTerapia precisa receber as mensagens dos pacientes. O webhook é configurado automaticamente durante o passo anterior, mas caso precise configurar manualmente:
- URL do Webhook — será exibida na tela de configuração do ProTerapia
- Token de verificação — também exibido na mesma tela
- No Meta, acesse Configurações do App > WhatsApp > Configuration e configure o webhook com essas informações
Testando a conexão
Após a configuração:
- Envie uma mensagem de teste para o número da clínica usando seu celular pessoal
- A Tera deve responder automaticamente
- Teste perguntas como “Qual o horário de funcionamento?” ou “Quero agendar uma consulta”
Solução de problemas
| Problema | Solução |
|---|---|
| Tera não responde | Verifique se o webhook está configurado corretamente no Meta |
| Erro de autenticação | Verifique se o Access Token está correto e não expirou |
| Número não verificado | Complete a verificação do número no Meta Business Suite |
| Mensagens não chegam | Verifique se a assinatura de webhook inclui o evento “messages” |
Custos do WhatsApp
O Meta cobra por conversas no WhatsApp Business API. As primeiras 1.000 conversas iniciadas por clientes são gratuitas por mês. Após isso, consulte a tabela de preços da Meta.
O ProTerapia não cobra taxas adicionais pela integração WhatsApp — o custo é apenas o do Meta.