Widgets — Visão geral

Widget é uma pesquisa que a pessoa abre por vontade própria — diferente dos disparos (Comunicação), que abrem sozinhos ao navegar. Todo widget é configurado na plataforma PliQ; o plugin apenas renderiza/dispara o que foi configurado.

Novidades da v7

Os widgets de ação (action), o envio de properties/tags na resposta e as variáveis globais (placeholders) foram introduzidos na v7. Em versões anteriores só existem os widgets flutuantes (button/bubble/triangle), sem properties/tags. Ver Novidades.

Tipos de widget

Tipo	Como aparece	Como abre	Onde se configura
button	Botão retangular fixo na lateral da tela	A pessoa clica	Plataforma
bubble	Ícone circular flutuante no canto	A pessoa clica	Plataforma
triangle	Aba/triângulo fixado num canto	A pessoa clica	Plataforma
action	Nenhum elemento do plugin	O seu site dispara	Plataforma + seu HTML

• button / bubble / triangle são os flutuantes — o plugin desenha o botão e a pessoa clica. Ver Widgets flutuantes.
• action não tem botão do plugin: você dispara de um elemento do seu site. Ver Widgets de ação.

Direcionamento (targeting)

Os widgets flutuantes respeitam o alvo configurado na plataforma:

• Dispositivo — desktop / tablet / mobile
• Regras de URL — em quais telas o botão aparece

O action ignora o targeting

Como quem decide a hora de abrir é o seu site, o widget de ação não depende de device/URL. O targeting governa só os widgets flutuantes.

O JSON do widget

O plugin recebe os widgets na resposta do initialize, na lista widgets. Cada widget tem esta forma:

{
  "id_survey": "9001",
  "name": "pesquisa-atendimento",
  "url_survey": "7e05d6f8...",
  "type_view": 3,
  "active": true,
  "properties": { "origem": "{current_url}" },
  "tags": ["plugin"],
  "buttonOptions": { "type": "action" },
  "popupOptions": { "type": "centered", "position": "bottom-right" }
}

Campo	Descrição
name	Novidade da v7. Identificador amigável (usado pelo action no data-pliq-widget / openWidget)
buttonOptions.type	button / bubble / triangle (flutuante) ou action (v7, sem botão)
type_view	Tipo do player: 1 (play) / 3 (wizard). 0 (basic) não suporta properties/tags
active	Se false, o widget não aparece nem abre
properties	v7. Campos enviados na resposta. Chave = internal_name de uma property de texto; valor aceita placeholders como {current_url}
tags	v7. Tags enviadas na resposta
popupOptions	Formato do modal (centrado ou lateral, tamanho, posição)