Saltar para o conteúdo
Anagen
PT EN
Pedir avaliação

Guia 1/12

Introdução e casos de uso

A API do AnagenSys permite que qualquer outro sistema — site, CRM, contabilidade, BI, laboratório ou parceiro — leia e escreva dados da clínica com as mesmas regras da equipa: a matriz de permissões, o âmbito de cada credencial e um registo de auditoria imutável.

O que pode fazer

  • Recursos genéricos (/r/<recurso>): listar, ler, criar, alterar, arquivar e executar ações em todos os tipos de registo (leads, marcações, pagamentos, tarefas…). A mesma definição serve a plataforma web, a app e esta API — comportam-se sempre da mesma forma.
  • Endpoints dos módulos: painel, indicadores, tarefas, chat, comunicados e tudo o que cada módulo documenta na referência.
  • Webhooks: a clínica avisa o seu sistema quando algo acontece (lead criado, pagamento recebido, cirurgia fechada…), com assinatura HMAC-SHA256.

Integrações típicas

1. Receber leads do site e dos anúncios

O servidor do formulário (ou o conector da plataforma de anúncios) cria o lead com a origem e as etiquetas UTM. Os duplicados são detetados; o lead entra no funil e as regras comerciais (atribuição, prazos, sequências) correm como se fosse a equipa a escrever. Use uma Idempotency-Key para que uma repetição nunca crie um segundo lead. Âmbito: crm.leads:editar.

curl -X POST "https://anagen.pt/api/v1/r/leads" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: form-2026-10-28-0412" \
  -d '{"nome":"Rita Matos","email":"rita@exemplo.pt","telefone":"+351912345678","origem":"site","utm_source":"google","utm_campaign":"fue-outono"}'

2. Sincronizar marcações com um calendário externo

Leia as marcações da semana e subscreva marcacao.criada para se manter atualizado sem perguntar a toda a hora. Âmbito: agenda:ver.

curl "https://anagen.pt/api/v1/r/marcacoes?f[inicio][de]=2026-11-01&f[inicio][ate]=2026-11-07&ordem=inicio:asc&por_pagina=100" \
  -H "Authorization: Bearer $TOKEN"

3. Enviar pagamentos para a contabilidade

Obtenha os pagamentos recebidos no mês (método, valor e documento fiscal) e subscreva pagamento.recebido. As faturas são emitidas pelo programa de faturação certificado; a API nunca expõe diagnósticos em registos financeiros. Âmbito: financeiro.pagamentos:ver.

curl "https://anagen.pt/api/v1/r/pagamentos?f[estado]=pago&f[pago_em][de]=2026-10-01&f[pago_em][ate]=2026-10-31&por_pagina=100&pagina=1" \
  -H "Authorization: Bearer $TOKEN"

4. Exportar indicadores para BI

Cada grupo de indicadores devolve os KPI com o período anterior e a variação, e as séries dos gráficos, com filtros por período, médico, comercial, origem do lead e procedimento. Para folhas de cálculo, a equipa pode ainda criar tokens pessoais de leitura (CSV/JSON). Âmbito: indicadores.vendas:ver (e os restantes grupos).

curl "https://anagen.pt/api/v1/indicadores/vendas?periodo=12m" \
  -H "Authorization: Bearer $TOKEN"

5. Receber eventos por webhook

A clínica regista o seu endereço HTTPS, escolhe os eventos e recebe um segredo mostrado uma única vez. Cada entrega vai assinada; veja Webhooks para o código de verificação em PHP, JavaScript, Python e C#.