Guias
Incorporar o widget de voz
Ponha o seu agente publicado em qualquer site com uma tag de script.
O widget de voz permite que os visitantes do seu próprio site falem com o seu agente publicado — sem precisarem de conta Diska.
Pré-requisitos
- O agente tem uma versão publicada (rascunhos nunca são servidos a visitantes).
- O link público está ativo em Definições de publicação → Link público.
Obter o código de incorporação
Abra Definições de publicação → Widget. Há duas variantes:
Script (recomendado) — cole antes de </body>. O loader desenha o botão flutuante (ou um cartão inline, conforme as definições do widget) e trata do abrir/fechar:
<script src="https://diska.ai/widget/v1.js" data-diska-token="pub_…" async></script>
Iframe (sem JavaScript) — para sites que bloqueiam scripts de terceiros. Um frame fixo, sem loader:
<iframe id="audio_iframe" src="https://diska.ai/widget/pub_…"
allow="microphone" width="400px" height="550px" scrolling="no"
style="position: fixed; bottom: 0; right: 0; background: transparent;
border: none; z-index: 999"></iframe>
Mantenha o atributo
allow="microphone" (a variante script define allow="microphone; autoplay" no iframe que cria). Sem ele o navegador recusa o acesso ao microfone dentro do frame cross-origin e a chamada nunca arranca.Aparência
Tudo o que é visual — cores, textos, flutuante vs inline, o visualizador — configura-se no separador Widget e aplica-se em direto; nunca precisa de voltar a colar o código. O widget fala sempre com a versão publicada do agente.
Resolução de problemas
- Não aparece nada na página — o widget esconde-se em vez de partir o seu site. Abra a consola do navegador:
[diska-widget] indisponívelsignifica que o link público está desligado ou o agente não tem versão publicada; um erro de rede indica o host da API que o loader tentou. - Outro host de API — instalações self-hosted ou de staging podem apontar o loader com
data-api-base="https://api.example.com/api/v1"na tag de script. - O pedido de microfone nunca aparece — verifique o atributo
allowacima e que o seu site é servido por HTTPS (os navegadores bloqueiam o microfone em origens inseguras).

