Pluspoint — AI local marketing platform

Chat ao vivo no seu site

Atualizado em 21 de outubro de 2026

O trecho de código da aba Código do widget do canal é tudo de que um site precisa: cole-o uma vez e o botão de chat, a mensagem de boas-vindas e o formulário de contato aparecem em todas as páginas. Este artigo é para sites que querem mais — abrir o chat pelos próprios botões, acompanhar o chat nas suas ferramentas de análise, poupar o formulário aos clientes que já fizeram login, ou limitar onde o widget aparece. Tudo aqui é opcional; um site que não muda nada continua funcionando como hoje.

Antes de começar

  • Um canal de live chat com o trecho já no site — veja Canal de chat ao vivo.
  • Alguém que possa editar o HTML do site. Poupar o formulário aos clientes autenticados também exige uma pequena mudança no seu próprio servidor.
  • Configurações de conta definido como Completo, ou ser o proprietário da conta, para abrir a aba Código do widget do canal.

Onde encontrar

Configurações → Canais → o ícone de edição na linha Live-chat → aba Código do widget, ou acesse https://app.pluspoint.io/account-settings/channels.

Abrir o chat pelo seu próprio botão

Copie o trecho da aba Código do widget. Além de carregar o widget, ele define uma função pluspoint que a sua página pode chamar de qualquer lugar, mesmo antes de o widget terminar de carregar: as chamadas feitas cedo rodam assim que ele fica pronto. Com o id do seu canal no lugar dos X, ele tem esta aparência:

<!-- Pluspoint script -->
    <script>window.pluspoint=window.pluspoint||function(){(window.pluspoint.q=window.pluspoint.q||[]).push(arguments)};"loading"!==document.readyState?init():document.addEventListener("DOMContentLoaded",init);function init(){var t=document.createElement("script");t.id="pl-chat-widget",t.dataset.channelid="XXXXXXXXXX",t.src="https://app.pluspoint.io/widget/pl.widget.chat.min.js",document.getElementsByTagName("body")[0].appendChild(t)}</script>
<!-- End of Pluspoint script -->

Um trecho copiado antes de a parte window.pluspoint= existir continua mostrando o chat, mas pluspoint(...) não está definido naquela página. Copie-o de novo uma única vez.

Depois chame pluspoint('open') a partir de qualquer elemento da página:

<button onclick="pluspoint('open')">Fale com a gente</button>
ComandoO que faz
pluspoint('open')Abre a janela do chat.
pluspoint('close')Fecha a janela do chat; o botão de chat continua.
pluspoint('setLocation', '123')Atribui a conversa àquela localização e pula a pergunta sobre a localização. Use o mesmo ID que o link do chat aceita em ?locationId=.
pluspoint('setLanguage', 'ES')Muda o chat para esse idioma: GB, UA, PT, ES, PL, DE, BR, FR, RU ou MX. A mensagem de boas-vindas e a mensagem offline vêm da aba Mensagens do canal, então adicione esse idioma lá também.
pluspoint('identify', {…})Entrega os dados de um cliente autenticado para que o formulário possa ser pulado — veja abaixo.
pluspoint('forget')Descarta esses dados e a conversa naquele navegador — veja abaixo.

setLocation e identify definem a próxima conversa. Uma conversa já aberta naquele navegador mantém a localização e o contato dela; para testar, use uma página em que você ainda não conversou ou uma janela anônima do navegador.

Acompanhar o chat nas suas ferramentas de análise

Registre um manipulador com pluspoint('on', evento, manipulador). Ele recebe um único argumento, por exemplo { type: 'opened' }, então um mesmo manipulador pode atender vários eventos:

<script>
  pluspoint('on', 'firstMessageSent', function (event) {
    gtag('event', 'live_chat_' + event.type);
  });
</script>
EventoQuando dispara
openedA janela do chat abre, pelo botão de chat ou por pluspoint('open').
closedA janela do chat fecha.
firstMessageSentA primeira mensagem do visitante chegou e a conversa já existe na sua caixa de entrada.
conversationResolvedA conversa é resolvida enquanto o visitante ainda está com a página aberta.

Os eventos não carregam dados de contato nem texto de mensagens — só o tipo do evento. pluspoint('off', 'firstMessageSent', manipulador) interrompe um manipulador que você registrou.

Poupar o formulário aos clientes autenticados

