Abrir o widget de chat pelo seu próprio botão

Configurar

1. Acesse Configurações > Caixas de entrada e clique em Configure na sua caixa de entrada de chat ao vivo.
2. Na aba Configurações, procure Balão do chat e ative Esconder balão do chat. A alteração é salva na hora.
3. Mantenha o código do widget no seu site. Ele fica na mesma aba, em Instalação do widget. Veja Incorporando o widget se ele ainda não estiver instalado.
4. Adicione um botão ou link que abra o chat:

<button onclick="window.deskwootWidget.open()">Contact support</button>

Um link funciona do mesmo jeito:

<a href="#" onclick="window.deskwootWidget.open(); return false;">Contact support</a>

O que mais você pode fazer

• window.deskwootWidget.close() fecha o chat e window.deskwootWidget.toggle() abre ou fecha, então um único botão faz as duas coisas.
• window.deskwootWidget.open({ anchor: this }) faz o chat se abrir a partir do seu botão, em vez do canto da página. Um seletor CSS como "#support-button" também funciona como âncora.
• window.__deskwootUnread guarda o número de novas respostas da sua equipe ou do seu bot de IA que chegaram enquanto o chat estava fechado, para você mostrar um contador no seu botão. Abrir o chat volta esse número para 0. Cada mudança também dispara um evento deskwoot:unread em window.
• window.deskwoot é o mesmo objeto que window.deskwootWidget.

A referência completa está na documentação do widget. As cores e os textos do próprio chat estão em Personalizar seu widget de chat.

Perguntas frequentes

Esconder o balão tira o chat do meu site?

Não. Só o balão fica escondido. O chat continua carregando e abre quando o seu código chama open().

E se um visitante clicar antes de o widget carregar?

As chamadas feitas enquanto o widget ainda está iniciando entram numa fila e rodam assim que ele fica pronto. Só um código que roda antes do próprio código do widget precisa de uma verificação como if (window.deskwootWidget).

Quais caixas de entrada têm essa configuração?

As caixas de entrada de chat ao vivo (site). Os outros canais não têm widget, por isso a seção Balão do chat só aparece no chat ao vivo.

Posso mostrar o balão em algumas páginas e o meu botão em outras?

Esconder balão do chat vale para todas as páginas que usam o widget desta caixa de entrada. Se você quer o balão em algumas páginas, deixe Esconder balão do chat desativado e coloque o seu próprio botão onde quiser. O balão e o seu botão abrem o mesmo chat.

Nada acontece quando clico no meu botão. O que devo verificar?

Confira se o código do widget está nessa mesma página e se o botão chama window.deskwootWidget.open() exatamente como está escrito, com os parênteses.

Posso mostrar quantas respostas estão esperando?

Sim. Leia window.__deskwootUnread, ou escute o evento deskwoot:unread em window, e mostre o número no seu botão.