# 28/04/2026 - Evolution API (Versão BETA)

Liberamos para testes a integração com a **Evolution API**, uma nova alternativa para a conexão de canais de WhatsApp não oficiais na plataforma.

**⚠️ Pré-requisito**

Para que a opção de conexão via Evolution API apareça na sua conta, é necessário que a opção **"Canal não oficial"** esteja marcada no cadastro da conta em **Admin → Contas**.

**Como conectar**

Acesse **Ajustes → Contas → Canais de atendimento**, clique no botão **"+"** e selecione **WhatsApp QRCode → EvolutionAPI (Servidor próprio)**. A partir daí, basta seguir o fluxo de configuração informando os dados do seu servidor.

Por estar em fase **BETA**, essa integração já oferece recursos e paridade com o que você já conhece, mas possui algumas restrições técnicas iniciais. Confira abaixo todos os detalhes:

**✨ Principais Vantagens e Recursos**

* 🔄 **Migração Transparente:** É possível migrar os seus canais da Z-API para a Evolution (e vice-versa) mantendo todo o seu histórico de conversas seguro.
  * **Como fazer:** Basta remover o canal antigo e conectar o novo utilizando o mesmo número de telefone. O sistema reconhecerá o número e preservará todos os seus atendimentos.
* 👥 **Suporte a Grupos (V1):** A nova integração já conta com suporte para recebimento e envio de mensagens em grupos do WhatsApp.
* 👀 **Reações e Edições (Recebimento):** A plataforma já recebe e reflete no painel de atendimento as reações (emojis) e as edições de mensagens feitas pelo contato no WhatsApp dele.
* ⚙️ **Paridade Operacional:** Com exceção das limitações descritas abaixo, todo o comportamento do canal (regras de janelas de 24h, Modelos de Mensagem e Chatbot) segue o mesmo padrão de qualidade e funcionamento da Z-API.

**⚠️ Limitações Conhecidas (Fase BETA)** Devido a restrições técnicas atuais da própria Evolution API, os seguintes recursos não estão disponíveis para os canais conectados por ela:

* 🚫 **Sem Botões ou Listas Interativas:** O envio de mensagens interativas (com botões e menus de lista) não é suportado.
  * **Ação preventiva:** Para evitar erros de envio, a nossa plataforma remove e oculta automaticamente a opção de criar ou selecionar mensagens com botões (tanto nos Modelos de Mensagem quanto no construtor de Chatbots) caso o canal selecionado seja da Evolution API.
* 🚫 **Sem Reações e Edições Ativas:** Embora o sistema mostre quando o cliente reage ou edita uma mensagem, no momento não é possível que o atendente da plataforma reaja ou edite as mensagens já enviadas para o cliente.
* 🚫 **Sem Mensagem de Rodapé:** O recurso que adiciona uma assinatura/mensagem de rodapé aos fluxos do Chatbot não está implementado para este canal.
* 🚫 **Sem Confirmação de Leitura em Grupos:** As mensagens enviadas em grupos através deste canal não recebem o retorno de confirmação de leitura (status de entregue ou lida por membro).
  * **Impacto na interface:** Devido a essa restrição, o menu de "Detalhes da mensagem" (que exibe a lista de quem leu ou recebeu a mensagem no grupo) não ficará visível para canais Evolution.

Fique à vontade para conectar um número e explorar essa nova alternativa de conexão! 🚀


---

# Agent Instructions: 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:

```
GET https://docs.helena.app/duvidas-e-novidades/novidades-de-produto/abril-de-2026/28-04-2026-evolution-api-versao-beta.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.