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 excetoapiKey: 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.
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 noinit().
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:- No seu backend, chame o set consultation context
com a chave secreta do médico (
sk_…, o par dapk_…da sua página). Coloque o histórico empastMedicalHistory. - Abra o embed para a mesma consulta e o mesmo paciente:
consultation.externalConsultationIdé oconsultationInternalIdque você enviou, epatient.idCountry · idType · idValueé a identidade que você enviou. - Quando o médico inicia a consulta, o card mostra o seu histórico.
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 eminit({ 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:
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.