> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ararahq.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Changelog
> Mudanças notáveis na API, SDKs, CLI e MCP. SemVer adotado em todos os SDKs. Breaking changes anunciadas com 6 meses de antecedência.
Histórico de mudanças significativas. Adotamos [SemVer](https://semver.org/lang/pt-BR/) em todos os SDKs.
**Política de breaking changes**: anunciadas com **≥ 6 meses de antecedência** via email, banner no dashboard e tag `deprecated` no SDK. Endpoints removidos só após período de sunset.
## Outubro 2026
### Planos e preços
* **Nova tabela de planos**: Voo (R$ 997/mês, 50.000 envios por mês), Primeira Classe (R$ 2.900/mês, com implantação feita pelo time por R\$ 2.900, uma vez) e Sob medida (preço por faixa de volume, para mais de 100 mil mensagens por mês). Detalhes em [Preços e limites](/concepts/pricing).
* Quem assinou um plano anterior mantém o preço e as condições contratadas.
## Setembro 2026
### Planos e preços
* **Nova tabela para contas criadas a partir de 10/09/2026**: Essencial (R$ 597/mês, até 20.000 mensagens enviadas no mês), Voo (R$ 997/mês, até 50.000) e Primeira Classe (sob consulta, sem teto). Os planos se diferenciam por assentos, números e automações. Ver [Preços e limites](/concepts/pricing).
* **Mensagem a preço de custo** nos planos novos: tarifa Meta do país de destino mais US\$ 0,001 do provedor, convertidos pelo câmbio da Arara, sem taxa por mensagem.
* **Câmbio de fonte única**, com referência de R\$ 5,85 por dólar.
* **Campanhas em todos os planos.**
* Contas anteriores a 10/09/2026 mantêm o preço e as condições contratadas.
### API
* **Códigos próprios para recusa de envio**: `RECIPIENT_OPTED_OUT`, `INVALID_RECIPIENT`, `CONVERSATION_WINDOW_CLOSED`, `TEMPLATE_NOT_SENDABLE`, `TEMPLATE_PAUSED`, `TEMPLATE_VARIABLES_MISMATCH` e `SENDER_NOT_ALLOWED` (422), `FRAUD_SUSPECTED` (403), `SEND_RATE_LIMITED` e `MARKETING_FREQUENCY_EXCEEDED` (429, com `Retry-After`). Antes a maioria saía como `422 UNPROCESSABLE_ENTITY` genérico.
* **Biblioteca de templates da Meta**: `GET /v1/templates/library` e `POST /v1/templates/library` criam templates UTILITY já aprovados.
### SDKs
* **Node, Python, PHP e Java 2.0.0; Go v1.0.0 e Ruby 1.0.0.** Em Node, Python, PHP, Go e Ruby: `Idempotency-Key` automática no envio (ou a sua, quando você passa), consulta de mensagem por id (`messages.get`), envio em lote e recursos de contatos, conversas, campanhas, carteira, números, smart links e opt-outs. No PHP, `WebhookUtils::verifySignature()` com timestamp. Ruby publicado no RubyGems, Go com a tag `v1.0.0` e Java no GitHub Packages. Ver [SDKs](/sdks).
### MCP
* **`@ararahq/mcp` v6.** 9 ferramentas no conjunto padrão: `whoami`, `send_whatsapp`, `broadcast`, `campaign_report`, `check_status`, `create_template`, `save_contacts`, `opt_out` e `read_conversation`. Painéis interativos (MCP Apps) em `broadcast`, `campaign_report`, `check_status` e `read_conversation`. Servidor hospedado em `https://mcp.ararahq.com/mcp` (Streamable HTTP, OAuth); o endpoint SSE antigo não existe mais. Ver [MCP Server](/mcp-server).
* **Ferramentas das versões antigas foram consolidadas.** `send_template` virou `send_whatsapp` com `templateName`; `broadcast_ab`, `prepare_campaign`, `campaign_preflight` e `publish_campaign` viraram `broadcast` (prévia por padrão, `abTest` opcional); `list_campaigns` e `get_campaign` viraram `campaign_report`; `check_message` e `get_template_status` viraram `check_status`; `get_conversation`, `draft_reply` e `reply_to_conversation` viraram `read_conversation` e `send_whatsapp`; as tools de smart link viraram o botão `SMART_LINK` no `create_template`; `login` e `logout` passaram para a CLI (`npx -y @ararahq/mcp login`). Saíram as tools de fila de atendimento (`get_today`, `triage_today`, `find_conversations`, `claim_conversation`, `close_conversation`, `close_case_review`) e as de automação do pacote antigo: atendimento é trabalho do dashboard. O pacote antigo sem escopo, `ararahq-mcp`, é a v4 congelada. Ver [Ferramentas do MCP](/mcp-tools).
***
## Julho 2026
Os nomes de plano abaixo são históricos. Planos atuais em [Preços e limites](/concepts/pricing).
### MCP
* **v4.0.0.** Corte de 84 para **10 tools**: `send_whatsapp` aceita nome ou número em qualquer formato e resolve E.164, nono dígito e janela de 24h sozinha; `broadcast` dispara template aprovado pra até 1.000 pessoas; leitura virou 10 resources que o cliente carrega sem tool call. Configuração de conta saiu do MCP — é trabalho de dashboard. Deploy contínuo: push na main publica em [mcp.ararahq.com](https://mcp.ararahq.com). Ver [Ferramentas do MCP](/mcp-tools).
## Maio 2026
### Plataforma
* **Policy violations dedupe**: webhook `policy.violation` agora envia uma vez por chave (não duplica em sweeper rerun)
* **Business profile management**: novos endpoints `/v1/organizations/me/business-profile` (GET/PATCH/sync) — controla nome exibido, vertical, descrição, foto, horário, websites
* **A/B test pra campanhas**: `POST /v1/campaigns/{id}/ab-test` com autopilot, sample %, decision window, métrica configurável (DELIVERED/READ/CLICKED/CONVERTED)
* **Warming recommendations**: `GET /v1/organizations/me/numbers/warming` retorna recomendação de send rate por número baseada em quality
* **LGPD self-serve**: novos endpoints `/v1/profile/export` (exporta todos seus dados) e `/v1/profile/delete-account` (eliminação com confirmação exata)
### MCP
* **v3.0.0** — Rewrite completo. **84 tools** (de 19), 7 resources, 5 prompts. OAuth Device Flow integrado. WhatsApp-native.
### CLI
* **v0.2.0** — `arara init`, `arara api`, `arara listen --capture`, `arara listen --forward-to`, `arara profile`, `arara org`, `arara telemetry`, `arara upgrade --install`
* OAuth Device Flow validado end-to-end
* jq embarcado (`--jq `) — filtra JSON sem dep externa
### Dashboard
* Auto-recharge configurável: threshold + valor de recarga
* Limite mensal de conversas do Brain por plano (sem limite no Enterprise)
* Onboarding gate: novos usuários começam em `TESTING` (não `ACTIVE`)
***
## Abril 2026
### Plataforma
* **CLI webhook listener (RFC 0003)**: capture mode pra dev local sem ngrok
* **Multi-org via M2M**: usuário pode pertencer a múltiplas organizações; `GET /auth/me/organizations` lista todas
* **Stream SSE real**: `/v1/stream` com per-org publisher
* **Brain hard activation gate**: bloqueia ativar Brain com pré-requisitos pendentes (sem número dedicado, sem business profile)
* **Limite de uso do Brain**: conversas por mês conforme o plano. Endpoint `GET /v1/brain/usage` pra acompanhar
* **Account status endpoint**: `GET /v1/account/status` retorna se conta está em onboarding, ativa, suspensa
* **Onboarding `ACCOUNT_NOT_ACTIVATED` guard**: tentativa de enviar mensagem antes de ativar retorna erro estruturado
### Backend
* Fix campanha contando variáveis do template — agora baseado em `structureJson` Meta, não regex local
* Fix transacional em SQS worker: `markFailed` não rethrow dentro de `@Transactional` (evitava commit do estado)
* Orphan PENDING sweeper: mensagens órfãs em status `processing` por > 5min são recolocadas na fila
### Pricing
* **Plano FREE sincronizado com a página de preços** e sem limite mensal de mensagens: a carteira pré-paga era o limite natural
* **Plano Starter**: inbox habilitado, com assentos inclusos
* **Brain como add-on**, incluído no Enterprise
* **Assento extra** cobrado à parte nos planos BUSINESS e acima
***
## Março 2026
### Plataforma
* **Bônus de boas-vindas**: assinatura ou primeira recarga Pix ganhava um bônus proporcional ao valor
* **Stripe embedded checkout**: substituí hosted page por embedded (menos abandono)
* **Smart Links com atribuição 1st-party**: substitui UTM clássico, sobrevive a ITP/Brave Shield
* **Brain Actions**: AbacatePay (Pix), Cal.com, Catalog, Stripe — o Brain executa, não só responde
* **Brain eval suite**: defina casos, rode contra Brain, mede pass rate
### Backend
* **Brain semantic cache** — respostas similares cacheadas (corta custo OpenAI)
* **Brain RAG hybrid BM25 + vector** — recall melhor em queries com termos raros
* **Brain audit trail** — log estruturado de toda decisão Brain (handoff, action call, citation)
* **Lead qualifier multi-dim**: score por intent, budget, urgency, fit
***
## Fevereiro 2026
### Plataforma
* **WhatsApp self-serve onboarding**: cliente conecta número Meta Business sem precisar suporte
* **Contatos como recurso 1st-class**: `/v1/contacts` com batch upsert + busca paginada + `attributes` flexível por contato
* **Per-customer memory no Brain**: o Brain lembra de cada cliente (LTV, tier, mood)
### SDKs
* Node SDK v1.7 → 1.8: tipos pra webhook events (`AraraWebhookEvent`)
* Python SDK v1.7 → 1.8: campaigns + brain + payments resources
* PHP SDK v1.7 → 1.8: named arguments PHP 8.2+
***
## Janeiro 2026
### Plataforma
* **Brain copilot mode**: Brain sugere resposta, humano aprova (vs autopilot)
* **Brain per-customer memory** — RAG focado em histórico de cada cliente
* **Lead qualifier**: score automático (HOT/WARM/COLD) por conversação
### Backend
* **Phone lookups cache** — reduz call Meta pra validar número
* **API key security pack**: IP allowlist (BUSINESS+), rotation, revoke, audit log
* **Webhook delivery detail**: retry log expandido (timing, status code, response body)
* **Team management**: convites, roles (OWNER/MEMBER), seats
***
## 2025
Histórico antes de 2026 mantido [no GitHub releases](https://github.com/ararahq) de cada SDK.
Highlights:
* Lançamento da Arara — Dec/2025
* API REST v1 disponibilizada
* SDKs Node, Python, PHP e Java
* Integração com AbacatePay (Pix nativo BR)
* Tech Provider Meta aprovado
***
## Política de deprecation
Endpoint ou campo marcado como `deprecated`:
1. **Mês 0**: anuncio no changelog + email pros clientes que usam + tag `deprecated` no OpenAPI
2. **Mês 0-6**: continua funcionando, log warning
3. **Mês 6**: remoção
Hoje marcados como deprecated:
| Campo / Endpoint | Substituto | Remoção |
| - | - | - |
| `SendMessageRequest.mediaUrl` | `templateVariables[0]` (URL como primeiro elemento) | Q4 2026 |
## Próximos passos
Códigos de erro da API e como tratar cada um.
Detalhe técnico por SDK.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.