> ## Documentation Index
> Fetch the complete documentation index at: https://docs.evolutionfoundation.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# v1.0.0-rc3 — Estabilização e novas features

> **Release date:** 17 de maio de 2026
> **Tipo:** Release Candidate
> **Foco:** estabilização (muitas correções de bugs) + três features cross-stack

O `v1.0.0-rc3` chega cerca de **12 dias após o `v1.0.0-rc2`** e concentra \~165 commits entre os submódulos da família CRM Community. O foco predominante é **correção de bugs** identificados em produção depois do rc2, combinado com três features cross-stack que vínhamos preparando: **products catalog**, **template bundles** e **integração com Knowledge Nexus**.

***

## Highlights

### Estabilização

Frentes principais de hardening:

* **Mensageria Evolution Go / Evolution API** — paridade de payload em mensagens interativas (botões e listas) corrigida (EVO-1115). Entrega de mídia outbound em ambos os providers funcionando consistentemente (EVO-1151). Deduplicação de mensagens duplicadas no incoming handler.
* **Hardening do endpoint Notificame verify** (EVO-986) — auth obrigatório, validação fechada, sem error leakage. Detalhes em [Webhooks](/user-guides/settings/integrations).
* **2FA backup codes** (EVO-991) — códigos agora armazenados com hash BCrypt no banco. Correção do erro 500 ao listar codes. Ver [Autenticação em Duas Etapas](/user-guides/security/two-factor-authentication).
* **Filtragem de secrets nos logs Rails** (EVO-1111) — campos sensíveis (password, token, api\_key) são filtrados antes de chegar ao log.
* **IDOR no `BulkActionsJob`** (EVO-1084) — escopo de account aplicado; antes era possível manipular recursos cross-tenant com um ID válido.

### Três features cross-stack

#### 📦 Catálogo de Produtos

Cadastre seu portfólio de produtos com variantes (preço, SKU), vincule a agentes de IA e a itens de pipeline. O agente passa a conhecer seu catálogo automaticamente, sem precisar colar tabela no prompt. Inclui tool nativa `link_product_to_pipeline_item` para o agente registrar oportunidades de venda durante a conversa.

Ver [Catálogo de Produtos](/user-guides/products/overview).

#### 📤 Template Bundles export/import (EVO-1116)

Exporte a configuração da sua instalação (inboxes, agentes, automation rules, canned responses, templates) como um arquivo ZIP portável. Importe em outra instalação para replicar setups, migrar entre staging/produção ou criar templates de instalação reutilizáveis.

Ver [Bundles de Configuração](/user-guides/settings/template-bundles).

#### 🔌 Integração com Knowledge Nexus

Agentes de IA podem consultar **Knowledge Nexus spaces** diretamente do prompt, usando a tool nativa `knowledge_nexus_search`. Útil quando sua organização já mantém uma base de conhecimento separada do CRM.

Ver [Knowledge Nexus](/user-guides/agents/knowledge-nexus).

***

## Outras Adições Relevantes

### UI

* **Roles & Permissions admin UI** (EVO-1061) — tela completa de gestão de papéis customizados, com CRUD pleno e guard contra privilege escalation via delegation. Ver [Funções Personalizadas](/user-guides/settings/custom-roles).
* **Bulk resolve de conversas** (EVO-1011) — resolver várias conversas em lote via checkbox na lista. Ver [Ações de Conversa](/user-guides/conversations/conversation-actions).
* **Pipeline actions no menu 3 pontos + context menu** (EVO-990) — ações de pipeline acessíveis sem precisar abrir o detalhe do card.
* **Telefone do contato visível na lista e no header** (EVO-988).
* **Reconexão ativa de WebSocket** (EVO-1085) — toast de sucesso ao restabelecer + backoff em background.
* **Upload de arquivos elevado para 100MB** (EVO-1131).

### Automation Rules

* **Operador `attribute_changed` com pickers From/To** (EVO-1058) — dispare regra apenas em transições específicas.
* **Triggers `conversation_resolved` e `conversation_status_changed`** (EVO-1057).
* **Action `move_to_pipeline`** — move item para pipeline diferente preservando id.
* **Painel de Logs** — visualize execuções, conditions avaliadas e erros.
* **Dedup em janela de 5s** para `pipeline_stage_updated` por `(rule, pipeline_item, stage)`.

Ver [Visão Geral de Automation](/user-guides/automation/overview) e [Regras](/user-guides/automation/rules).

### Auth Service

* **CRUD completo de roles com escopo `account_owner`** (EVO-1061).
* **Permissões `products.*` e `template_bundles`** no RBAC.
* **SMTP/BMS/Resend aplicados em runtime** (EVO-1049) — sem precisar restart do container ao mudar configuração via UI.
* **Password validation 422 estruturada** (EVO-1063) — frontend mostra checklist inline.

### Processor

* **Tools nativas** para LLM agent: `knowledge_nexus_search`, `manage_conversation_labels`, `link_product_to_pipeline_item`.
* **Catálogo de produtos injetado no contexto** do agente.
* **Merge de integrações em runtime** — mudanças em `agent_integrations` refletem na próxima conversa sem reconfigurar.

***

## Notas de Upgrade

### ✅ Aplicação automática

* **RBAC do role `agent`** — `pipelines.read` é backfilled via migration; `pipelines.update` é removido (teria desbloqueado endpoints destrutivos por erro). Sem ação manual.
* **SMTP/BMS/Resend runtime** — funciona automaticamente após upgrade do auth-service. Operador pode trocar configs sem restart.
* **Filtragem de secrets** — ativa após upgrade do CRM. Logs anteriores ao upgrade não são afetados.
* **Hash dos backup codes 2FA** — codes gerados a partir do rc3 são hashed automaticamente.

### ⚠️ Atenção

* **Backup codes 2FA gerados antes do rc3** — ficavam em plaintext no banco. Se o histórico do banco esteve acessível a alguém fora do operador da instalação, recomenda-se regenerar via `Perfil → Segurança`. A operação leva 30 segundos.
* **Pipelines stage automation** — se você usava regras `move_to_stage` em produção, valide o comportamento após upgrade. A janela de dedup de 5s pode mudar o timing de regras em rajada (antes podia disparar múltiplas vezes; agora dispara uma vez).

### 📝 Configuração nova

Variável de ambiente nova no `.env.example`:

```bash theme={null}
EVOLUTION_OPERATOR_EMAIL=ops@seudominio.com
```

Usada para licensing/telemetria. Não bloqueia o boot se ausente, mas recomenda-se preencher em produção.

***

## Compatibilidade

* **Banco de dados:** migrations rodam automaticamente em `db:migrate`. Tudo idempotente e reversível.
* **Container:** rebuild necessário para todos os 5 serviços. Imagens publicadas no Docker Hub com tag `1.0.0-rc3`.
* **Frontend:** hard refresh do browser necessário para invalidar o bundle antigo.
* **Submódulos:** se você usa a estrutura umbrella, atualize os pointers com `git submodule update --remote`.

***

## Histórico de Releases

* [`v1.0.0-rc2`](/release-notes/v1.0.0-rc2) — Estabilização e mídia WhatsApp Cloud (2026-05-05)
* [`v1.0.0-rc1`](/release-notes/v1.0.0-rc1) — Primeiro release candidate público (2026-04-24)

## Detalhamento técnico

Para o changelog técnico completo com IDs de PRs e commits, consulte:

* [`CHANGELOG.md` do umbrella](https://github.com/evolution-foundation/evo-crm-community/blob/main/CHANGELOG.md)
* `CHANGELOG.md` de cada submódulo no respectivo repositório


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.