> For the complete documentation index, see [llms.txt](https://ajuda.norux.chat/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.norux.chat/admin/configuracao-e-administracao/habilitar-webchat.md).

# Habilitar Webchat

## Habilitar Webchat

{% hint style="info" %}
**Disponível para o perfil:** Administrador
{% endhint %}

Configure o widget de Webchat para incorporar um chat ao vivo diretamente no seu site. As mensagens dos visitantes chegam em tempo real na plataforma Norux como atendimentos normais.

{% hint style="warning" %}
**Pré-requisito:** É necessário ter um canal do tipo Webchat instalado e conectado antes de gerar o widget. Veja: Como conectar um canal Webchat.
{% endhint %}

***

#### Como acessar a página

No painel administrativo, acesse **Configurações > Integrações > Webchat**.

***

#### Você verá a seguinte tela

***

#### Detalhamento da página

**Status do Webchat**

No topo da tela, um painel de status indica se o serviço está operacional:

| Indicador                                                  | Significado                                            |
| ---------------------------------------------------------- | ------------------------------------------------------ |
| **Webchat configurado e funcionando corretamente** (verde) | O serviço está ativo e pronto para uso                 |
| **WebSocket (porta principal): Ativo**                     | Conexão via porta unificada do backend funcionando     |
| **WebSocket (porta separada - legado): Ativo**             | Compatibilidade com widgets antigos (WSS\_URL) mantida |

{% hint style="info" %}
**Aviso de migração:** O WebSocket do Webchat agora funciona na mesma porta do backend, eliminando a necessidade de `WSS_PORT` e `WSS_URL` separados. Novos widgets já utilizam essa configuração automaticamente. Widgets antigos e novos funcionam simultaneamente — você pode remover `WSS_PORT` e `WSS_URL` do `.env` quando todos os widgets forem regenerados.
{% endhint %}

***

**Campos da página**

| Campo / Opção                        | Descrição                                                                                                                       |
| ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------- |
| **Token de Autenticação**            | Chave de segurança que valida as requisições do widget. Exibida apenas uma vez após a geração.                                  |
| **Ícone de renovar (↺)**             | Gera um novo token, invalidando o anterior. Widgets já instalados pararão de funcionar até serem atualizados com o novo código. |
| **Canal Webchat**                    | Selecione a sessão do tipo Webchat que receberá os atendimentos oriundos do site.                                               |
| **Habilitar botões de menu (#MENU)** | Opcional. Quando ativo, mensagens com o formato `#MENU` são renderizadas como botões clicáveis no widget.                       |
| **Gerar Widget**                     | Gera o código JavaScript de incorporação com base no canal e token selecionados.                                                |

***

#### Como gerar o widget

1. Verifique se o painel de status exibe a mensagem em verde confirmando que o serviço está ativo.
2. Em **Canal Webchat**, selecione a sessão Webchat configurada.
3. Se quiser habilitar menus clicáveis, marque a opção **Habilitar botões de menu (#MENU)**.
4. Clique em **Gerar Widget**.
5. Copie o código JavaScript gerado e cole no HTML do seu site, **antes do fechamento da tag `</body>`**.

{% hint style="info" %}
O widget aparecerá automaticamente no canto da página após a inserção do código. Teste enviando uma mensagem — ela deve chegar na plataforma Norux como um novo atendimento.
{% endhint %}

***

#### Gerenciando o token de autenticação

O token garante que apenas o seu site possa enviar mensagens via widget.

* **Não compartilhe o token** — ele autentica toda a comunicação entre o widget e o Norux.
* **Renove o token** clicando no ícone ↺ caso ele seja comprometido ou exposto.

{% hint style="danger" %}
**Atenção:** ao regenerar o token, todos os widgets já instalados nos sites pararão de funcionar imediatamente. Será necessário substituir o código gerado em cada site onde o widget está ativo.
{% endhint %}

***


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ajuda.norux.chat/admin/configuracao-e-administracao/habilitar-webchat.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.