Guia de integração com IA

Coloque receita digital assinada no seu sistema conversando com uma IA

Você é médico criando seu próprio software ou desenvolvedor com pressa? Copie um prompt, cole no Lovable, ChatGPT ou Claude e tenha prescrição com assinatura ICP-Brasil funcionando em minutos.

Lovable
ChatGPT
Claude

Sou médico (ou clínica) e não programo

Você descreve o que quer, a IA constrói. Siga os 4 passos abaixo, use o Prompt Mestre e teste clicando. Sem termos técnicos — se algo der errado, cole o erro de volta na IA.

Sou desenvolvedor

Use os prompts para acelerar com Cursor, Claude Code ou ChatGPT — ou vá direto na referência da API, no OpenAPI 3.1 e na coleção Postman.

Em 4 passos

1

Peça sua chave de teste

Gratuita por 30 dias. Você recebe uma API Key e um API Secret — são como usuário e senha do seu sistema na Prescri.

2

Copie e cole o prompt

Escolha um dos prompts abaixo e cole no chat do Lovable, ChatGPT ou Claude. A IA lê nossa documentação e escreve o código.

3

Guarde as chaves em segredo

Quando a IA pedir, cole as chaves no cofre de segredos da ferramenta (no Lovable: Secrets). Nunca cole em telas ou no código.

4

Teste com uma receita

Emita uma receita de teste, assine com VIDaaS, BirdID ou certificado A1 e confira o PDF chegando no seu sistema.

Prompts prontos para copiar e colar

Funcionam no Lovable, ChatGPT e Claude. Comece pelo Prompt Mestre.

Prompt Mestre — sistema completo de prescrição
Quero integrar a API da Prescri (prescri.com.br) ao meu sistema para emitir receitas e documentos médicos assinados digitalmente com certificado ICP-Brasil.

CONTEXTO
- Documentação: https://www.prescri.com.br/desenvolvedores
- Especificação OpenAPI 3.1: https://www.prescri.com.br/openapi.json (leia antes de codar)
- Base URL: https://suykokupoevtdfalrzue.supabase.co/functions/v1
- Autenticação: headers "X-API-Key" e "X-API-Secret". Guarde as duas como segredos do servidor (PRESCRI_API_KEY e PRESCRI_API_SECRET). NUNCA coloque no front-end.

O QUE CONSTRUIR
1. Uma função de servidor (backend/edge function) que chama POST /api-signatures-create com:
   - provider: "vidaas" ou "birdid" (A3 em nuvem) — o médico escolhe
   - dados do médico: doctor_cpf, doctor_full_name, doctor_crm, doctor_crm_uf, doctor_specialty
   - o campo "document" (a Prescri gera o PDF pelo modelo dela), com:
     • title, patient (name, cpf), items (medicamento, posologia, quantidade) e/ou body_text (texto corrido para atestado/laudo)
     • branding opcional: logo_url, clinic_name, clinic_cnpj, clinic_phone, endereço
   - (alternativa) pdf_base64 ou pdf_url se eu já tiver meu próprio PDF
   - webhook_url apontando para a função do passo 3
2. Uma tela "Nova receita" com formulário de paciente + lista de medicamentos e um botão "Assinar".
   Ao clicar, chamar minha função do servidor e abrir a URL de autorização retornada para o médico assinar no app VIDaaS/BirdID.
3. Uma função de servidor que recebe o webhook da Prescri:
   - Validar o header X-Prescri-Signature: HMAC-SHA256 de "{timestamp}.{corpo_cru}" com o API Secret
   - Tratar os eventos signature.completed, signature.cancelled, signature.expired e signature.dispensed
   - Salvar status e o link do PDF assinado no meu banco
4. Uma lista "Minhas receitas" mostrando status (pendente, assinada, cancelada, dispensada) e botão para baixar/compartilhar o PDF.

REGRAS
- Mostre mensagens de erro claras ao usuário (ex.: certificado não autorizado, sem números SNCR).
- Não invente endpoints: siga exatamente o openapi.json.
- Ao terminar, me diga onde colar minhas chaves e como testar ponta a ponta.

Como usar em cada IA

Lovable

Ideal para quem não programa: cria o app completo (telas, banco de dados e servidor). Cole o prompt e, quando pedir, salve as chaves em Secrets.

Dica: peça "use Lovable Cloud para as funções de servidor".

ChatGPT

Ótimo para gerar o código e explicar cada passo. Cole o prompt e diga qual linguagem você usa (Node, Python, PHP…).

Dica: anexe o link do openapi.json e peça para ele seguir só o que está lá.

Claude

Excelente com projetos grandes e documentação longa. Funciona muito bem com Claude Code dentro do seu repositório.

Dica: peça "leia o openapi.json antes e liste os endpoints que vai usar".

Exemplos do que você pode criar

  • • Consultório próprio: agenda + prontuário + receita enviada no WhatsApp do paciente.
  • • Telemedicina: ao fim da videochamada, o médico assina a receita com um toque.
  • • Clínica de estética ou emagrecimento: protocolos salvos que viram receita em segundos.
  • • Software já existente: botão "Prescrever" dentro do seu prontuário eletrônico.

Dicionário sem complicação

API
Uma "tomada" pela qual o seu sistema conversa com a Prescri, sem ninguém clicar em nada.
Endpoint
Um endereço específico da API para cada ação, como "criar assinatura".
API Key / Secret
O usuário e a senha do seu sistema. Ficam guardados no servidor, nunca na tela.
Webhook
Um aviso que a Prescri manda para o seu sistema quando a receita é assinada, cancelada ou dispensada.
Prompt
O texto com instruções que você cola na IA para ela construir a integração.

Perguntas frequentes

Pronto para começar?

Peça sua chave de teste gratuita e cole o Prompt Mestre na sua IA favorita.