Keyda API do Widget
Para desenvolvedores, ou qualquer pessoa que queira que o chat abra a partir do seu próprio botão.
Instalando
<script src="https://keyda.in/business/widget.js"
data-key="kb_live_your_key_here" async></script>A tag de script precisa apenas de src e data-key. Todo o resto — cores, posição, saudação, idiomas — vem do seu painel para que você nunca precise reimplantar o seu site para alterá-los.
Modos
Flutuante (padrão). Um botão de atalho no canto, que abre um painel de chat.
Embutido. Coloque um contêiner vazio na página e o chat o preenche:
<div data-keyda-bot style="height:520px"></div>O contêiner precisa de uma altura. No modo embutido, o chat fica sempre visível, então não há nada para abrir ou fechar.
API JavaScript
Disponível em window.KeydaBot assim que o script for carregado:
| Ligar | O que ele faz |
|---|---|
KeydaBot.open() | Abre o painel de chat |
KeydaBot.close() | Fecha |
KeydaBot.toggle() | Abre ou fecha |
KeydaBot.expand() | Deixa o painel com a altura da janela e até 760px de largura |
KeydaBot.shrink() | Voltar para o cartão padrão |
KeydaBot.isOpen | true quando o chat estiver visível |
KeydaBot.isExpanded | true enquanto o painel estiver expandido |
KeydaBot.clientId | O client id que esta página está usando |
Exemplo — abra o chat a partir do seu próprio botão "Fale conosco":
<button onclick="KeydaBot.open()">Chat with us</button>O script é carregado de forma assíncrona, portanto
window.KeydaBot pode não existir por um instante logo após o carregamento da página. Associe os manipuladores a um evento de clique em vez de chamá-lo enquanto a página está sendo processada.Como ele se comporta na sua página
- O painel abre acima do botão do disparador, que permanece onde está e se torna o controle de fechar. Tocar nele novamente, no ✕ no cabeçalho ou pressionar Esc fecha o chat.
- Um visitante pode expandir o painel a partir do cabeçalho — ele ocupa a altura da janela e até 760px de largura —, e a escolha é lembrada no navegador dele. Em celulares, o painel já ocupa a tela inteira, portanto esse controle não é exibido lá.
- Sua configuração de tamanho do logo altera o logo, e não o botão: o disparador é uma pílula fixa de 52px (58px para as formas redonda e quadrada) e o logo cresce dentro dele.
- Tudo é renderizado dentro de um shadow root, para que o seu CSS não quebre o widget e o CSS do widget não afete o seu site.
- O painel carrega apenas quando um visitante o abre, portanto ele não deixa sua página mais lenta.
- A conversa de um visitante continua por 24 horas caso ele retorne, depois recomeça do zero.
- Se o assistente estiver inacessível, o widget exibe uma mensagem curta e nunca gera um erro na sua página.