> ## 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. # Preços e limites > Planos, preço por mensagem, carteira e os limites de envio e operação, com a resposta da API quando um limite é atingido. A conta tem duas partes: ``` Mensalidade do plano (Voo, Primeira Classe ou Sob medida) + Mensagens a preço de custo: tarifa da Meta + tarifa do provedor, convertidas para reais, sem taxa da Arara ``` A mensalidade paga a plataforma (caixa de entrada, campanhas, automações, IA, pessoas, números). A mensagem sai da carteira pré-paga pelo custo real. Não existe plano gratuito nem modo de teste. Toda mensagem é real e debita da carteira. Quem assinou um plano anterior (Embarque, Essencial ou outro) continua com o preço e as condições que contratou. O valor de cada conta aparece no [painel](https://app.ararahq.com/dashboard/faturamento). ## Planos | | Voo | Primeira Classe | Sob medida | | - | - | - | - | | **Para quem** | Quem vende caro e quer ver, todo mês, quanto voltou | A operação grande: o time da Arara coloca no ar, integra e cuida do número com você | Quem manda mais de 100 mil mensagens por mês | | **Mensalidade** | R\$ 997/mês | R\$ 2.900/mês | Por faixa de volume, em contrato | | **Implantação** | Você mesmo, pelo painel | Feita pelo time: R\$ 2.900, uma vez | Feita pelo time | | **Envios por mês** | 50.000 | Ilimitados | Mais de 100 mil | | **Pessoas** | 10 | Ilimitadas | Ilimitadas | | **Números** | 1 incluso | 3 inclusos | Quantos precisar, dedicados | | **Automações ativas** | 10 | Ilimitadas | Ilimitadas | | **Como contratar** | [Começar agora](https://app.ararahq.com) | Falar com vendas | Falar com vendas | **No Voo:** * Recuperação de receita: carrinho, Pix, boleto, cartão recusado e orçamento parado. * Brain, a IA que responde e chama uma pessoa na dúvida. * Teste A/B e formulários dentro do WhatsApp. * API, SDKs, CLI e MCP. * 7 dias de garantia: se desistir, a mensalidade volta inteira. **Na Primeira Classe, tudo do Voo e mais:** * Implantação pelo time: número, conta na Meta, templates aprovados e automações no ar. * Integração feita com você: seu agente, sua IA ou seu sistema. * Várias contas na Meta, com trilha de auditoria. * Encontro mensal e SLA de 99,9%. * Contrato, DPA, fatura e boleto. **No Sob medida, tudo da Primeira Classe e mais:** * Preço por faixa de volume, fechado em contrato. * Números dedicados, com o limite de envio trabalhado junto à Meta. Em todos os planos a mensagem sai a preço de custo da Meta. O teto mensal de envios é de segurança, não de cobrança: quem precisa enviar mais sobe de plano. Números além dos inclusos são cobrados à parte. A mensalidade não inclui créditos: o saldo da carteira é recarregado à parte. Os planos atuais não têm limite de templates. Contas no plano Free legado têm teto de 3 templates aprovados e recebem `403 PLAN_LIMIT_REACHED`. O que acontece quando cada limite é atingido está em [Limites](#limites). ## Preço por mensagem ``` preço = (tarifa Meta do país de destino + US$ 0,001 do provedor) × câmbio ``` * **Tarifa Meta**: depende do país do destinatário e da categoria do template. * **Provedor**: US\$ 0,001 por mensagem, repassado sem margem. * **Câmbio**: definido pela Arara e já inclui IOF e impostos do repasse. Em setembro de 2026, R\$ 5,85 por dólar. * **Taxa da Arara**: zero. A margem está na mensalidade. Referência para números brasileiros, com câmbio de R\$ 5,85: | Tipo de mensagem | Tarifa Meta (US\$) | Preço aproximado | | - | - | - | | Template **MARKETING** (promoção, reativação, campanha) | 0,0625 | R\$ 0,37 | | Template **UTILITY** (pedido, cobrança, agendamento) | 0,0068 | R\$ 0,046 | | Template **AUTHENTICATION** (código de verificação) | 0,0068 | R\$ 0,046 | | **Texto livre na janela de 24h** (resposta de atendimento) | 0 | R\$ 0,006 | | **Mensagem recebida** do cliente | 0 | R\$ 0,006 | Tarifa Meta e câmbio mudam. A tabela acima é referência. O preço vigente para a sua conta, por categoria e por mercado, sai de `GET /v1/pricing/current`. Mensagem recebida não paga taxa da Arara: a carteira só é debitada no custo do provedor. Se faltar saldo, a mensagem recebida entra normalmente na caixa de entrada. Quando um envio falha, o valor debitado volta para a carteira automaticamente. ## Exemplos **Reativação da base** (Voo), 30.000 templates MARKETING no mês e 6.000 respostas de atendimento dentro da janela: ``` Plano Voo: R$ 997,00 30.000 × R$ 0,37 (MARKETING): R$ 11.100,00 6.000 × R$ 0,006 (texto livre na janela): R$ 36,00 ───────────── Total aproximado: R$ 12.133,00 ``` **Notificações transacionais** (Voo), 15.000 templates UTILITY no mês: ``` Plano Voo: R$ 997,00 15.000 × R$ 0,046 (UTILITY): R$ 690,00 ───────────── Total aproximado: R$ 1.687,00 ``` Valores de mensagem aproximados, com câmbio de R\$ 5,85, destinatários no Brasil e sem contar mensagens recebidas. ## Carteira As mensagens são pagas com créditos pré-pagos, carregados por Pix ou cartão no Dashboard. Sem saldo, novos envios são recusados com `402 INSUFFICIENT_FUNDS`. Para não parar a operação, ative a auto-recarga: quando o saldo cai abaixo do limite configurado, a carteira é recarregada no cartão. ```bash theme={null} # Consultar a configuração curl https://api.ararahq.com/v1/wallet/auto-recharge \ -H "Authorization: Bearer $ARARA_API_KEY" ``` A mesma configuração é alterada com `PATCH` no endpoint acima ou pelo Dashboard. ## Estimativas via API ```bash theme={null} # Preço vigente por categoria e rate card da Meta por mercado curl "https://api.ararahq.com/v1/pricing/current?market=BR" \ -H "Authorization: Bearer $ARARA_API_KEY" # Quantas mensagens de cada categoria um valor compra (em centavos) curl "https://api.ararahq.com/v1/wallet/calculate?amountCents=10000" \ -H "Authorization: Bearer $ARARA_API_KEY" ``` Os dois endpoints usam o plano e a tabela de preço da sua conta. Para estimar uma campanha antes de enviar, use `GET /v1/campaigns/estimate`. ## Limites ### Teto mensal de mensagens O teto conta as mensagens enviadas pela Arara no mês: envios de campanha, envios pela API e respostas de atendentes, tudo no mesmo contador. Mensagens que o cliente manda para você não contam. Quando o envio passaria do teto, a API recusa com HTTP 403: ```json theme={null} { "error": { "code": "PLAN_LIMIT_REACHED", "message": "Limite do plano atingido em 'MESSAGES_PER_MONTH': 50000/50000.", "details": { "feature": "MESSAGES_PER_MONTH", "current": 50000, "max": 50000, "currentPlan": "VOO", "upgradeTo": "..." } } } ``` O contador zera na virada do mês. Campanha cancelada, ou contato barrado por opt-out durante a campanha, devolve a cota que tinha sido reservada. Retentativas com o mesmo `Idempotency-Key` não contam duas vezes. O mesmo código `PLAN_LIMIT_REACHED` aparece em outros limites numéricos, com `details.feature` indicando qual: `ACTIVE_AUTOMATIONS` (automações ativas) e `TEAM_MEMBERS` (membros da equipe, checado no convite). Recurso que o plano não inclui responde HTTP 403 com `PLAN_FEATURE_LOCKED`. Em `details`, `currentPlan` traz o identificador interno do plano: `VOO` (Voo) e `VOO_ASSISTIDO` (Primeira Classe). Contas em planos anteriores trazem `EMBARQUE`, `ESSENTIAL` ou outro identificador antigo. Trate `upgradeTo` só como sugestão. Para escolher o plano, compare a tabela de [Planos](#planos). ### Consultar o plano ```bash theme={null} curl https://api.ararahq.com/v1/organizations/me/plan \ -H "Authorization: Bearer $ARARA_API_KEY" ``` Retorna o plano atual (`current`), o preço de referência por categoria de mensagem e a lista de recursos do plano. O consumo do mês aparece no [Dashboard](https://app.ararahq.com). ### Limites de proteção Estes limites protegem o seu número e a sua reputação na Meta. Valem em qualquer plano. | Situação | Resposta | | - | - | | Destinatário pediu para não receber (opt-out) | `422 RECIPIENT_OPTED_OUT` | | Telefone fora do formato aceito | `422 INVALID_RECIPIENT` | | Muitas mensagens para o mesmo destinatário em poucos minutos | `403 FRAUD_SUSPECTED` | | Frequência alta de MARKETING para o mesmo destinatário (referência: 4 em 24h) | `429 MARKETING_FREQUENCY_EXCEEDED` | | Limite diário configurado na própria chave de API (dia em UTC) | `429 SEND_RATE_LIMITED` | Respostas `429` trazem o header `Retry-After` quando aplicável. Veja [Erros](/erros) para o tratamento de cada código. Contas novas enviam só pelo próprio número conectado; sem ele o envio responde `403 NO_DEDICATED_NUMBER`. Contas antigas habilitadas no número compartilhado da Arara têm limites mais baixos: 250 mensagens por dia por organização, 50 por dia por destinatário e 30 mensagens dentro da janela de 24h por destinatário por hora. Com número próprio esses tetos não se aplicam. A Meta também impõe, por número, um limite diário de destinatários únicos fora da janela de 24h. Ele sobe conforme a qualidade e o volume do número e vale em qualquer plano. Veja [Números: qualidade e limite de envio](/numbers). ### Antes de assinar Criar a conta, gerar a chave de API, conectar o número e criar templates não exige plano. Para enviar, é preciso um plano ativo, um número conectado, um template aprovado e saldo na carteira. Sem assinatura, o envio responde `403 ACCOUNT_NOT_ACTIVATED`. Veja [Envie sua primeira mensagem](/quickstart). ### Pagamento em atraso Se a cobrança da mensalidade falhar, o acesso aos recursos do plano continua durante o período de carência enquanto o pagamento é tentado de novo. Passado esse prazo sem pagamento, os recursos do plano são suspensos até a regularização. ## Próximos passos Opt-in, opt-out, qualidade e suspensão. Quando dá para mandar texto livre e quando precisa de template. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.