Desenvolvedores

API e MCP do CliLink

Ligue a agenda, os pacientes e a página do consultório a outros sistemas e a assistentes de IA. Token por conta, permissões, primeira chamada em minutos.

O que dá para fazer

  • API v1 (REST, JSON): agenda, horários livres, pacientes (só cadastro), pedidos de contato, sinais e recebimentos, textos da página e webhooks. Ver a referência.
  • Webhooks: o CliLink avisa a sua URL quando uma consulta é marcada, confirmada, remarcada ou cancelada, quando um sinal é pago e quando chega um contato. Como funcionam.
  • MCP: o assistente de IA (Claude e outros) vê a agenda, procura horários, marca consultas e ajusta textos da página, sempre pedindo confirmação antes de mudar algo. Como conectar.
Prontuário, anotações internas e CPF nunca saem pela API, pelos webhooks ou pelo MCP. Detalhes em Segurança e LGPD.

1. Crie um token

No painel do CliLink, abra Configurações > Conta > Avançado > Integrações > Tokens e toque em Criar token. Dê um nome, marque só as permissões que o sistema vai usar (por exemplo, agenda:read) e escolha a validade. O token aparece uma vez: copie e guarde como uma senha.

2. Faça a primeira chamada

Consultas de hoje e dos próximos 6 dias:

curl
export CLILINK_TOKEN="clk_..."

curl "https://app.clilink.bio/api/v1/agenda/consultas" \
  -H "Authorization: Bearer $CLILINK_TOKEN"
JavaScript (Node 18 ou mais, ou navegador do seu servidor)
const r = await fetch("https://app.clilink.bio/api/v1/agenda/consultas", {
  headers: { Authorization: `Bearer ${process.env.CLILINK_TOKEN}` },
});
const corpo = await r.json();
if (!corpo.ok) throw new Error(corpo.erro.mensagem);
for (const c of corpo.data) console.log(c.dia, c.hora, c.paciente?.nome, c.status);

A resposta:

200 OK
{
  "ok": true,
  "data": [
    {
      "id": "9b2f6c1e-1d2a-4c55-9a51-0d7e3b1c2a10",
      "inicio": "2026-10-28T13:00:00.000Z",
      "fim": "2026-10-28T13:40:00.000Z",
      "dia": "2026-10-28",
      "hora": "10:00",
      "fuso": "America/Sao_Paulo",
      "status": "confirmado",
      "online": false,
      "origem": null,
      "tipo": { "id": "3c5d1f20-8a7b-4c1e-9f00-1a2b3c4d5e6f", "nome": "Primeira consulta" },
      "local": null,
      "paciente": { "id": "5e8a2b44-7c1d-4f3e-8b9a-2c3d4e5f6a7b", "nome": "Maria Exemplo" },
      "valor_centavos": 35000,
      "presenca_confirmada_em": null,
      "criado_em": "2026-10-21T15:00:00.000Z"
    }
  ],
  "proximo_cursor": null
}

3. Marque uma consulta

Veja os horários livres de um tipo de consulta e marque um deles. Mande uma Idempotency-Key nova por pedido: se a rede cair e você mandar de novo, a consulta não é marcada duas vezes.

curl
curl "https://app.clilink.bio/api/v1/agenda/horarios-livres?tipo_id=3c5d1f20-8a7b-4c1e-9f00-1a2b3c4d5e6f" \
  -H "Authorization: Bearer $CLILINK_TOKEN"

curl -X POST "https://app.clilink.bio/api/v1/agenda/consultas" \
  -H "Authorization: Bearer $CLILINK_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"paciente_id":"5e8a2b44-7c1d-4f3e-8b9a-2c3d4e5f6a7b","tipo_id":"3c5d1f20-8a7b-4c1e-9f00-1a2b3c4d5e6f","dia":"2026-10-28","hora":"10:00"}'

Endereços

  • API: https://app.clilink.bio/api/v1
  • OpenAPI 3.1: https://app.clilink.bio/api/v1/openapi.json (use no Postman, Insomnia ou para gerar um cliente)
  • MCP: https://app.clilink.bio/api/mcp

Próximo passo: permissões, limites e erros.

Atualizada em 21/10/2026. Dúvida ou algo faltando? contato@clilink.bio.