Guia prático

Escolha onde o widget aparece

Tire o widget de chat e a central de ajuda das páginas em que eles atrapalham e mostre-os exatamente quando ajudam: para clientes logados, durante uma campanha ou depois que alguém está lendo há algum tempo.

Onde encontrar

Abra Canais, selecione o canal do seu site, abra a aba Chat ao vivo e role até Onde o widget aparece. Proprietários e administradores podem alterar essa configuração. Selecione Salvar alterações quando terminar. Os visitantes recebem as novas regras no próximo carregamento de página.

Listas de permissão e de bloqueio

Em Páginas, escolha um destes três modos:

  • Mostrar em todas as páginas: O padrão. Nenhuma lista de páginas é usada.
  • Mostrar apenas nestas páginas: Uma lista de permissão. O widget aparece apenas onde um padrão corresponde.
  • Ocultar nestas páginas: Uma lista de bloqueio. O widget aparece em todo lugar, exceto onde um padrão corresponde.

Adicione um padrão por página. Comece o padrão com / para corresponder a um caminho em qualquer um dos seus domínios, ou inclua o domínio para mirar um único site. * corresponde a qualquer coisa. A correspondência ignora maiúsculas e a query string, a menos que o padrão contenha ?.

PadrãoCorresponde a
/pricingExatamente /pricing (uma barra no final é ignorada)
/blog/*Todas as páginas dentro de /blog/, mas não o próprio /blog
/blog*/blog e todas as páginas dentro dele
*checkout*Qualquer caminho que contenha checkout
shop.example.com/*Todas as páginas desse domínio (www. é ignorado)
/pricing?plan=*/pricing apenas quando tiver um parâmetro plan

Mostre o widget com base em gatilhos

Em Mostrar apenas quando, adicione até 20 condições. Com mais de uma, escolha entre Todas as condições e Qualquer condição. O widget aparece apenas em uma página permitida e quando as condições são atendidas. Datas e horários usam o fuso horário do espaço de trabalho, definido nas configurações do espaço de trabalho.

CondiçãoO que verificaExemplo
URL da páginaO endereço completo da página atual. A opção “corresponde ao padrão” usa os mesmos curingas da lista de páginas.contém /pricing
Parâmetro da URLUm parâmetro de query, como uma campanha ou um cupom. Use a opção “está definido” para verificar apenas se ele existe.utm_campaign é summer-sale
Veio de (referenciador)A página de onde o visitante veio.contém google.
E-mail do visitanteO e-mail que o seu site enviou com identify ou que o visitante digitou. Use a opção “está definido” para mostrar “apenas a visitantes logados”.termina com @acme.com
Atributo do visitanteQualquer atributo que o seu site envia com identify ou setAttributes: um ID de usuário, grupo, plano ou campo personalizado. Compara texto, números e verdadeiro/falso de forma exata.group é um destes vip, beta
DataA data de hoje, a partir de e/ou até um dia (ambos incluídos).de 2026-11-24 até 2026-11-30
Dia e horárioDias da semana e uma faixa de horário. Uma faixa que termina antes de começar passa da meia-noite.Seg–Sex, de 09:00 até 17:00
DispositivoCelular, ou Tablet ou computador.Celular
Idioma do navegadorO idioma do navegador do visitante. de abrange de-CH e de-AT.é de
Tempo na páginaSegundos desde que o visitante abriu a página atual. O widget aparece assim que o tempo é atingido.pelo menos 15 segundos

As regras são verificadas de novo sempre que o visitante vai para outra página em um app de página única, quando o seu site envia novos atributos e a cada minuto enquanto houver uma condição de data ou horário. Se o chat estiver aberto quando as regras o ocultarem, ele fecha. A conversa é mantida para quando o widget voltar.

Envie os valores que suas regras verificam

As condições de e-mail e de atributo do visitante leem o que o seu site passa para o widget. Visitantes logados que usam identidade verificada (userJwt) também devem enviar email se uma condição de e-mail precisar dele.

HTML
<script>
  // Send the values your display rules check
  sonny('identify', {
    email: 'anna@acme.com',
    attributes: { userId: 'u_123', group: 'vip', seats: 12 }
  });

  // Later, when something changes
  sonny('setAttributes', { group: 'beta' });
</script>

Substitua as regras pelo seu código

O seu próprio código sempre prevalece. sonny('show') e sonny('hide') ignoram as regras até a página ser recarregada.

HTML
<script>
  sonny('hide'); // hide the widget, whatever the rules say
  sonny('show'); // show it again, whatever the rules say
  sonny('open'); // opens the chat, and shows the widget if rules hid it
</script>

Bom saber

  • As regras de exibição ocultam o widget. Elas não restringem o acesso: qualquer pessoa ainda pode carregá-lo.
  • As regras valem para o widget inteiro, incluindo a aba Ajuda. O site público da sua central de ajuda não é afetado.
  • Os SDKs para iOS e Android ignoram as regras de exibição. O app decide quando abrir o chat.
  • A página de visitantes ao vivo continua listando pessoas em páginas onde o widget está oculto.

Documentos relacionados