> For the complete documentation index, see [llms.txt](https://docs.helena.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.helena.app/duvidas-e-novidades/novidades-de-produto/abril-de-2026/28-04-2026-evolution-api-versao-beta.md).

# 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! 🚀