API, webhooks e assistente de IA: ligar o CliLink a outros sistemas

Ligar no Zapier ou no Make

1. 1

   Crie o gatilho

   No Zapier, use Webhooks by Zapier, gatilho Catch Hook. No Make, um cenário com Webhooks, Custom webhook. Copie a URL que eles mostram.

2. 2

   Cadastre no CliLink

   Em Configurações, Conta, Avançado, Integrações, aba Webhooks, toque em Novo webhook, cole a URL e escolha os eventos.

3. 3

   Guarde o segredo

   O segredo aparece uma vez só. Ele serve para o seu sistema conferir que o aviso veio mesmo do CliLink.

4. 4

   Envie um teste

   Toque em Enviar teste. O Zapier ou o Make recebe um aviso de exemplo e passa a conhecer os campos (evento, consulta, paciente).

5. 5

   Monte o resto

   Use os campos para o que quiser: linha na planilha, mensagem para a equipe, cartão no quadro de tarefas.

Eventos

• consulta.criada: toda consulta nova, pela página, pelo painel, pela API, pela lista de espera ou em série (uma por consulta).
• consulta.confirmada: quando a consulta fica confirmada (criada já confirmada, pedido aprovado ou sinal pago).
• consulta.cancelada: pelo paciente, pela equipe, em série ou porque o sinal venceu.
• consulta.remarcada: mudou de horário; leva também o início anterior.
• sinal.pago: o sinal da consulta foi pago ou marcado como pago.
• contato.novo: pedido de contato pela página (nome, WhatsApp e origem; a mensagem escrita não vai).
• paciente.criado: paciente cadastrado no painel, pela API ou ao agendar pela página. A importação por planilha não dispara.

Como é o aviso

Um POST em JSON com id (do evento), evento, criado_em, teste, conta e dados. Na consulta: horário de início e fim, status, se é online, os ids do tipo e do local e a origem, mais o id e o nome do paciente. Nunca vai prontuário, anotação, motivo da consulta nem o nome do tipo de consulta.

Cabeçalhos: X-CliLink-Evento, X-CliLink-Entrega (use para não processar o mesmo aviso duas vezes) e X-CliLink-Assinatura no formato t=carimbo,v1=assinatura. Para conferir: calcule o HMAC-SHA256 do texto carimbo, ponto, corpo exatamente como chegou, com o segredo do webhook, e compare com o v1. Recuse carimbos com mais de 5 minutos.

Entrega e novas tentativas

• Resposta 2xx em até 10 segundos conta como entregue.
• Erro, demora ou redirecionamento: tentamos de novo em 1 minuto, 5 minutos, 30 minutos, 2 horas e 6 horas.
• As últimas entregas aparecem embaixo de cada webhook, com o resultado. Uma entrega que falhou pode ser reenviada.
• Depois de 20 avisos perdidos seguidos, o webhook desliga sozinho. Ligue de novo quando o outro sistema voltar.
• O endereço precisa ser https e público. Endereços de rede interna são recusados.

Tokens e permissões

Em Integrações, aba Tokens, toque em Criar token, dê um nome e marque só o que o sistema precisa: ver a agenda, mudar a agenda, ver ou cadastrar pacientes, ver pedidos de contato, ver pagamentos, cobrar sinal, ver ou editar a página e gerenciar webhooks. Escolha também a validade (sem prazo, 30, 90 dias ou 1 ano). Até 10 tokens ativos.

O token aparece uma vez só, guarde como uma senha. Na lista aparecem as permissões, a validade e o último uso. Revogar corta o acesso na hora.

Tokens criados antes das permissões continuam funcionando só para os dados básicos da conta. Para usar a agenda, os pacientes ou a página, crie um novo.

Assistente de IA (MCP)

Com um token com o modelo Assistente de IA (MCP), o Claude ou outro assistente que aceita MCP vê a agenda, procura horários livres, marca, remarca e cancela consultas, busca pacientes, mostra os números da página e ajusta textos. Antes de mudar algo, ele mostra o que vai fazer e pede a sua confirmação.

A aba MCP mostra o endereço e os passos para o Claude Desktop e o Claude Code. Prontuário não sai pelo assistente. Os dados que ele lê vão para a empresa do assistente: prefira permissões mínimas.

Histórico de uso

A aba Histórico mostra as chamadas dos últimos 30 dias: quando, qual token, o que foi pedido e o resultado. Guardamos só isso, nunca os dados que foram e voltaram.

Perguntas frequentes

Os avisos levam dados de saúde?

Não. Só horário, status, ids e o nome do paciente. Prontuário, anotações e o nome do tipo de consulta ficam no CliLink.

O mesmo aviso pode chegar duas vezes?

Pode, se o seu sistema demorar para responder e tentarmos de novo. Use o cabeçalho X-CliLink-Entrega para ignorar o repetido.

Troquei o segredo. O que acontece?

O antigo para de valer na hora. Atualize o segredo no outro sistema.

O assistente de IA pode mexer na agenda sozinho?

Só com um token que tenha a permissão de mudar a agenda, e ele pede a sua confirmação antes. Com um token só de leitura, ele só consulta.

A API mostra o prontuário?

Não. Não existe permissão para isso. Pela API e pelo assistente saem só agenda, cadastro do paciente, contatos, pagamentos e textos da página.