Conecte o ClinPRO a qualquer ferramenta

Uma API REST simples pra ler e escrever contatos, agendamentos, pipeline e enviar mensagens no WhatsApp da clínica. Ideal pra conectar via Zapier, Make ou n8n — sem escrever código — ou direto do seu sistema.

Autenticação

Toda requisição precisa da sua chave no cabeçalho Authorization. Gere a chave dentro da sua conta em Configurações → API & Webhooks (só o dono/admin pode). A chave aparece uma única vez — guarde num lugar seguro.

Authorization: Bearer clinpro_live_sua_chave_aqui

Cada chave carrega só os escopos que você marcou. Se faltar escopo, a API responde 403 insufficient_scope.

Escopos / permissões

O que cada chave pode fazer:

Endpoints

curl "https://app.gestaoclinpro.com.br/api/v1/contacts?limit=50" \
  -H "Authorization: Bearer clinpro_live_sua_chave"

curl -X POST "https://app.gestaoclinpro.com.br/api/v1/contacts" \
  -H "Authorization: Bearer clinpro_live_sua_chave" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Maria Silva",
    "phone": "41999998888",
    "email": "maria@email.com",
    "procedure_interest": "Botox",
    "source": "site"
  }'

curl "https://app.gestaoclinpro.com.br/api/v1/appointments?from=2026-07-01&to=2026-07-31" \
  -H "Authorization: Bearer clinpro_live_sua_chave"

curl -X POST "https://app.gestaoclinpro.com.br/api/v1/appointments" \
  -H "Authorization: Bearer clinpro_live_sua_chave" \
  -H "Content-Type: application/json" \
  -d '{
    "patient_name": "Maria Silva",
    "phone": "41999998888",
    "procedure": "Botox",
    "professional": "Dra. Lorraine",
    "datetime": "2026-07-20T14:30:00-03:00",
    "duration_minutes": 30
  }'

curl "https://app.gestaoclinpro.com.br/api/v1/pipeline" \
  -H "Authorization: Bearer clinpro_live_sua_chave"

curl -X POST "https://app.gestaoclinpro.com.br/api/v1/messages" \
  -H "Authorization: Bearer clinpro_live_sua_chave" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "41999998888",
    "message": "Oi! Sua consulta está confirmada 💜",
    "tipo": "transacional"
  }'

# 200 · a mensagem saiu
{ "sent": true, "phone": "41999998888", "tipo": "transacional",
  "limite_diario": 500, "enviadas_hoje": 12 }

Envio de WhatsApp · tipos, limites e recusas

O WhatsApp da clínica é o número dela. Um script que despeja a base em minutos derruba esse número, e aí a clínica perde todo o atendimento. Por isso POST /messages passa por travas de horário, teto diário e descadastro, e a resposta sempre diz por que uma mensagem não saiu.

O campo tipo

É opcional. Se você não mandar, vale marketing, que é o mais restrito. O padrão é o apertado de propósito: errar para esse lado custa uma mensagem parada com o motivo escrito na resposta, errar para o outro custa mensagem para quem pediu para não receber mais.

O teto de marketing é do número, não da funcionalidade: follow-up, disparo em massa e API somam no mesmo balde. Toda chamada, aceita ou recusada, fica registrada com o tipo que você declarou.

Quando a mensagem é recusada

A resposta traz error (o código), message (a frase que explica o motivo em português) e o contexto para você decidir o que fazer: limite_diario, enviadas_hoje, janela e proxima_abertura. Nunca reenvie em laço: 429 e 503 pedem para esperar, e 403 não vai mudar tentando de novo.

# 429 · fora do horário
{
  "error": "fora_da_janela",
  "message": "Fora da janela de envio (das 09:00 às 20:00, horário de Brasília). Mensagem automática de clínica não sai de madrugada.",
  "tipo": "marketing",
  "limite_diario": 200,
  "enviadas_hoje": 37,
  "janela": { "inicio": "09:00", "fim": "20:00" },
  "proxima_abertura": "2026-07-12T12:00:00.000Z"
}

Fora dessas, 502 send_failed quer dizer que o WhatsApp recusou o envio. Aí sim vale tentar de novo, com espaço entre as tentativas.

Webhooks

Em vez de ficar consultando a API, deixe o ClinPRO avisar você quando algo acontece. Cadastre uma URL (ex: um webhook do Zapier/Make/n8n) e escolha os eventos. Enviamos um POST assinado com HMAC-SHA256 no cabeçalho x-clinpro-signature.

POST https://sua-url.com/webhook
x-clinpro-event: lead.created
x-clinpro-signature: <hmac-sha256 do corpo>

{
  "event": "lead.created",
  "created_at": "2026-07-11T18:00:00.000Z",
  "data": { "contact": { "id": "...", "name": "Maria Silva", "phone": "41999998888" } }
}

Integra com o quê?

A conexão acontece pela nossa API através do Zapier, Make ou n8n — não temos integração nativa de 1 clique. Qualquer ferramenta com conector nessas plataformas dá pra ligar. Exemplos:

Não achou o seu sistema? Se ele tem Zapier/Make/n8n ou aceita webhooks, dá pra conectar. Fale com a gente.