Widget de Chat
2 min de leituraAtualizado em 22 out. de 2026

SDK & API JavaScript

Use a API JavaScript pública do widget para abrir, fechar e informar contexto de sessão.

Abrir no app

Como usar

  1. Instale o widget pelo trecho gerado e aguarde sua inicialização.
  2. Use window.WhatsAppWidget ou a fila window.WhatsAppWidgetQ para os métodos disponíveis.
  3. Confira eventos widget:ready, widget:opened, widget:closed e widget:message ao integrar a interface do site.
javascript
1window.WhatsAppWidgetQ = window.WhatsAppWidgetQ || [];
2window.WhatsAppWidgetQ.push(['open']);
3// Depois de inicializado:
4window.WhatsAppWidget.setUser({ name: 'Pessoa exemplo' });
5window.WhatsAppWidget.setCustomAttributes({ origem: 'site' });
6window.WhatsAppWidget.close();

Diferencie abrir, informar contexto e autenticar

  • Use open, close e toggle para controlar a interface após a inicialização. A fila WhatsAppWidgetQ permite preparar chamadas antes de o SDK ficar pronto.
  • setUser e setCustomAttributes informam contexto. Para área autenticada, getIdentityContext obtém o contexto de identificação e identify recebe a prova válida preparada pelo sistema do site; não assine no navegador com a chave da empresa.
  • logout encerra o acesso identificado; reset muda o contexto da sessão. setDraftMessage prepara texto no compositor e não envia mensagem automaticamente.

Como conferir o resultado

  • O método atua na sessão certa e os eventos permitem acompanhar o resultado.

Limites e cuidados

  • setUser informa contexto; não autentica a pessoa. reset encerra o contexto da sessão e deve ser usado com cuidado em troca de usuário.
  • Não passe segredos nos atributos e não invoque métodos antes do carregamento sem usar a fila.

Se algo não funcionar

identify pede para abrir o atendimento
Abra e inicialize a sessão antes da identificação. Confira prova e contexto válidos e mantenha segredos apenas no sistema responsável do site.

Continuar no aplicativo

Este artigo resolveu sua dúvida?

Sua avaliação ajuda a priorizar revisões de conteúdo.