> 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/canal-evolution-api-nao-oficial.md). # Canal Evolution API (Não Oficial) ## Canal Evolution API (Não Oficial) {% hint style="danger" %} **Atenção: Risco de Banimento**\ O uso de conexões baseadas em APIs não oficiais (como Baileys, WebJs, Evolution, entre outras) acarreta risco de banimento do número pelo WhatsApp, uma vez que estas bibliotecas emulam o comportamento do WhatsApp Web e não fazem parte da infraestrutura oficial da Meta. A utilização destas ferramentas é de inteira responsabilidade do usuário. Para operações de larga escala ou que exijam segurança máxima contra bloqueios, recomenda-se a utilização da **API Oficial (WABA)**. {% endhint %} A **Evolution API** é uma solução de integração não oficial de alto desempenho, que atua como um gateway entre o WhatsApp e o sistema Norux. Diferente das bibliotecas simples, ela oferece uma camada extra de gerenciamento e robustez para as instâncias de WhatsApp conectadas via QR Code, permitindo uma operação mais estável em cenários de grande volume de mensagens A Evolution API permite que o sistema gerencie as sessões de forma desacoplada. Isso significa que, mesmo que a interface do Norux sofra uma atualização, as instâncias no servidor da API permanecem conectadas, reduzindo a necessidade de novos pareamentos frequentes. ### Passo a passo para conexão #### **1. Instalar Evoluiton API** Antes de qualquer configuração no painel Norux, a Evolution API deve estar devidamente instalada e rodando em seu servidor. * Siga as instruções técnicas contidas na página: Instalação: Evolution API #### **2. Configuração no Painel Administrativo** 1. Acesse o menu **Configurações > Integrações > Evolution API**. 2. Insira a **URL da API** (Ex: ). 3. Cole a sua **Global Key**. 4. Clique no botão **Verificar Status da API**. Certifique-se de que o sistema retorne uma confirmação de sucesso. As alterações são salvas automaticamente. {% hint style="warning" %} **Atenção:** Não inclua a barra (/) no final da URL da API. Uma URL incorreta (ex: .../ em vez de ...) causará falha na conexão. {% endhint %} **Observações Importantes:** * **Conectando uma Instância Existente:** Se você já possui uma instância criada na Evolution, basta criar um novo canal no Norux com o **mesmo nome exato** da instância. O sistema irá sincronizar e configurar o webhook. * **Nomenclatura:** Não utilize caracteres especiais (como \_) no nome da instância, pois isso pode causar falhas na sincronização. * **Nome da Instância:** Uma vez criado, o nome da instância não pode ser alterado. #### **3. Adicionar um canal** **Passo passo geral aqui:** Como conectar um canal (sessão/número) #### **4. Gerar o QR Code** Após salvar as configurações iniciais do canal, localize o card do canal e clique no botão **Novo QR Code**. Um modal será aberto exibindo o código.
#### **5. Escanear no Aparelho** 1. Abra o WhatsApp no seu celular. 2. Vá em **Configurações** (ou Ajustes) > **Dispositivos Conectados**. 3. Clique em **Conectar um dispositivo**. 4. Aponte a câmera do celular para o QR Code exibido na tela do Norux. #### **6. Confirmar a Conexão** Aguarde alguns segundos enquanto o sistema sincroniza os dados. O modal fechará automaticamente e o status no card do canal mudará para **CONNECTED**. O QR Code possui um tempo de expiração de segurança (geralmente 60 segundos). Caso o tempo esvazie antes do escaneamento, clique em **Novo QR Code** dentro do modal para gerar uma nova imagem. {% hint style="warning" %} **Estabilidade:** Certifique-se de que o aparelho celular utilizado para a conexão possua uma conexão de internet estável e bateria carregada. Quedas de internet no celular podem causar desconexões intermitentes no painel. {% 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/canal-evolution-api-nao-oficial.md?ask=&goal= ``` `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.