Pular para o conteúdo principal
window.TelepatiaEmbedConfig (lido ao carregar) e TelepatiaEmbed.init() têm a mesma forma; init() vence quando ambos definem um campo. Tudo é opcional exceto a publishable key e, com o Scribe, o ID da consulta.

Configuração rápida

O bloco mínimo para ir ao ar: a chave, um locale, a sua marca e as capabilities que você quer. Cada capability só renderiza quando a sua instituição tem a permissão.

Configuração completa

Todos os campos, anotados. Todos são opcionais exceto apiKey: sem ela, init() lança um erro e não monta nada. Com o Scribe, consultation.externalConsultationId também é obrigatório: sem ele, init() não lança erro, e o painel mostra uma tela de erro. Os valores padrão mostrados são os que o embed usa quando você omite um campo.

Campos de configuração

Capabilities

Cada capability é um flag { show }. O que monta é show E a permissão da instituição, então um flag sem permissão não renderiza nada. Sem scribeContext, o embed monta uma superfície sem gravador (CDSS e/ou Telepatia Intelligence) sem motor de áudio no seu grafo. intelligence.documents adiciona uma sub-aba Documentos dentro do copiloto. Um id de sessão em cdss.scribeSessionId ou em intelligence.chat.recentConsultations[].id é o id ss_… que a API pública e os webhooks devolvem. Um UUID de sessão também funciona.

O ID da consulta

Com o Scribe, consultation.externalConsultationId é obrigatório. É o seu id da consulta, e é com ele que você busca o resultado. Cada id guarda uma só gravação, então envie um id novo para cada consulta. O embed confere o id quando o painel abre. Se o id falta, tem um ponto (.), ou outra gravação já o usa, o painel mostra só uma tela com “Há um problema com o identificador desta consulta.” e “Entre em contato com o suporte de TI da sua instituição.” O médico não consegue iniciar uma gravação, e as outras abas não aparecem. init() não lança erro quando o id falta: a tela aparece no lugar. O console do navegador recebe uma linha que começa com [Telepatia Embed]. A mesma tela aparece quando o médico abre de novo uma consulta que já tem uma gravação. Para gravá-la de novo, abra o embed com um id novo.
Não use um id fixo, nem nos seus testes. A segunda gravação com o mesmo id mostra a tela.

Sincronize os campos do seu EMR

Aponte o embed para os campos de notas e de histórico clínico da página do seu EMR. O embed mantém esses campos iguais às próprias Notas e ao Histórico clínico do paciente, nos dois sentidos: o que o médico digita na sua página aparece no embed, e o que ele digita no embed aparece na sua página. Você não escreve código de DOM.
O embed vê o que uma pessoa digita no seu campo. Se o seu próprio código muda o valor do campo sem um evento input, o embed lê esse valor só ao iniciar e a cada nova consulta. Para um campo dentro de um shadow root fechado, passe o elemento, não um seletor. bind precisa de scribeContext: { show: true }.

Envie o histórico clínico do paciente

O card Histórico clínico do paciente mostra ao médico o que você já sabe do paciente, e a Telepatia o lê quando escreve a nota. Para preenchê-lo, passe o histórico no init().
Quando o médico inicia a consulta, o card mostra o seu histórico. Em cada consulta, chame destroy() e então init() com o histórico desse paciente. O embed mantém o histórico só para esse init(): ele não o salva no navegador, e a consulta seguinte nunca o mostra.

Ou envie pelo seu backend

Se o seu backend já tem o histórico, ele pode enviá-lo no lugar:
  1. No seu backend, chame o set consultation context com a chave secreta do médico (sk_…, o par da pk_… da sua página). Coloque o histórico em pastMedicalHistory.
  2. Abra o embed para a mesma consulta e o mesmo paciente: consultation.externalConsultationId é o consultationInternalId que você enviou, e patient.idCountry · idType · idValue é a identidade que você enviou.
  3. Quando o médico inicia a consulta, o card mostra o seu histórico.
Se você enviar um histórico pelos dois caminhos, vence o do init(). Um pastMedicalHistory vazio no init() mantém o que o seu backend enviou.
Envie o contexto uma vez por consulta, antes de o médico abrir o embed. Se você enviar scribeSessionModality, a consulta o usa. O template é sempre o do init() ou a escolha do médico, nunca um enviado com o contexto.

Combine com o seu site

settings.theme aceita uma paleta. O embed pinta com uma escala de marca e uma escala neutra. Dê uma cor para cada uma (o embed mistura os outros tons a partir dela) ou os tons que você já usa. A paleta substitui o CSS que você injeta no shadow root: remova esse CSS.
Com uma paleta, o ícone do botão de enviar usa preto ou branco, o que se lê melhor sobre a sua marca. Sem paleta, mantém as cores padrão. Com intelligence.fillPhone, abaixo de 640 px o painel preenche a tela em todos os layouts, inline também. O campo de texto fica acima do teclado. O painel evita o notch e o indicador de início quando a sua página define viewport-fit=cover. Sem ele, nada muda num celular.

Métodos do TelepatiaEmbed

Depois de montar o painel, um novo init() aplica só open, callbacks e intelligence.onAnswer · onCitationOpen; os demais campos só valem após destroy() e então init(). Sem Scribe, init() retorna um handle:

Callbacks e erros

Registre-os em init({ callbacks }): onSessionStart(id), onSessionComplete(event), onError(message), onStateChange(state). O onSessionComplete do navegador é opcional — o webhook é o gatilho confiável. Num problema com o ID da consulta, onError recebe "externalConsultationIdMissing", "externalConsultationIdInvalid" ou "externalConsultationIdAlreadyUsed" (veja O ID da consulta). Os sinais de saúde disparam no window:
Os erros de busca do backend usam o formato padrão da Telepatia — conforme o code: authentication_required (401, chave inválida ou expirada), resource_not_found (404, id errado ou buscado cedo demais), resource_conflict (409, id reusado), rate_limit_exceeded (429). A tabela completa está na página de erros da Scribe API.