Diska
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

  1. O agente tem uma versão publicada (rascunhos nunca são servidos a visitantes).
  2. 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ível significa 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 allow acima e que o seu site é servido por HTTPS (os navegadores bloqueiam o microfone em origens inseguras).
Copyright © 2026