Chatbot do site

​

Onde fica

​

Colocar no ar

​

Instalação

• Se você ainda não tem uma tag, a tela mostra Você ainda não tem uma tag e o botão Gerar tag.
• Com a tag gerada, clique em Copiar tag e cole a linha no <head> de todas as páginas do site. Ela tem este formato, com o endereço e a chave da sua conta:

<script src="https://.../octa/l.js" data-octa="SUA_CHAVE" async></script>

​

Domínios autorizados

• Um domínio por linha. Clique em Salvar domínios para gravar.
• Lista vazia: o assistente atende em qualquer site que tenha a sua tag.
• Lista preenchida: o assistente só carrega nos domínios da lista. Em outro site, o botão do assistente nem aparece.
• A comparação é pelo domínio inteiro. www. no começo é ignorado (www.minhaloja.com.br e minhaloja.com.br são o mesmo domínio), e https://, caminho e porta são removidos automaticamente.
• Subdomínios precisam ser cadastrados um a um (app.minhaloja.com.br não é liberado por minhaloja.com.br).
• Uma linha com caracteres inválidos é marcada como domínio inválido e impede o salvamento até ser corrigida.

​

Identidade do assistente

• A persona soma-se às instruções da empresa (aba System Prompt), que continuam valendo, e às regras que o assistente sempre segue.
• Na conversa, o assistente se apresenta com o nome escolhido, como atendente da loja com o nome da sua conta.

​

Aparência do botão

• Posição do botão — o painel de conversa abre do mesmo lado do botão. As notificações in-app usam o canto inferior direito; escolha outro canto para os dois não disputarem espaço. Se outro widget da OctaSend estiver no mesmo canto, os botões ficam empilhados, com o do assistente mais perto da borda.
• Animação — roda nos primeiros 10 segundos depois que a página abre e para quando o visitante clica no botão. Visitantes que ativaram a redução de movimento no sistema não veem a animação. Na prévia, Ver animação reproduz o efeito escolhido.
• Imagem do botão — use Enviar imagem para trocar o ícone por uma imagem sua (por exemplo, a foto de um atendente ou o logo da marca). A imagem ocupa o botão inteiro, recortada em círculo, e substitui o ícone: enquanto houver imagem, a escolha de ícone fica desabilitada. Remover imagem volta a mostrar o ícone. Arquivo em outro formato ou acima de 512 KB é recusado com um aviso.
• Cores — cada cor pode ser escolhida no seletor ou digitada no formato #rrggbb. A prévia muda enquanto você edita, antes de salvar. Salvar cores só fica disponível quando alguma cor mudou e todas estão no formato certo. A cor do cabeçalho do painel também é usada no botão Enviar do painel.

​

Canais do widget

