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

  1. No Meta Business Suite, acesse Configurações > WhatsApp
  2. Crie um aplicativo WhatsApp Business (se ainda não existir)
  3. Adicione e verifique o número de telefone da clínica
  4. 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

  1. Acesse Configurações no ProTerapia
  2. Vá em Integrações > WhatsApp
  3. Insira as credenciais obtidas:
    • Phone Number ID
    • WhatsApp Business Account ID
    • Access Token
  4. Clique em Conectar
  5. 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:

  1. Envie uma mensagem de teste para o número da clínica usando seu celular pessoal
  2. A Tera deve responder automaticamente
  3. Teste perguntas como “Qual o horário de funcionamento?” ou “Quero agendar uma consulta”

Solução de problemas

ProblemaSolução
Tera não respondeVerifique se o webhook está configurado corretamente no Meta
Erro de autenticaçãoVerifique se o Access Token está correto e não expirou
Número não verificadoComplete a verificação do número no Meta Business Suite
Mensagens não chegamVerifique 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.