Como embarcar o SDK de prescrição médica
Passos para colocar a prescrição assinada dentro do seu sistema com o SDK em iframe.
- 1
Cadastre as origens
Informe os domínios do seu sistema para liberar o carregamento do iframe.
- 2
Inclua o script
Adicione o SDK JavaScript na página onde a prescrição deve aparecer.
- 3
Identifique o médico
Passe os dados do profissional; o SDK conduz o onboarding e a validação do CRM.
- 4
Escute os eventos
Receba avisos de documento assinado, erro e fechamento via postMessage.
O que o SDK entrega pronto
- Editor de prescrição com autocomplete de medicamentos.
- Modelos de receita do sistema e modelos pessoais do médico.
- Cadastro e busca de pacientes por CPF, com vínculo ao médico.
- Assinatura com VidaaS ou BirdID e sessão reutilizável.
- Envio ao paciente por WhatsApp e compartilhamento do PDF.
- Histórico com status do documento e link público de validação.
SDK em iframe x API REST
| Critério | SDK em iframe | API REST |
|---|---|---|
| Tempo de integração | Horas | Dias |
| Interface | Pronta | Você constrói |
| Base de pacientes | Gerenciada pelo SDK | Sua base |
| Fluxo de assinatura | Incluso | Você orquestra |
| Personalização visual | Limitada | Total |
| Indicado para | Telemedicina, clínicas, MVPs | PEP e sistemas com UI própria |
Requisitos de integração
- Domínios de produção e homologação cadastrados como origens permitidas.
- Atributo allow="web-share" no iframe, para o compartilhamento nativo do PDF funcionar no celular.
- Área com altura suficiente para o fluxo em telas pequenas.
- Tratamento dos eventos de assinatura para atualizar o prontuário do seu lado.
Eventos disponíveis
| Evento | Quando dispara | O que fazer |
|---|---|---|
| Documento assinado | Assinatura concluída com sucesso | Anexar ao atendimento e liberar o download |
| Documento enviado | Envio ao paciente concluído | Registrar a entrega no histórico |
| Erro | Falha de autenticação, sessão ou assinatura | Exibir mensagem e permitir nova tentativa |
| Abrir link | Compartilhamento sem suporte nativo | Abrir a URL em nova aba |
Segurança do iframe
O SDK só carrega em origens previamente autorizadas para a sua chave de parceiro. A autenticação do médico acontece dentro do iframe, com código enviado por WhatsApp, e o token nunca é exposto para a página que hospeda o componente.
Cada sessão fica registrada em auditoria, com escopo, validade e expiração do certificado usado — informação útil para suporte e para conformidade.
Quando preferir a API pura
Se o seu produto já tem cadastro de pacientes, modelos de conduta e uma interface de prescrição consolidada, a API REST costuma ser a melhor escolha: você mantém a sua UI e usa a plataforma apenas para gerar o documento assinado. Muitos parceiros começam com o SDK para validar a demanda e migram para a API depois.