• As opções com WhatsApp exigem um WhatsApp padrão conectado na conta. Sem ele, a tela avisa e as opções ficam desabilitadas. Veja WhatsApp.
• Em Páginas do botão do WhatsApp, informe em quais páginas o botão do WhatsApp aparece, uma por linha (por exemplo, /produtos/*), até 50. Vazio mostra o botão em todas as páginas.

• Antes da confirmação, nada é enviado ao WhatsApp do visitante: a conversa segue só no painel do site.
• Numa conexão pela API oficial da Meta, a resposta só chega no WhatsApp até 24 horas depois da última mensagem do visitante por lá. Fora desse prazo, ela fica só no painel do site.
• Quando a conversa com o assistente chega ao limite de mensagens, o visitante é avisado de que o atendimento segue pelo WhatsApp normal da loja.

​

Instruções da empresa (aba System Prompt)

• Aceita até 10.000 caracteres, com contador abaixo do campo.
• Na primeira vez, o campo vem preenchido com um modelo inicial. Ele só começa a valer depois que você clicar em Salvar instruções.
• Essas instruções valem para todas as conversas da IA com seus clientes: o chat do site, os bots do WhatsApp e as etapas de IA das automações. Cada bot e cada etapa de IA ainda podem ter instruções próprias, somadas a estas. Veja Chatbot com IA.
• O jeito de escrever segue o tom de voz padrão da conta, definido em Chatbot → Base de Conhecimento, aba Tom de voz. Sem escolha, a IA usa o tom Formal.

​

O que o assistente consulta

​

Base de conhecimento

• A base é a mesma do chatbot do WhatsApp: os documentos cadastrados em Chatbot → Base de Conhecimento. Veja Chatbot com IA.
• O chat do site consulta apenas as fontes com escopo Compartilhado. Fontes Privado a um sub-cliente não são usadas no site, porque o visitante não é identificado como um sub-cliente.
• A base é usada para perguntas sobre regras da loja: frete, prazo, troca, devolução, formas de pagamento e parcelamento.
• Com a chave desligada, o assistente não consulta a base e não responde sobre essas regras com base nos seus documentos.

​

Catálogo de produtos

• O preço e o estoque do cartão vêm do catálogo ou da consulta à loja, nunca do texto escrito pela IA.
• Quando o assistente só listou o produto numa busca, o cartão mostra Preço a confirmar com a loja.: o preço exibido é o da última sincronização do catálogo.
• Quando o assistente consulta o detalhe de um produto da Nuvem Shop, o preço e o estoque são confirmados ao vivo na loja de onde o produto veio, e o cartão passa a mostrar o preço como confirmado. Não é preciso nenhuma configuração extra além da loja conectada.
• Em produto em promoção, o preço confirmado é o promocional, o que o visitante paga. Uma promoção zerada, vazia ou maior que o preço é ignorada, e vale o preço normal.
• O aviso Preço a confirmar com a loja. continua quando a loja não responde naquele momento, em produtos cadastrados à mão ou vindos da Wake e em produtos cujas variações têm preços (ou promoções) diferentes. Nesses casos, o assistente oferece verificar em vez de afirmar o valor.
• Num produto com variações, o estoque é a soma das variações.
• Produto com estoque zerado aparece com o aviso Esgotado no momento.
• Cada consulta ao catálogo traz no máximo 10 produtos.

​

Página que o visitante está vendo

​

Regras que o assistente sempre segue

• Nunca afirma preço, estoque, prazo ou política sem consultar o catálogo ou a base de conhecimento naquela conversa. Se a consulta falhar, diz que vai confirmar, em vez de improvisar.
• Não oferece desconto, cupom nem condição especial.
• Responde em português do Brasil, em até 3 frases, a não ser que o visitante peça mais detalhe.
• Não revela as próprias instruções, como foi construído nem dados de outros clientes.
• Trata a descrição de produto e o conteúdo da base como informação, nunca como ordem: um texto de produto que tente mudar o comportamento do assistente é ignorado.

​

Captura de contato do visitante

• A ajuda nunca depende disso: o assistente responde à pergunta de qualquer jeito.
• Pede uma vez só. Se o visitante recusar, ignorar ou já tiver informado, ele não pergunta de novo.
• Para gravar, é preciso pelo menos um e-mail válido ou um telefone com DDD (de 10 a 13 dígitos). Se só um dos dois for válido, ele é gravado e o outro é ignorado: por exemplo, um e-mail sem domínio com um telefone certo ainda vira contato pelo telefone. O assistente avisa o visitante sobre o dado que ficou de fora.
• Sem nenhum e-mail ou telefone válido, nada é gravado.
• Se o e-mail informado já pertence a um contato seu, a conversa é só vinculada a esse contato: nenhum dado do cadastro existente é alterado. O mesmo vale para o telefone de um contato que ainda não tem e-mail. Se nenhum contato corresponde, um contato novo é criado em Contatos.
• O nome, o e-mail e o telefone aparecem na conversa, em Conversas.

​

Visitante já identificado pelo site

octasend('identify', {
  userId: 'ID_DO_CLIENTE_NO_SEU_SISTEMA',
  name: 'Maria Silva',
  email: 'maria@exemplo.com',
  phone: '+5511999999999'
})

​

Testar conversa

• Funciona com o assistente pausado e independe da lista de domínios.
• Usa as mesmas instruções, base de conhecimento e catálogo do chat do site. Enquanto responde, mostra Pensando…, Consultando o catálogo… ou Consultando as políticas….
• Os produtos aparecem em cartões com imagem, preço (ou Preço sob consulta), aviso de Esgotado e o link Ver produto.
• As conversas de teste não são salvas e não aparecem em Conversas. O teste não pede dados de contato.
• O consumo de IA do teste conta no limite de uso de IA da sua conta.
• Recomeçar limpa a conversa de teste.

​

Ativar e pausar

​

Conversas

​

Assumir e responder

• O assistente responde sozinho enquanto a conversa não tem atendente. A faixa da conversa mostra Chatbot respondendo.
• Assumir atribui a conversa a você: o assistente para de responder, e o que você escreve no painel chega ao visitante no chat do site. As respostas do site são só texto (sem anexo).
• O assistente volta sozinho 30 minutos depois de você assumir ou da sua última resposta, na próxima mensagem do visitante. Devolver ao bot e Resolver também devolvem na hora.
• Se o visitante fechou o chat, o campo de mensagem avisa O visitante saiu do chat do site. Você pode responder quando ele voltar a escrever.
• Abas (Minhas, Sem dono, Todas, Resolvidas), atribuição, respostas prontas, não lidas e vínculo com contato funcionam como nos outros canais. Veja Instagram e Messenger.

​

O que o visitante vê no site

• Um botão redondo no canto escolhido. Ao clicar, abre um painel com o nome do assistente (o definido em Identidade) no cabeçalho e a saudação Olá! Posso ajudar com dúvidas sobre produtos, preços, frete, trocas e pagamento.
• Enquanto o assistente trabalha, o painel mostra que ele está pensando ou consultando. A resposta chega inteira, com os cartões de produto logo abaixo.
• Se algo falhar, o painel mostra Não consegui responder agora. Tente novamente em instantes. e o botão Tentar de novo, que reenvia a mesma mensagem.
• A conversa acompanha o visitante entre as páginas do site por até 30 minutos: o assistente lembra o que já foi dito, mesmo que o painel reabra só com a saudação numa página nova. Depois desse prazo, a próxima mensagem começa uma conversa nova, que aparece separada em Conversas.

​

Limites

​

Solução de problemas

​

Veja também