Incorporação no site
Uma linha de script coloca a janela de chat no site, além dos métodos e regras de idioma que podem ser chamados na página.
O {API} abaixo refere-se ao endereço do serviço, que pode ser consultado na página «Integração» do painel.
<script src="{API}/static/aics-widget.js" data-key="pk_xxx" data-api="{API}" async></script>
data-keyé a chave pública; copie-a na página «Integração» do painel.- Registe na página «Integração» os sites autorizados a incorporar o widget (por exemplo,
https://shop.example.com); outros sites que obtenham a sua chave pública não a poderão utilizar. Preencha obrigatoriamente antes de entrar em produção. - Opcional:
data-theme="dark"para utilizar o estilo escuro. - Opcional:
data-language="de"— quando o site é multilingue, passe o idioma da página atual; o atendimento usa esse idioma por predefinição (o visitante pode continuar a alternar). Consulte os códigos de idioma suportados em Visão geral da API aberta. - Opcional:
data-language="auto"— usa o<html lang>da página como idioma predefinido; depois, quando a página muda de idioma (alterando o atributolang, mesmo sem recarregar em aplicações de página única), a janela de atendimento muda automaticamente.
Na página pode chamar:
| Método | Função |
|---|---|
AICS.open() / AICS.close() / AICS.toggle() | Abrir e fechar a janela de atendimento, por exemplo num botão «Contactar o apoio» |
AICS.identify(userToken) | Depois de o cliente iniciar sessão, indicar ao atendimento quem é (ver Identificar clientes com sessão iniciada) |
AICS.setLanguage(code) | Chamar quando o site muda de idioma; a janela de atendimento e as respostas seguintes acompanham, por exemplo AICS.setLanguage("ja"); também aceita formas como zh-Hans, pt-BR |
AICS.reset() | Chamar quando o cliente termina a sessão: desmonta a janela de atendimento e descarta a sessão atual; ao carregar novamente o script obtém uma nova janela anónima, e a pessoa seguinte não vê a conversa anterior |
Idioma
- A janela de atendimento mostra o idioma correspondente à localização do visitante (IP), incluindo o texto da interface e a mensagem de boas-vindas; quando
data-languageestá definido, o idioma da página tem prioridade. Se não for possível determinar a localização, é usado o «idioma predefinido» definido no painel. - A IA responde no idioma usado pelo cliente; quando o conteúdo enviado pelo cliente não revela o idioma (emoji, número de encomenda), é usado o idioma determinado acima.
- O cliente pode alternar no menu de idiomas no topo da janela ou dizer diretamente à IA «Responda em inglês». A partir daí, a IA usa sempre esse idioma, mesmo que o cliente escreva noutro.
- A mudança de idioma do site (
AICS.setLanguageou alteração de<html lang>comdata-language="auto") também conta como escolha do cliente, e prevalece a última das formas acima; o idioma predefinido ao abrir a página não substitui o idioma já escolhido pelo cliente. - Em «Definições do robô → Idioma» no painel pode desativar a deteção por IP, alterar o idioma predefinido e limitar os idiomas disponíveis.
- Quando implementado atrás de um proxy reverso ou CDN, é necessário configurar
TRUSTED_PROXIESouCOUNTRY_HEADERno servidor; caso contrário, não é possível obter o IP real do visitante.
Esta página foi útil?
Última atualização:
