Personalização do widget

O widget é totalmente personalizável pelo painel. Você ajusta cores, posição, módulos e comportamento sem tocar no código do site.

Configuração pelo painel

As configurações ficam na página de edição do app, na aba Widget. As alterações são aplicadas automaticamente, basta salvar e recarregar a página onde o widget está instalado.

Identidade do visitante

Configuração	Tipo	Padrão	Descrição
allow_visitor_otp	booleano	true (ligado)	Permite que visitantes sem login se identifiquem por email e código de verificação para sugerir, votar, comentar e abrir chamados. Desligado, o widget mostra só o mural de sugestões em modo leitura para quem não tem data-user-token.

Veja o fluxo completo em Autenticação de usuários.

Tema

Configuração	Tipo	Padrão	Descrição
primary_color	hex	#3B82F6	Cor principal do botão e dos destaques.
position	enum	bottom-right	Posição na tela: bottom-right, bottom-left, top-right, top-left.
button_text	texto	Feedback	Rótulo do botão flutuante.
button_icon	enum	message-circle	Ícone do botão: message-circle, megaphone, lightbulb, help-circle ou none.
border_radius	pixels	8	Arredondamento das bordas do widget.

Exemplo: defina primary_color como #16A34A e button_text como Sugestões para um botão verde com o rótulo personalizado.

Formulário de sugestão

Os campos de emoção e categoria do formulário de nova sugestão não ficam nesta aba, eles ficam na aba Geral do app, na seção “Formulário de sugestão”. Veja Criando um app.

Módulos

Configuração	Tipo	Padrão	Descrição
suggestions	booleano	true	Habilita a aba de sugestões.
support	booleano	false	Habilita a aba de suporte/tickets.
default_tab	enum	suggestions	Aba aberta por padrão: suggestions ou support.

Se apenas um módulo estiver habilitado, o widget abre direto nele, sem mostrar as abas.

Comportamento

Configuração	Tipo	Padrão	Descrição
auto_open	booleano	false	Abre o painel automaticamente ao carregar a página.
trigger_delay	milissegundos	0	Tempo de espera antes da abertura automática.
close_on_outside_click	booleano	true	Fecha o painel ao clicar fora dele.

Exemplo: com auto_open ativo e trigger_delay em 5000, o painel abre sozinho 5 segundos após o carregamento.

Sobrescrevendo via atributos

Alguns valores podem ser sobrescritos diretamente no snippet, sem alterar o painel. Isso é útil quando o mesmo app é usado em contextos diferentes (por exemplo, idiomas distintos por página).

<script
  src="https://pliic.com/widget/v1.js"
  data-app-key="SUA_CHAVE_DO_APP"
  data-language="en"
  data-position="bottom-left"
  data-modules="suggestions"
  async
  defer
></script>

Atributo	Sobrescreve
data-language	Idioma detectado automaticamente.
data-position	position do painel.
data-modules	suggestions / support do painel.

Os atributos têm prioridade sobre as configurações do painel.