Configuração (uma vez, via Scribe API)
Faça isto uma vez por médico com a Scribe API (institucional), com a sua chave institucional. Não tem uma? Peça ao seu contato na Telepatia.1
Registre o médico — salve as duas chaves
Crie uma conta de médico. A resposta devolve duas chaves, mostradas uma só vez:
publishableApiKey (pk_…) vai na página; apiKey (sk_…) é a secreta — só backend, nunca o navegador.2
Crie uma smart template — salve o id
Crie uma smart template. Salve o id
mrc_… devolvido; você o passa para init().3
Crie um webhook
Assine o
scribe_session.completed. Salve o signingSecret para verificar as chamadas. É assim que o seu backend sabe que uma nota está pronta.Adicione o script
Coloque o bloco de configuração antes da tag do CDN. Sirva a página porhttps
ou localhost — o microfone precisa de um contexto seguro. O embed lê
window.TelepatiaEmbedConfig ao carregar e se monta sozinho.
Se a sua página define uma Content-Security-Policy
O embed envia eventos de uso parahttps://posthog.telepatia.ai: os ids do
médico e da instituição, quando o painel abre e os erros. Envia os próprios
registros de erros, com os mesmos ids, para https://datadog.telepatia.ai.
Nunca dados do paciente nem texto da nota. Se a sua página define uma
Content-Security-Policy, adicione estes hosts a connect-src:
Abra o painel
O embed expõewindow.TelepatiaEmbed. Chame init() quando o médico clicar em
gravar — monta e abre o painel. Passe o contexto que o seu app já tem para que a
nota volte ligada à consulta certa.
Obtenha o resultado
O seuexternalConsultationId é o consultationInternalId da Scribe API — o
mesmo valor, outro nome. Quando o webhook scribe_session.completed disparar,
busque o registro no seu backend com a chave secreta (sk_), nunca o navegador:
- Busque a sessão —
GET /v1/scribe-sessions/{consultationInternalId} - Liste os documentos do registro —
GET /v1/scribe-sessions/{consultationInternalId}/medical-record-documents