Changelog

Histórico de mudanças significativas. Adotamos SemVer em todos os SDKs.

​

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.
• 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.
• 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.

​

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.
• 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.

---

​

Julho 2026

Os nomes de plano abaixo são históricos. Planos atuais em Preços e limites.

​

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. Ver Ferramentas do MCP.

​

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 <expr>) — 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 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:

​

Próximos passos