Saltar para o conteúdo
AurionAI

Adicionar o widget web ao seu site

6 min de leituraPor Emmanuel Yazbeck

O widget web coloca o suporte AurionAI no seu próprio website. Os visitantes abrem-no a partir de um botão num canto da página. Na página Widget pode ativar o widget, escolher os websites que o podem mostrar, alterar o seu aspeto e copiar o código de incorporação.

Disponibilidade: todos os perfis. A voz no widget requer o perfil AI Voice ou o perfil AI Voice + Helpdesk. Apenas administradores.

Pré-requisitos

  • Tem a função Proprietário ou Administrador. Os outros utilizadores veem Acesso Negado.
  • Pode adicionar um script às páginas do seu website, ou pode pedir à sua equipa web que o faça.
  • Conhece o endereço web de cada site que irá mostrar o widget, por exemplo https://portal.northwind.example.

Abrir a página do widget

  1. Na barra lateral, selecione Configuração.
  2. Abra a categoria Integrações.
  3. Selecione Widget.

A página tem os cartões Estado e Segurança, Aparência e Código de Incorporação. Com o perfil Helpdesk ou o perfil AI Voice + Helpdesk, também tem o cartão Definições de Chat.

A página Widget com o cartão Estado e Segurança.

Chat, voz ou ambos

O seu perfil de produto determina o que o widget oferece. O cartão Estado e Segurança mostra-o:

  • AI Voice: Este widget está configurado para modo apenas voz com base no seu plano de Voz IA.
  • Helpdesk: Este widget está configurado para modo apenas chat com base no seu plano de Helpdesk.
  • AI Voice + Helpdesk: Este widget suporta chat e voz com base no seu plano.

A parte de voz utiliza o mesmo agente de IA que a sua linha telefónica. Leia Nome do agente, saudação e comportamento. A parte de chat utiliza a persona de atendimento ao cliente do seu agente e responde com base nos artigos publicados no seu Centro de Ajuda. Para os artigos do Centro de Ajuda, leia Escrever e publicar artigos e Definições da base de conhecimento.

Ativar o widget e definir os sites permitidos

  1. No cartão Estado e Segurança, ative Ativar widget web.
  2. Em Origens permitidas, introduza cada website que pode mostrar o widget. Coloque um site por linha, com https://, o nome do anfitrião e, se necessário, a porta. Não adicione um caminho.
  3. Selecione Guardar Definições do Widget Web.

Como o AurionAI verifica os sites permitidos:

  • O site da página tem de corresponder exatamente a uma entrada: o mesmo http ou https, o mesmo nome de anfitrião e a mesma porta. https://northwind.example e https://www.northwind.example são dois sites diferentes.
  • Os caminhos não contam. Uma entrada abrange todas as páginas de um site.
  • Pode introduzir até 50 sites.
  • Em qualquer outro site, o AurionAI recusa iniciar o widget.
  • O seu Centro de Ajuda AurionAI mostra sempre o widget, no seu endereço aurionai.net e no seu próprio domínio assim que esse domínio for verificado. Não precisa de os adicionar, e não dependem de Ativar widget web. Leia Utilizar o seu próprio domínio.

Para o início de sessão único no widget, leia Início de sessão único para utilizadores finais.

Alterar o aspeto do widget

No cartão Aparência:

  1. Selecione o Posição do lançador: Inferior direito ou Inferior esquerdo.
  2. Selecione um Tema de destaque. Para utilizar as suas próprias cores, ative Usar cores personalizadas e defina o Cor primária e o Cor de destaque.
  3. Em Idioma a editar, selecione um idioma. Em seguida, introduza o Título do widget, o Etiqueta do lançador, o Texto de boas-vindas e o Mensagem do balão do lançador para esse idioma. Repita para cada idioma de que necessitar.
  4. Opcional: em Logótipo da empresa, carregue um ficheiro PNG, SVG ou JPG de 200 KB ou menos.
  5. Opcional: defina Tema do widget, Ações rápidas e Mostrar selo Powered by.
  6. Selecione Guardar Definições do Widget Web.

O widget mostra os textos no idioma do browser do visitante. Quando um idioma não tem texto, utiliza o texto em inglês.

Adicionar o widget ao seu website

  1. No cartão Código de Incorporação, selecione o Idioma do widget. Deteção automática (idioma da página) segue o idioma da página.
  2. Selecione Copiar Snippet.
  3. Cole o código nas páginas do seu website, ou entregue-o à sua equipa web.

O código contém a sua Chave pública do widget. Se selecionar Regenerar Chave, o AurionAI cria imediatamente uma nova chave. Regenerar a chave invalida snippets mais antigos que usam a chave anterior. Copie o novo código para o seu website após regenerar a chave.

Resultado

Num site permitido, o botão do widget aparece no canto que escolheu. Os visitantes podem conversar por chat, falar com o agente de IA, ou ambos, consoante o seu perfil. O widget lê as suas definições sempre que uma página com o widget é carregada, pelo que as alterações guardadas aparecem no próximo carregamento de página.

Se algo correr mal

  • É necessária pelo menos uma origem permitida quando o widget está ativado. Introduza pelo menos um site, ou desative o widget.
  • O guardamento falha com uma mensagem sobre uma origem permitida. Cada linha tem de começar com http:// ou https:// e conter um nome de anfitrião. Remova caminhos, cadeias de consulta e nomes de utilizador.
  • O guardamento falha com uma mensagem que começa com "Widget GA gate checks failed". O AurionAI verifica algumas definições de segurança quando o widget se torna utilizável pela primeira vez num site. Se a mensagem indicar recording_consent, desative a gravação de chamadas ou introduza um texto de consentimento. Leia Gravação de chamadas. Para os outros nomes, contacte o suporte AurionAI. Leia Obter ajuda.
  • O widget não aparece no seu site. Verifique se Ativar widget web está ativo, se o site está em Origens permitidas com o https, nome de anfitrião e porta corretos, e se a página utiliza o código atual. Após Regenerar Chave, o código antigo deixa de funcionar. O widget também para quando a sua conta é suspensa.
  • O logótipo deve ser PNG, SVG ou JPG. Utilize um ficheiro PNG, SVG ou JPG.
  • Falha ao carregar a configuração do widget web. Por favor, atualize e tente novamente. Recarregue a página.
  • Falha ao guardar definições do widget de voz Tente novamente. Se o erro persistir, contacte o suporte AurionAI.

Artigos relacionados

Ainda precisa de ajuda? Envie um pedido ou .