Mensagens proativas: tooltips, mensagens programadas e campanhas

Um evento na sua página dispara um aviso, como um clique, a rolagem ou uma pausa. Depois de uma espera, aparece uma pequena bolha no botão do chat ou uma mensagem na conversa. Na conta, isso se chama Tooltips e ações programadas: /app/projects/{id}, aba Regras e atendimento.

Duas formas de exibição

• Bolha de tooltip no botão do chat – discreta. Fica ao lado do botão, desaparece sozinha ou pelo botão de fechar e não abre a janela. Não tira o foco do teclado do visitante, de modo que quem estiver preenchendo um formulário não seja interrompido. Nos celulares, fica acima do botão do chat.
• Mensagem no chat – aparece como uma mensagem na conversa. Com Abrir também a janela do chat, a janela se abre.

Se alguém estiver com dificuldade, é melhor não abrir uma janela na frente dessa pessoa. Na dúvida, use a bolha.

Criar tooltips no assistente

A lista mostra todos os avisos como cards, com uma opção ativo, Editar, Duplicar, Excluir e botões para mover. Restaurar padrões restaura as regras fornecidas. Você cria novos tooltips em cinco etapas, com uma prévia em uma página clara e outra escura.

1. Gatilho

• Página aberta – quando uma página é aberta.
• Tempo na página – após um tempo mínimo na página. O widget verifica a cada 30 segundos.
• Profundidade de rolagem – a partir de uma porcentagem da página, de 1 a 100.
• Inatividade – sem mouse, teclado, toque ou rolagem por 3 segundos a 60 minutos.
• Volta à aba – o visitante retorna à aba depois de se ausentar.
• Intenção de saída – o ponteiro do mouse sai pela parte superior da janela. Somente em computadores.
• Clique em um elemento – seletor CSS obrigatório.
• O mouse permanece – sobre um elemento, de 0,2 a 60 segundos (padrão: 1 segundo). Seletor obrigatório.
• Elemento fica visível – um elemento entra na área visível durante a rolagem. Seletor obrigatório.
• Campo de formulário acessado – foco em um campo. Seletor obrigatório.
• Texto copiado – opcionalmente limitado a um elemento.
• Evento personalizado – do seu código; veja abaixo.
• Sinais de frustração – por exemplo, um erro de JavaScript na página (js_error). Outros sinais, como cliques repetidos no mesmo ponto ou formulários abandonados, só são fornecidos pela conexão com o MousePlayer.
• Intenção de compra – detectada somente com o MousePlayer.

2. Condições

• Endereço contém e Endereço não contém – parte do endereço ou uma expressão regular no formato /pattern/i.
• Vem de – a página anterior (referrer), com a mesma notação.
• Dispositivo – celular ou computador.
• Visitantes – novos ou recorrentes. O widget só reconhece um visitante recorrente se puder armazenar algo no navegador, ou seja, com consentimento.
• Idioma da página – até 20 códigos de idioma.
• Páginas nesta sessão – mínimo de 1 a 100.
• Equipe – somente quando alguém estiver online ou somente quando ninguém estiver online.
• Horário de atendimento – somente dentro ou somente fora da sua disponibilidade.
• Não durante uma conversa em andamento – padrão. Uma conversa conta como em andamento se a janela estiver aberta ou se a última mensagem tiver menos de 10 minutos.

3. Tempo

• Espera em segundos após o gatilho. Se, durante esse tempo, o visitante for para uma página à qual o tooltip não se aplica, ele será descartado.
• Tempo de exibição da bolha: até o visitante fechá-la ou de 3 a 120 segundos. Sem valor, 15 segundos.
• Frequência – uma vez por sessão, por visitante, por conversa ou no máximo uma vez a cada 10 minutos, 1 hora ou 24 horas. “Várias vezes por sessão” permite de 2 a 10.
• Importância – alta, média, baixa ou um número definido por você. Se dois tooltips se aplicarem ao mesmo tempo, o mais importante prevalece.

4. Conteúdo

• Texto – no máximo 500 caracteres.
• Respostas rápidas – botões abaixo do texto, com no máximo 32 caracteres cada: até 3 na bolha e até 4 na mensagem. Cada resposta tem um efeito:
• Fazer uma pergunta – abre o chat, mostra sua frase e a resposta do visitante e pergunta qual é o assunto.
• Não, obrigado – fecha a bolha. Esse tooltip não volta na sessão.
• Pedir retorno de ligação – abre a solicitação de retorno de ligação.
• Mensagem (padrão) – envia a resposta como mensagem no chat.
• Foto do atendente – mostra na bolha o avatar da pessoa da equipe atribuída.
• A IA escreve um por página – em vez de uma frase fixa, a IA escreve uma frase adequada para cada página com base no conteúdo. Seu texto continua como fallback.

Sugestões e frases próprias por página

Com A IA escreve um por página, você pode criar sugestões para as 20 páginas mais visitadas, no máximo uma vez por minuto. Elas são escritas em segundo plano, normalmente em até um minuto. Você pode substituir cada sugestão por seu próprio texto (no máximo 500 caracteres). Ele vale para essa página até que você o descarte; a IA nunca o sobrescreve. Uma sugestão descartada é reescrita na próxima visita à página.

O que sempre se aplica

Para que os avisos não incomodem, há regras fixas que você não pode desativar:

• No máximo um aviso a cada 10 minutos por visitante. Tooltips de clique, mouse parado e campo de formulário são exceções: respondem a algo que o visitante fez.
• Nenhuma bolha enquanto a janela do chat estiver aberta ou o botão do chat estiver oculto.
• No máximo 3 bolhas por sessão.
• Dispensado é dispensado: o mesmo tooltip não volta nessa sessão.
• Não perturbe: se sua página tiver definido o visitante como “não perturbe” (veja abaixo), nenhum aviso aparece.

Plano

No plano gratuito, é possível ter 1 tooltip ativo por projeto; a partir do Professional, quantos você quiser. Bolhas e mensagens ativas são contadas na ordem da lista. Quem tentar salvar além do limite recebe um aviso. Se um espaço de trabalho voltar ao plano gratuito, os tooltips excedentes permanecem salvos, mas não são entregues.

Para usuários avançados: regras em JSON

Abaixo do assistente, você encontra Especialistas: regras em JSON. É a mesma lista em JSON, que pode ser editada diretamente. Vazio significa usar os padrões do reactive.chat. A verificação ao salvar é rigorosa. Um erro informa a regra e o campo.

[
  {
    "id": "preise-hilfe",
    "enabled": true,
    "priority": 50,
    "when": { "event": "scroll", "minScrollPct": 60, "urlMatch": "/preise" },
    "unless": { "conversationActive": true },
    "throttle": { "max": 1, "per": "session" },
    "delayMs": 2000,
    "action": {
      "type": "teaser",
      "text": "Questions about our plans? Happy to help.",
      "quickReplies": ["Yes, I have a question", "No thanks"],
      "replyRoles": ["ask", "dismiss"],
      "ttlMs": 20000
    }
  }
]

Os limites mais importantes:

• no máximo 50 regras, 60.000 caracteres no total,
• id: letras minúsculas, dígitos e hífens, no máximo 40 caracteres,
• priority: de 0 a 1000, o menor número prevalece, padrão 100,
• delayMs: de 0 a 86.400.000 (24 horas),
• ttlMs (somente bolha): de 0 a 120.000; 0 significa até fechar,
• throttle.max: de 1 a 100; throttle.per: session, visitor, conversation, 10m, 1h, 24h,
• action.type: teaser (bolha) ou proactive_message (mensagem, com openWidget),
• padrões e seletores com no máximo 200 caracteres,
• campos que começam com _ contam como comentários.

Campos desconhecidos são rejeitados, para que erros de digitação sejam percebidos ao salvar.

Por código: mostrar uma bolha

Pelo seu próprio código, você mostra uma bolha no botão do chat, por exemplo, após uma ação na sua página:

ReactiveChat('show', 'Questions about your plan? Write to us.');

ReactiveChat('showTeaser', {
  text: 'Questions about your plan?',
  quickReplies: ['Yes', 'No thanks'],
  ttlMs: 15000,
  ruleId: 'tarif-kampagne'
});

ReactiveChat('hide');

Essas bolhas também seguem as regras acima. showTeaser retorna se a bolha foi exibida. O widget informa os eventos teaser:shown, teaser:click, teaser:dismiss e teaser:reply por meio de ReactiveChat('on', …).

Por código: eventos personalizados como gatilhos

Para o gatilho Evento personalizado, você informa um marco da sua página:

ReactiveChat('track', 'warenkorb_voll');

No tooltip, informe o mesmo nome.

Não perturbe

Se um visitante não deve ser abordado de forma alguma, por exemplo, durante o checkout, adicione isto ao código de incorporação:

data-rc-dnd="true"

O chat continua acessível; apenas os avisos proativos são descartados.

Campanhas

Para promoções direcionadas, há Campanhas em /app/projects/{id}/campaigns: uma mensagem no chat para um público definido com precisão, com uma variante B se você quiser. As campanhas estão disponíveis a partir do plano Professional.

• Mensagem com no máximo 500 caracteres, até 3 botões de resposta, opcionalmente com abertura da janela.
• Variante B com uma proporção de 1 a 99 %, padrão 50 %.
• Público por páginas, tempo na página, origem, parâmetros UTM, visitantes novos ou recorrentes, país, idioma, dispositivo, visitantes conectados ou anônimos e, com dados de clientes, por exemplo, pelo status de um pedido.
• Frequência por visitante de 1 a 50 (padrão 1) e intervalo mínimo de 1 a 2160 horas (padrão 24).
• Agendamento com início e fim.
• Desempenho: entregue, visto, clicado, conversa iniciada, meta alcançada.

As campanhas compartilham o limite de 10 minutos com os tooltips e nunca aparecem durante uma conversa em andamento. Visitantes da UE, do EEE, da Suíça e do Reino Unido, além daqueles cujo país é desconhecido, só são alcançados com consentimento. Como planejar e avaliar campanhas está descrito no manual do produto.

Se um aviso não aparecer

• Ele está ativo e é permitido no seu plano?
• Já houve um aviso nos últimos 10 minutos?
• Há uma conversa em andamento ou a janela está aberta?
• O visitante já o dispensou ou a frequência foi atingida?
• As condições correspondem, como endereço, dispositivo ou horário de atendimento?
• O botão do chat está oculto? Nesse caso, não há bolha. Use uma mensagem no chat.
• Gatilho de frustração ou intenção de compra? Exceto pelos erros de JavaScript, esses sinais só vêm com o MousePlayer.