Início rápido - Telepatia Integration Hub

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

Faça isto uma vez por médico através da Scribe API (institucional), usando sua chave de API institucional. Não tem uma? Fale com seu contato na Telepatia.

Registre o médico — salve ambas as chaves

Crie uma conta de médico. A resposta retorna duas chaves, exibidas uma única vez: a publishableApiKey (pk_…) vai na página; a apiKey (sk_…) é o segredo — apenas no backend, nunca no navegador.

Crie um smart template — salve o id dele

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

Crie um webhook

Assine o evento scribe_session.completed. Salve o signingSecret para verificar as chamadas. É assim que o seu backend fica sabendo que uma nota está pronta.

Adicione o script

Coloque o bloco de configuração antes da tag da CDN. Sirva a página sobre https ou localhost — o microfone precisa de um contexto seguro.

<script>
  window.TelepatiaRecorderConfig = {
    apiKey: "pk_…",              // chave publicável — nunca a sk_
    branding: { name: "Your Brand" },
    locale: "en",                // "en" · "es" · "pt"
  };
</script>
<script src="https://cdn.telepatia.ai/telepatia-embed/v0/embed.js"></script>

Use uma chave de teste enquanto desenvolve (sem dados reais) e sua chave de produção para ir ao ar. Mesmo código, sem flag de ambiente.

Abra o painel

Chame init() quando o médico clicar em gravar — ele monta e abre o painel. Passe o contexto que seu app já possui (o paciente e o template do médico) para que a nota volte vinculada à consulta correta.

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

Sempre passe seu próprio externalConsultationId — é assim que você busca o resultado depois. Sem ele, a Telepatia gera um que você não consegue ver. E use init() para abrir: show() só expande um painel que já está montado.

Obtenha o resultado

Seu externalConsultationId é o consultationInternalId da Scribe API — mesmo valor, nome diferente. Quando o webhook scribe_session.completed disparar, busque o registro no seu backend com a chave secreta (sk_), nunca no navegador:

Consulte 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 ficam 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