Quando o seu site já sabe quem é o visitante, ele pode entregar esses dados ao chat. O visitante então escreve e a conversa começa — sem formulário — desde que todos os dados que o canal exige tenham sido entregues. Quando falta algo, por exemplo se o chat exige um telefone e o seu site só conhece o e-mail, o formulário mostra apenas os campos que faltam. O sexo e a data de nascimento não podem ser entregues, então um chat que os exige pede esses dados. Quando você entrega um ID de cliente, um e-mail ou um telefone, ele só pede na primeira vez em cada navegador. Os dados entregues nunca são mostrados de volta ao visitante, e a caixa de entrada os exibe exatamente como se o visitante os tivesse digitado; não há nenhuma marca de verificação.

  1. Na aba Código do widget, em Clientes autenticados, copie o segredo. Qualquer pessoa que possa editar o canal pode copiá-lo ou substituí-lo. Guarde-o no seu servidor e nunca o coloque na página.

  2. No seu servidor, ao servir uma página a um cliente autenticado, junte os dados do cliente em uma única string — customerId, name, email, phone e timestamp, nessa ordem, separados por quebras de linha, com uma linha vazia para cada dado que você não envia — e assine-a com HMAC-SHA256 usando o segredo, em hexadecimal. O timestamp é a hora atual em segundos unix, e a assinatura vale por 15 minutos, então gere-a ao servir a página, não ao compilar o site nem a partir de um cache.

    const crypto = require('crypto');
    
    function signChatVisitor(customer) {
      const timestamp = Math.floor(Date.now() / 1000);
      const details = {
        customerId: customer.id,
        name: customer.fullName,
        email: customer.email,
        phone: customer.phone,
      };
      const canonical = [details.customerId, details.name, details.email, details.phone, timestamp]
        .map((value) => value ?? '')
        .join('\n');
      const signature = crypto
        .createHmac('sha256', process.env.PLUSPOINT_CHAT_SECRET)
        .update(canonical)
        .digest('hex');
      return { ...details, timestamp, signature };
    }
  3. Coloque o resultado na página e entregue-o:

    <script>
      pluspoint('identify', {
        customerId: '48213',
        name: 'Ana Souza',
        email: 'ana@example.com',
        phone: '+5511999990000',
        timestamp: 1792540800,
        signature: '3b9f2c…'
      });
    </script>
  4. Quando o cliente sair da conta, chame pluspoint('forget'). Ele descarta os dados entregues e a conversa guardada naquele navegador, então a próxima pessoa em um computador compartilhado começa do zero. Chame-o só na saída da conta, não em cada carregamento de página.

Envie as strings exatamente como você as assinou: um nome aparado ou um telefone em outro formato invalida a assinatura. Todos os dados são opcionais, mas pelo menos um precisa estar presente. customerId é o seu próprio identificador estável do cliente, para que todos os chats dele caiam em um único contato. Telefones vão em formato internacional, como +5511999990000.

Para cumprimentar pelo primeiro nome um cliente entregue com name, escreva [name|cliente] na mensagem de boas-vindas da aba Mensagens do canal. Os visitantes sem um nome entregue leem cliente.

Uma conversa já aberta naquele navegador não muda com identify: ela mantém o contato com que começou, e os dados valem para a próxima. Quando identify entrega um cliente diferente do último daquele navegador, a conversa guardada ali é descartada antes, como com forget.

Selecione Substituir segredo quando o segredo pode ter vazado ou quando alguém que o tinha sai da empresa. As assinaturas feitas com o segredo antigo param de valer na hora: as páginas que continuarem assinando com ele voltam a mostrar o formulário até o seu servidor usar o novo.

Limitar os sites em que o seu chat aparece

Na aba Código do widget, em Sites permitidos, informe os domínios em que o widget pode aparecer, até 50. example.com cobre example.com e todos os subdomínios, como www.example.com e shop.example.com; www.example.com cobre só esse host. Com a lista vazia, o widget aparece em qualquer site que carregue o seu trecho, como hoje.

Os seus microsites e o link do chat sempre funcionam, diga a lista o que disser. Em qualquer outro site o widget não mostra nada — nem botão de chat, nem erro — e é isso também que você vê ao testar a partir de um domínio de homologação ou de um arquivo local que não está na lista.

Solução de problemas

SintomaCausaCorreção
O seu botão não faz nada, ou o console do navegador diz pluspoint is not definedO trecho está faltando naquela página, foi copiado antes de a parte window.pluspoint= existir, ou a sua chamada roda em um script colocado antes do trecho.Copie o trecho de novo na aba Código do widget e coloque-o antes de qualquer script que chame pluspoint.
O formulário continua pedindo dados que você entregouA assinatura tem mais de 15 minutos (uma página em cache, ou um relógio do servidor desajustado), foi feita com outro segredo, ou um dado foi enviado sem ser assinado. Uma conversa já aberta naquele navegador também mantém o próprio contato.Gere a assinatura ao servir a página, confira o relógio do servidor, copie o segredo de novo e assine exatamente as strings que envia. Teste em uma janela anônima do navegador; um identify rejeitado é avisado no console do navegador.
O widget está invisível em um dos seus sitesEsse site não está em Sites permitidos.Adicione o domínio dele, ou esvazie a lista para permitir qualquer site.
setLocation ou setLanguage não têm efeito visívelJá existe uma conversa aberta naquele navegador, então a localização é mantida; ou o código de idioma não está na lista acima, o que o console do navegador avisa.Teste em uma janela anônima do navegador e confira o console.
Depois de setLanguage, os botões mudam de idioma, mas a mensagem de boas-vindas nãoA aba Mensagens do canal não tem textos nesse idioma.Adicione o idioma na aba Mensagens.

Artigos relacionados

Agende a sua demo Pluspoint