Início rápido - Telepatia Integration Hub

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.

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.

Crie uma smart template — salve o id

Crie uma smart template. Salve o id mrc_… devolvido; você o passa para init().

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 por https ou localhost — o microfone precisa de um contexto seguro. O embed lê window.TelepatiaEmbedConfig ao carregar e se monta sozinho.

<script>
  window.TelepatiaEmbedConfig = {
    apiKey: "pk_…",                       // publishable key — never the sk_
    settings: { locale: "en", branding: { name: "Your Brand" } },
    scribeContext: { show: true },        // Scribe: record + note
    intelligence:  { show: true },        // Telepatia Intelligence copilot
    cdss:          { show: true },        // CDSS review on the finished note
  };
</script>
<script src="https://cdn.telepatia.ai/telepatia-embed/v1/telepatia-embed.js"></script>

Cada capability só renderiza quando a sua instituição tem a permissão, então deixar um flag ligado é seguro. Use uma chave de teste enquanto constrói (sem dados reais) e a chave de produção para ir ao ar — o mesmo código, sem flag de ambiente.

Abra o painel

O embed expõe window.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.

document.getElementById("record").addEventListener("click", () => {
  window.TelepatiaEmbed.init({
    patient:      { name: "Maria Gómez", idCountry: "CO", idType: "CC", idValue: "55544433" },
    template:     { medicalRecordConfigurationId: "mrc_…" },
    consultation: { externalConsultationId: "CONSULT-12345" }, // your encounter id
  });
});

Passe sempre o seu próprio externalConsultationId — é como você busca o resultado depois. Sem ele, a Telepatia gera um que você não consegue ver. init() também abre o painel; um TelepatiaEmbedConfig sem init() monta direto uma capability sem gravador.

Obtenha o resultado

O seu externalConsultationId é 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

O schema completo do registro e o formato de erro vivem no produto Scribe API neste Hub.

​Configuração (uma vez, via Scribe API)

​Adicione o script

​Abra o painel

​Obtenha o resultado

Configuração (uma vez, via Scribe API)

Adicione o script

Abra o painel

Obtenha o resultado