Iniciar um chat

Siga estas etapas para iniciar um bate-papo:

1. Ouça o evento lcw:ready gerado por um chat ao vivo para começar a usar os métodos do SDK do chat ao vivo. Os métodos de chat ao vivo devem ser invocados depois que o evento lcw:ready for gerado. Você pode escutar esse evento adicionando seu próprio ouvinte de eventos no objeto window.

2. Depois que o evento lcw:ready for gerado, chame o método startChat para iniciar um chat.

   Para autenticar um cliente ao iniciar um chat, consulte Enviar token de autenticação.

   Para iniciar um chat proativamente, dependendo de vários cenários de clientes em sua organização, consulte Iniciar um chat proativamente.

Código de exemplo

window.addEventListener("lcw:ready", function handleLivechatReadyEvent(){
	// Handle LiveChat SDK ready event
	// SDK methods are ready for use now
	// Initiate a chat using startChat SDK
	Microsoft.Omnichannel.LiveChatWidget.SDK.startChat();
});

window.addEventListener("lcw:error", function handleLivechatErrorEvent(errorEvent){
	// Handle LiveChat error event
	console.log(errorEvent);
});

Considere um cenário em que o cliente está na página do portal e você deseja iniciar um chat depois que o cliente tiver passado algum tempo na página. Você pode abrir programaticamente o widget de chat após o tempo especificado ter decorrido.

O código de exemplo a seguir mostra como você pode iniciar um chat depois que o cliente estiver esperando por 5 minutos:

window.addEventListener("lcw:ready", function handleLivechatReadyEvent(){
    // Open chat widget proactively after customer has been waiting for 5 minutes
    setTimeout(function startProactiveChat() {
        Microsoft.Omnichannel.LiveChatWidget.SDK.startChat();
    }, 300000);
});

Usar botão de bate-papo personalizado

Para usar um botão de chat personalizado em vez do botão de chat pronto para uso, adicione o atributo data-hide-chat-button no snippet do widget e defina seu valor como true. Invoque o método startChat ao clicar no componente de interface do usuário personalizado para iniciar o chat.

Exemplo de trecho de código para ocultar o botão de bate-papo padrão

<script id="Microsoft_Omnichannel_LCWidget" src="<valid-src>" data-app-id="<valid-app-id>" data-org-id="<valid-org-id>" data-org-url="<valid-org-url>" data-hide-chat-button="true"></script>

Informações relacionadas

startChat
Referência da API JavaScript para SDK de bate-papo ao vivo
Personalizar widget de chat
Inicie um bate-papo de forma proativa