> For the complete documentation index, see [llms.txt](https://docs.voa.health/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.voa.health/integracao/plugin/fluxo-de-uso.md). # Fluxo de uso ## Instalação Para utilizar o Plugin, é necessário importar um script no HTML da página. As duas formas mais indicadas são: adicionar diretamente no HTML ou carregar o script programaticamente usando javascript. * **Adicionar diretamente no HTML** ```html ``` * **Adicionar programaticamente usando JavaScript:**

<script>
    (() => {
        const script = document.createElement("script");
        script.src = "https://integration.voa.health/plugin.js";
        script.type = "module";
        
        document.head.appendChild(script);
        
        script.onload = async () => {
            // Com o script carregado, uma instância do VoaPlugin estará disponível
            // no escopo global da página
            await VoaPlugin.instance.init({ token: "YOUR_API_KEY" });
        }
    })();
</script>

Ao carregar o script, um tipo VoaPlugin é adicionado ao contexto global da página. Na sequência, é necessário chamar a função de init passando o token de autenticação. ## Inicialização Para inicializar o plugin, execute a função *mount* e passe os identificadores internos da consulta no seu prontuário. Não é possível abrir mais de uma instância do Plugin na mesma página, portanto, chamadas dessa função enquanto há uma instância na tela não surtirão efeito.

await VoaPlugin.init({ token: "YOUR_API_KEY" });

VoaPlugin.instance.mount({
    doctorId: "", // Identificador do médico
    patientId: "", // Identificador do paciente
    consultationId: "", // Identificador da consulta
    options: {
        darkMode: false,
        allowCreateModels: false,
        enableFillEhr: true,
        consultationType: "IN_PERSON",
        allowChangeConsultationType: true
    },
});

#### Parâmetros de configuração O argumento *options* pode receber os seguintes parâmetros:

Option	Descrição	Tipo	Default
renderElement	Elemento HTML do DOM no qual o plugin será renderizado. Caso nenhum elemento seja informado, o plugin será uma janela flutuante na página com botões de fechar e minimizar/maximizar.	HTMLElement	undefined
darkMode	Habilita o modo noturno da UI.	Boolean	false
consultationType	Permite pré-selecionar o tipo da consulta.	"TELEMEDICINE" ou "IN_PERSON"	"IN_PERSON"
allowChangeConsultationType	Habilita a troca do tipo da consulta por parte do usuário.	Boolean	true
allowCopyDocument	Exibe um botão de "Copiar Documento" para área de transferência.	Boolean	true
enableFillEhr	Exibe um botão de preencher prontuário ao gerar documentos que dispara um evento com os dados do documento gerado.	Boolean	false
allowScreenSharing	Caso desabilitado, a opção de compartilhar o áudio da tela para consultas de telemedicina não será exibida para os usuários. A única forma de captar áudio passa a ser enviando programaticamente um mediaStream para o plugin. Veja mais.	Boolean	true
enableTelemetry	Permite que a Voa colete dados de uso do Plugin para identificação de bugs e melhorias.	Boolean	true
structuredOutputSchema	Objeto JavaScript correspondente ao schema desejado de documento estruturado da consulta. Se informado, ao usar "Preencher prontuário" o plugin envia a mensagem voa.plugin.ehr.fill com o documento em texto; os dados estruturados são enviados em mensagem separada voa.plugin.ehr.structured_output com o formato especificado. Veja como criar o schema.	Object	undefined
editorOptions	Objeto Javascript com configurações do editor de documentos do Plugin. Opções: - disableDragAndDrop Desabilita a feature de arrastar componentes do editor.	Object	`{ disableDragAndDrop: false }`

*** ### Desmontagem Para fechar uma instância aberta do Plugin, basta chamar a função *unmount*. Sempre utilize essa função ao invés de removê-lo manualmente do DOM da página para garantir sincronização dos dados e limpeza de memória. Caso o usuário feche o plugin manualmente, a desmontagem também é realizada (opção de fechar manualmente só é exibida caso nenhum [renderElement](#parametros-de-configuracao) seja utilizado) ```javascript VoaPlugin.instance.unmount(); ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.voa.health/integracao/plugin/fluxo-de-uso.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.