diff --git a/_billing/billing-overview.md b/_billing/billing-overview.md
index 7e02677..57c7167 100644
--- a/_billing/billing-overview.md
+++ b/_billing/billing-overview.md
@@ -3,16 +3,17 @@ languages: ["en", "es"]
en:
title: Pricing, billing, and plans overview
- description: Understand where to find plan, usage, attribution, SMS limit, and billing information.
+ description: Understand pricing, usage, channel costs, invoices, payment methods, and plan changes.
es:
title: Resumen de precios, facturación y planes
- description: Entiende dónde encontrar información sobre planes, consumos, atribución, límites de SMS y facturación.
+ description: Entiende precios, consumos, costos de canales, facturas, métodos de pago y cambios de plan.
permalink: pricing-billing-plans-overview
permalink_es: resumen-precios-facturacion-planes
layout: guide
topic: billing
+navigation_group: foundations
popular: false
---
diff --git a/_billing/billing-settings-and-invoices.md b/_billing/billing-settings-and-invoices.md
new file mode 100644
index 0000000..6d72fa0
--- /dev/null
+++ b/_billing/billing-settings-and-invoices.md
@@ -0,0 +1,20 @@
+---
+languages: ["en", "es"]
+
+en:
+ title: Billing settings, payment methods, and invoices
+ description: "Find your plan, usage, balance, payment methods, billing details, and monthly invoices."
+es:
+ title: Facturación, métodos de pago y facturas
+ description: "Encuentra tu plan, consumos, saldo, métodos de pago, datos fiscales y facturas mensuales."
+
+permalink: billing-settings-and-invoices
+permalink_es: facturacion-metodos-pago-facturas
+
+layout: guide
+topic: billing
+navigation_group: account_billing
+popular: false
+---
+
+{% translate_file billing/billing-settings-and-invoices.md %}
diff --git a/_billing/billing-troubleshooting.md b/_billing/billing-troubleshooting.md
new file mode 100644
index 0000000..056909b
--- /dev/null
+++ b/_billing/billing-troubleshooting.md
@@ -0,0 +1,20 @@
+---
+languages: ["en", "es"]
+
+en:
+ title: Troubleshoot billing questions
+ description: "Reconcile usage, invoices, payment methods, plan changes, taxes, and separate channel charges."
+es:
+ title: Solucionar dudas de facturación
+ description: "Revisa consumos, facturas, métodos de pago, cambios de plan, impuestos y costos separados por canal."
+
+permalink: billing-troubleshooting
+permalink_es: solucionar-dudas-facturacion
+
+layout: guide
+topic: billing
+navigation_group: account_billing
+popular: false
+---
+
+{% translate_file billing/billing-troubleshooting.md %}
diff --git a/_billing/change-or-cancel-your-plan.md b/_billing/change-or-cancel-your-plan.md
new file mode 100644
index 0000000..a31a666
--- /dev/null
+++ b/_billing/change-or-cancel-your-plan.md
@@ -0,0 +1,20 @@
+---
+languages: ["en", "es"]
+
+en:
+ title: Change or cancel your plan
+ description: "See where to change plans and how effective dates and prorated charges are presented."
+es:
+ title: Cambiar o cancelar tu plan
+ description: "Conoce dónde cambiar de plan y cómo se muestran las fechas efectivas y los cargos prorrateados."
+
+permalink: change-or-cancel-your-plan
+permalink_es: cambiar-o-cancelar-plan
+
+layout: guide
+topic: billing
+navigation_group: account_billing
+popular: false
+---
+
+{% translate_file billing/change-or-cancel-your-plan.md %}
diff --git a/_billing/fair-use-message-policy.md b/_billing/fair-use-message-policy.md
new file mode 100644
index 0000000..067f0df
--- /dev/null
+++ b/_billing/fair-use-message-policy.md
@@ -0,0 +1,20 @@
+---
+languages: ["en", "es"]
+
+en:
+ title: Fair-use message policy
+ description: "Learn when the variable fee for non-SMS messages becomes the monthly billed amount."
+es:
+ title: Política de fair use para mensajes
+ description: "Conoce cuándo el cargo variable por mensajes que no son SMS se convierte en el monto facturado del mes."
+
+permalink: fair-use-message-policy
+permalink_es: politica-fair-use-mensajes
+
+layout: guide
+topic: billing
+navigation_group: pricing_model
+popular: false
+---
+
+{% translate_file billing/fair-use-message-policy.md %}
diff --git a/_billing/how-pricing-works.md b/_billing/how-pricing-works.md
index 84532c5..bc0cb1c 100644
--- a/_billing/how-pricing-works.md
+++ b/_billing/how-pricing-works.md
@@ -13,6 +13,7 @@ permalink_es: explicacion-de-tarifas
layout: guide
topic: billing
+navigation_group: pricing_model
popular: true
---
diff --git a/_billing/performance-fee-calculation.md b/_billing/performance-fee-calculation.md
new file mode 100644
index 0000000..b7f8cbc
--- /dev/null
+++ b/_billing/performance-fee-calculation.md
@@ -0,0 +1,20 @@
+---
+languages: ["en", "es"]
+
+en:
+ title: Performance fee calculation
+ description: "Understand how your plan rate applies to revenue attributed to Hellotext."
+es:
+ title: Cálculo de la tarifa por rendimiento
+ description: "Entiende cómo se aplica la tarifa de tu plan a los ingresos atribuidos a Hellotext."
+
+permalink: performance-fee-calculation
+permalink_es: calculo-tarifa-rendimiento
+
+layout: guide
+topic: billing
+navigation_group: pricing_model
+popular: false
+---
+
+{% translate_file billing/performance-fee-calculation.md %}
diff --git a/_billing/sms-pricing-and-number-types.md b/_billing/sms-pricing-and-number-types.md
new file mode 100644
index 0000000..10715d4
--- /dev/null
+++ b/_billing/sms-pricing-and-number-types.md
@@ -0,0 +1,20 @@
+---
+languages: ["en", "es"]
+
+en:
+ title: SMS pricing and sender types
+ description: "Understand SMS rates, plan allowances, and shared or exclusive short codes."
+es:
+ title: Precios de SMS y tipos de remitente
+ description: "Entiende las tarifas de SMS, lo incluido en tu plan y los códigos cortos compartidos o exclusivos."
+
+permalink: sms-pricing-and-number-types
+permalink_es: precios-sms-tipos-remitente
+
+layout: guide
+topic: billing
+navigation_group: channel_costs
+popular: false
+---
+
+{% translate_file billing/sms-pricing-and-number-types.md %}
diff --git a/_billing/understanding-plan-quotas.md b/_billing/understanding-plan-quotas.md
index 605c56f..3097f66 100644
--- a/_billing/understanding-plan-quotas.md
+++ b/_billing/understanding-plan-quotas.md
@@ -2,17 +2,18 @@
languages: ["en", "es"]
en:
- title: Plan usage and quotas
- description: "See what is included in your plan and how usage counts toward your bill."
+ title: Plan usage and monthly charges
+ description: "Read the usage summary for a billing period and understand which amount drives the monthly charge."
es:
- title: Uso y consumos del plan
- description: "Conoce qué incluye tu plan y cómo se cuentan tus consumos."
+ title: Uso del plan y cargos mensuales
+ description: "Interpreta el resumen de consumos de un período y entiende qué monto determina el cargo mensual."
permalink: understanding-plan-quotas
permalink_es: conociendo-los-consumos-del-plan
layout: guide
topic: billing
+navigation_group: account_billing
popular: false
---
diff --git a/_billing/whatsapp-fees.md b/_billing/whatsapp-fees.md
new file mode 100644
index 0000000..3bf4be4
--- /dev/null
+++ b/_billing/whatsapp-fees.md
@@ -0,0 +1,20 @@
+---
+languages: ["en", "es"]
+
+en:
+ title: Meta fees for WhatsApp
+ description: "Understand which WhatsApp charges come from Meta and how they differ from Hellotext charges."
+es:
+ title: Tarifas de Meta para WhatsApp
+ description: "Entiende qué costos de WhatsApp corresponden a Meta y cómo se diferencian de los cargos de Hellotext."
+
+permalink: whatsapp-fees
+permalink_es: tarifas-meta-whatsapp
+
+layout: guide
+topic: billing
+navigation_group: channel_costs
+popular: false
+---
+
+{% translate_file billing/whatsapp-fees.md %}
diff --git a/_config.yml b/_config.yml
index c05e6b0..86c8bf3 100644
--- a/_config.yml
+++ b/_config.yml
@@ -139,7 +139,14 @@ collections:
order:
- billing-overview.md
- how-pricing-works.md
+ - performance-fee-calculation.md
+ - fair-use-message-policy.md
+ - whatsapp-fees.md
+ - sms-pricing-and-number-types.md
- understanding-plan-quotas.md
+ - billing-settings-and-invoices.md
+ - change-or-cancel-your-plan.md
+ - billing-troubleshooting.md
captures:
output: true
order:
diff --git a/_data/guide_groups.yml b/_data/guide_groups.yml
index 13198ba..7561298 100644
--- a/_data/guide_groups.yml
+++ b/_data/guide_groups.yml
@@ -51,3 +51,17 @@ analytics-reporting-attribution:
- key: measurement_attribution
en: Measurement & attribution
es: Medición y atribución
+
+billing:
+ - key: foundations
+ en: Start here
+ es: Primeros pasos
+ - key: pricing_model
+ en: Pricing model
+ es: Modelo de cobro
+ - key: channel_costs
+ en: Messaging costs
+ es: Costos de mensajería
+ - key: account_billing
+ en: Billing & account
+ es: Facturación y cuenta
diff --git a/_i18n/en/billing/billing-overview.md b/_i18n/en/billing/billing-overview.md
index 64975a6..0286406 100644
--- a/_i18n/en/billing/billing-overview.md
+++ b/_i18n/en/billing/billing-overview.md
@@ -1,46 +1,42 @@
-Use this section to understand how Hellotext plans, usage, attributed revenue, and billing rules work together.
-
-Most billing questions start with one of three questions:
-
-- What does my plan include?
-- Which usage counts toward my monthly bill?
-- Why was revenue attributed to Hellotext?
+Use this section to understand what Hellotext charges, why a particular amount appears, and where to manage billing for your business.
## Start with the pricing model
-Hellotext uses a results-based pricing model. Depending on your plan and usage, your monthly Hellotext charge is based on the highest applicable billing item for the period.
-
-Keep reading: [Pricing model]({% link _billing/how-pricing-works.md %}).
+Hellotext compares the plan minimum, performance fee, SMS costs, and the variable non-SMS messaging amount. Only the highest of those four becomes the Hellotext amount for the period.
-For current plan pricing and SMS rate tables, always check the public [Hellotext pricing page](https://www.hellotext.com/pricing).
+Read [Pricing model]({% link _billing/how-pricing-works.md %}) before trying to add individual usage amounts together.
-## Review plan usage and quotas
+Current plan prices, included features, rates, and country-specific SMS allowances live on the public [Hellotext pricing page](https://www.hellotext.com/pricing).
-Your plan determines what is included, which usage is tracked, and how monthly activity is calculated.
+## Understand attributed revenue
-Use the plan usage guide when you need to understand plan minimums, performance fees, SMS costs, variable messaging fees, and how they appear on invoices.
+The performance fee uses revenue attributed to Hellotext, not all store revenue.
-Keep reading: [Plan usage and quotas]({% link _billing/understanding-plan-quotas.md %}).
+- [Performance fee calculation]({% link _billing/performance-fee-calculation.md %}) explains the billing calculation.
+- [How we attribute sales]({% link _analytics-reporting-attribution/sales-attribution.md %}) explains which orders and evidence are eligible.
-## Understand attribution
+## Understand messaging costs
-Attributed revenue matters because it can affect results-based billing and reporting.
+Messaging has three distinct concepts:
-Use the attribution guide when you need to understand source precedence, eligible evidence, attribution windows, team participation, supported order changes, and why a sale was or was not attributed to Hellotext.
+- [Fair-use message policy]({% link _billing/fair-use-message-policy.md %}) explains when eligible non-SMS message volume becomes the Hellotext amount.
+- [SMS pricing and sender types]({% link _billing/sms-pricing-and-number-types.md %}) explains country rates, plan allowances, and sender options.
+- [Meta fees for WhatsApp]({% link _billing/whatsapp-fees.md %}) explains the separate costs defined by Meta.
-Keep reading: [Sales attribution]({% link _analytics-reporting-attribution/sales-attribution.md %}).
+## Review usage and invoices
-## SMS limits for new businesses
+Open **Settings → Billing** to see your current plan, period usage, balance, payment history, payment methods, billing information, and available invoices.
-Some new prepaid businesses begin with a temporary SMS sending limit while Hellotext reviews sending quality.
+- [Plan usage and monthly charges]({% link _billing/understanding-plan-quotas.md %}) helps you interpret a selected period.
+- [Billing settings, payment methods, and invoices]({% link _billing/billing-settings-and-invoices.md %}) explains each billing control.
-Use the SMS limits guide when SMS messages are blocked by a temporary daily limit, or when you need to understand how the review period works.
+## Change the plan or solve a problem
-Keep reading: [SMS sending limits for new businesses]({% link _troubleshooting-deliverability/sms-sending-limits-for-new-businesses.md %}).
+- [Change or cancel your plan]({% link _billing/change-or-cancel-your-plan.md %}) explains upgrades, scheduled downgrades, and cancellations.
+- [Troubleshoot billing questions]({% link _billing/billing-troubleshooting.md %}) provides a reconciliation checklist and the details to send support.
## Related guides
+- [Revenue report guide]({% link _analytics-reporting-attribution/revenue-report-guide.md %})
- [Messaging channels overview]({% link _numbers/messaging-overview.md %})
-- [Campaign reporting]({% link _analytics-reporting-attribution/campaign-reporting.md %})
-- [Audience and segmentation overview]({% link _audience/audience-overview.md %})
-- [Setup and integrations overview]({% link _integrations/setup-overview.md %})
+- [SMS sending limits for new businesses]({% link _troubleshooting-deliverability/sms-sending-limits-for-new-businesses.md %})
diff --git a/_i18n/en/billing/billing-settings-and-invoices.md b/_i18n/en/billing/billing-settings-and-invoices.md
new file mode 100644
index 0000000..28bf066
--- /dev/null
+++ b/_i18n/en/billing/billing-settings-and-invoices.md
@@ -0,0 +1,54 @@
+Open **Settings → Billing** to manage the billing information for your business. The page brings together your plan, usage, balance, payment history, payment methods, billing details, and available invoices.
+
+## Current plan and usage
+
+The first cards show the active plan and the usage summary. Use **Change plan** to review other plans, and select a period in the usage summary to inspect billable activity.
+
+See [Plan usage and monthly charges]({% link _billing/understanding-plan-quotas.md %}) for help interpreting the comparison.
+
+## Balance and payment history
+
+The balance area shows funds available to the business when balance billing applies. Open **Payment history** and select a year or period to review recorded movements.
+
+The payment history is not a replacement for the invoice. Use it to trace balance movements, then use the invoice for the finalized billing document.
+
+## Payment methods
+
+The **Payment methods** section shows the methods available for the business. Depending on the business source and region, this can include a saved card, Shopify billing, or another supported arrangement.
+
+When the interface allows it, use **New payment method** to add a card. Keep at least one valid method available before enabling paid usage or changing to a paid plan.
+
+The public pricing page lists major credit cards and bank transfers depending on the region. The Billing page for your business is the source of truth for the methods currently available to that account.
+
+## Billing information and country
+
+Use **Billing information** to add the legal or tax details that should accompany billing records.
+
+The business country affects tax treatment and can affect currency and available payment methods. Use **Change country** carefully and confirm the tax notice shown by Hellotext before saving.
+
+## View an invoice
+
+1. Open **Settings → Billing**.
+2. Find **Invoices**.
+3. Select the year and month you want to review.
+4. Open the available invoice.
+
+Invoices appear after they are available for the billing period. If a month is not listed yet, confirm that the period has been finalized.
+
+## Before contacting support
+
+Have these details ready:
+
+- business or workspace identifier;
+- invoice month and currency;
+- the line or amount you are asking about;
+- the corresponding usage-summary period; and
+- any payment error shown in the interface.
+
+Do not send full card numbers, security codes, or banking credentials.
+
+## Related guides
+
+- [Pricing model]({% link _billing/how-pricing-works.md %})
+- [Change or cancel your plan]({% link _billing/change-or-cancel-your-plan.md %})
+- [Troubleshoot billing questions]({% link _billing/billing-troubleshooting.md %})
diff --git a/_i18n/en/billing/billing-troubleshooting.md b/_i18n/en/billing/billing-troubleshooting.md
new file mode 100644
index 0000000..f0bbefb
--- /dev/null
+++ b/_i18n/en/billing/billing-troubleshooting.md
@@ -0,0 +1,63 @@
+Start with **Settings → Billing** and select the same billing period shown on the invoice or payment record.
+
+## The amount is higher than expected
+
+Check these items separately:
+
+1. Confirm the active plan and agreement for the period.
+2. Review the usage summary and identify the highest Hellotext amount.
+3. Check whether attributed revenue increased after eligible purchases were recorded.
+4. Review SMS usage for the correct destination country and allowance.
+5. Confirm the non-SMS message volume used by the fair-use calculation.
+6. Review applicable taxes and separate Meta fees.
+
+Do not add the four Hellotext comparison amounts. Only the highest becomes the Hellotext amount for the period.
+
+## Attribution does not match a report
+
+Confirm that both views use the same date range, currency, and date basis. A playbook report can organize results by trigger date while another report can use a different event date.
+
+Use [How we attribute sales]({% link _analytics-reporting-attribution/sales-attribution.md %}) and [Data integrity and differences between reports]({% link _analytics-reporting-attribution/data-completeness-and-reporting-gaps.md %}) to reconcile the source data.
+
+## An invoice is not available
+
+Invoices appear after they are available for a billing period. Check the year and month selector in **Invoices** and confirm that the period has finished.
+
+If an older finalized period is missing, contact support with the business identifier and month.
+
+## A payment method failed
+
+- Confirm that the method is still valid and supports the account currency.
+- Add another method when **New payment method** is available.
+- Review the business balance when balance billing applies.
+- If Shopify is shown as the payment method, review the billing status in the connected Shopify account.
+
+Do not send card security codes or complete payment credentials to support.
+
+## A plan change is not reflected
+
+Open the current plan card and look for a scheduled-plan notice and effective date. Upgrades and downgrades can have different effective dates.
+
+Refresh Billing after a successful payment. If the status still does not match, provide support with the current plan, requested plan, confirmation time, and any visible error.
+
+## Currency or taxes look incorrect
+
+Open **Billing information** and verify the business country and tax details. Changing the country can affect tax treatment, currency, and available payment methods.
+
+Do not change the country only to alter a price. It should represent the business's correct billing location.
+
+## What to include in a support request
+
+- business or workspace identifier;
+- billing month and currency;
+- invoice or payment reference;
+- expected and displayed amounts;
+- screenshot of the relevant summary without sensitive payment data; and
+- the date and time of a failed payment or plan change.
+
+## Related guides
+
+- [Pricing model]({% link _billing/how-pricing-works.md %})
+- [Plan usage and monthly charges]({% link _billing/understanding-plan-quotas.md %})
+- [Billing settings, payment methods, and invoices]({% link _billing/billing-settings-and-invoices.md %})
+- [Change or cancel your plan]({% link _billing/change-or-cancel-your-plan.md %})
diff --git a/_i18n/en/billing/change-or-cancel-your-plan.md b/_i18n/en/billing/change-or-cancel-your-plan.md
new file mode 100644
index 0000000..a35bc57
--- /dev/null
+++ b/_i18n/en/billing/change-or-cancel-your-plan.md
@@ -0,0 +1,47 @@
+Use the plan controls in **Settings → Billing** to review a different plan or billing agreement.
+
+Before changing plans, compare the current public [Hellotext pricing page](https://www.hellotext.com/pricing) with the plan and agreement shown for your business.
+
+## Open the plan selector
+
+1. Open **Settings → Billing**.
+2. Find the current plan card.
+3. Select **Change plan**.
+4. Review the plan, monthly or yearly agreement, effective date, taxes, and amount shown before confirming.
+
+## Upgrade to a higher plan
+
+An upgrade can apply during the current billing period. When a prorated plan amount applies, Hellotext calculates it for the remaining portion of the period and shows the amount during the change flow.
+
+Confirm that the payment method or business balance can cover the amount. The new plan capabilities become available after the change succeeds.
+
+## Move to a lower plan
+
+A downgrade can be scheduled for a future billing period instead of removing current access immediately. After it is scheduled, the Billing page shows the target plan and effective date.
+
+Before confirming, review features that differ between the plans, including playbook access, AI agents, WhatsApp lines, reporting, activity history, support, and other limits shown in the plan comparison.
+
+If the interface offers **Cancel** beside a scheduled downgrade, use it to keep the current plan.
+
+## Cancel the subscription
+
+Hellotext allows cancellation without a long-term contract unless a separate agreement states otherwise. The subscription screen shows the date when cancellation takes effect.
+
+Before cancelling:
+
+- export any information your team needs to retain;
+- review active campaigns, playbooks, journeys, and channel activity;
+- confirm whether the account has pending usage or invoices; and
+- check any separate Meta, carrier, short-code, or enterprise agreement.
+
+Cancelling Hellotext does not automatically cancel a separate third-party agreement.
+
+## If the expected option is unavailable
+
+Plan and payment controls can differ by region, billing source, account permissions, or commercial agreement. Ask the business owner or an authorized administrator to try the change. Contact Hellotext support when the account is managed through a custom agreement or the expected option is not shown.
+
+## Related guides
+
+- [Billing settings, payment methods, and invoices]({% link _billing/billing-settings-and-invoices.md %})
+- [Plan usage and monthly charges]({% link _billing/understanding-plan-quotas.md %})
+- [Troubleshoot billing questions]({% link _billing/billing-troubleshooting.md %})
diff --git a/_i18n/en/billing/fair-use-message-policy.md b/_i18n/en/billing/fair-use-message-policy.md
new file mode 100644
index 0000000..ca210f5
--- /dev/null
+++ b/_i18n/en/billing/fair-use-message-policy.md
@@ -0,0 +1,43 @@
+Hellotext includes non-SMS messaging under a fair-use model. A variable messaging amount is calculated for the month, but it becomes the Hellotext charge only when it is higher than the plan minimum, performance fee, and SMS costs.
+
+## Which messages this covers
+
+The published variable rate covers messages sent through supported non-SMS channels such as WhatsApp, Webchat, Instagram Direct, Facebook Messenger, and Mercado Libre.
+
+SMS uses its own country and plan pricing. Meta fees for WhatsApp are also separate.
+
+## How the variable amount is calculated
+
+The current published rate is **US$2 per 1,000 non-SMS messages**. Hellotext calculates the amount from eligible message volume for the billing period.
+
+Use the public [Hellotext pricing page](https://www.hellotext.com/pricing) to confirm the current rate.
+
+## When it is charged
+
+Hellotext compares the variable messaging amount with:
+
+- the plan minimum;
+- the performance fee; and
+- SMS costs.
+
+If any of those three is higher, the variable messaging amount is not added. If the variable amount is the highest, it becomes the Hellotext charge for the month.
+
+### Example
+
+- Plan minimum: US$74
+- Performance fee: US$30
+- SMS costs: US$0
+- 50,000 eligible non-SMS messages: US$100 at the published rate
+
+The Hellotext charge is US$100 because the variable messaging amount is the highest. Hellotext does not add the other three amounts.
+
+## What this does not include
+
+The fair-use comparison does not remove applicable taxes or Meta's separate WhatsApp fees. Custom enterprise services can also follow their own agreement.
+
+## Related guides
+
+- [Pricing model]({% link _billing/how-pricing-works.md %})
+- [Meta fees for WhatsApp]({% link _billing/whatsapp-fees.md %})
+- [SMS pricing and sender types]({% link _billing/sms-pricing-and-number-types.md %})
+- [Plan usage and monthly charges]({% link _billing/understanding-plan-quotas.md %})
diff --git a/_i18n/en/billing/how-pricing-works.md b/_i18n/en/billing/how-pricing-works.md
index cb14275..4301184 100644
--- a/_i18n/en/billing/how-pricing-works.md
+++ b/_i18n/en/billing/how-pricing-works.md
@@ -1,191 +1,54 @@
-* **[Summary](#summary)**
-* **[How the model works](#how-the-model-works)**
-* **[Plans and what each includes](#plans-and-what-each-includes)**
-* **[AI‑powered messages (fair‑use policy)](#ai-powered-messages-fair-use-policy)**
-* **[SMS rates by country](#sms-rates-by-country)**
-* **[Attribution: what counts and the time window](#attribution-what-counts-and-time-window)**
-* **[Billing examples](#billing-examples)**
-* **[Frequently asked questions](#frequently-asked-questions)**
-
----
-
-## Summary
-
-Hellotext uses a results‑based model: you pay a **2% to 5%** performance fee on revenue attributed to campaigns, playbooks, routes, or eligible interactions. In the plans in this guide, Starter uses 5%, Small 4%, Grow 3%, and Pro 2.5%. Each plan has a monthly minimum (“floor”).
-
-**Key rule:** each month you pay only **one** line item—the highest of plan minimum, performance fee, SMS costs, or variable messaging fee (US$ 2 per 1,000). The four are never added together.
-
-
-
Important: WhatsApp costs from Meta are billed separately by Meta. Hellotext does not include them on your invoice.
Learn more.
-
-
-## How the model works
-
-* **Pay‑for‑results (2–5%)**: percentage applied to attributed revenue within the attribution window (see below).
-* **Platform floor**: the base price per plan that acts as the monthly minimum.
-* **Pay once (not four)**: we compare the plan floor, performance %, SMS, and the variable messaging fee; you pay the highest.
-
-## Plans and what each includes
-
-Channels on every plan: **WhatsApp** (Meta bills separately), **Instagram Direct**, **Facebook Messenger**, **Webchat**, **Mercado Libre**, and **SMS**. See pricing.
-
-
-
-
Starter
-
US$ 0/month
-
Performance: 5% on attributed revenue
-
- - Team: 1 member
- - Channels: WhatsApp (Meta billed separately), Instagram Direct, Facebook Messenger, Webchat, Mercado Libre, and SMS
- - WhatsApp: 1 verified line
- - Integrations: Wix, Shopify, Woo, Mercado Libre, and VTEX
- - Capture: Webchat, Popups, QR Code, and Forms
- - Automation: starter playbooks, route templates, and chat automation
- - Campaigns: SMS and WhatsApp
- - Reporting: basic real-time reporting
- - Profiles: unlimited customer profiles and templates
- - Playbooks: Some (limited)
- - Support: Standard email (≤ 24 business hours)
- - History: 2 months
-
-
-
-
-
Small
-
US$ 74/month US$ 67/month paid yearly
-
Performance: 4% from US$ 2,000 in attributed revenue
-
- - Team: Unlimited
- - Includes: Everything in Starter
- - Playbooks: 8 AI enabled eCommerce playbooks
- - Branding: remove Hellotext brand from Webchat and Forms
- - Links: use your domain name in short links
- - Reporting: advanced reporting
- - Operations: custom actions and conversation assignment
- - SMS: included according to country and plan
- - Support: Priority (email and WhatsApp, ≤ 8 business hours)
- - History: 6 months
-
-
-
-
-
Grow
-
US$ 299/month US$ 269/month paid yearly
-
Performance: 3% from US$ 10,000 in attributed revenue
-
- - Team: Unlimited plus AI agents
- - Includes: Everything in Small
- - Playbooks: 30 AI enabled eCommerce playbooks
- - WhatsApp: 2 verified lines
- - AI: 2 custom AI agents
- - Automation: HTTP Requests in Automations
- - Support: Account Manager (≤ 4 business hours)
- - History: Full
-
-
-
-
-
Pro
-
US$ 699/month
-
Performance: 2.5% from US$ 30,000 in attributed revenue
-
- - Includes: Everything in Grow
- - ERP: customer, order, and stock integration
- - Retail: 15 retail stores included
- - Retail AI: unlimited custom playbooks and AI agents
- - Teams: team visibility and advanced rules
- - Response: team response-time rules
- - APIs: custom agents with external API access
- - SMS: included
- - Support: Dedicated executive (≤ 2 business hours)
-
-
-
-
-Channels on every plan: WhatsApp (Meta bills separately), Instagram Direct, Facebook Messenger, Webchat, Mercado Libre, and SMS (see rates).
-
-Enterprise: plans for requirements of millions of SMS or WhatsApp deliveries, enterprise-level support, exclusive short codes, and 99.5% SLA.
-
-
-
-> **Upper plans:** Pro adds retail, ERP, and team capabilities; Enterprise covers custom enterprise volume and delivery requirements.
-
-## AI‑powered messages (fair‑use policy) {#ai-powered-messages-fair-use-policy}
-
-AI messages on WhatsApp, Instagram Direct, Facebook Messenger, and Webchat are included at no extra cost whenever **any** of the following three is **higher** than the variable fee:
-
-* **(a)** your plan minimum,
-* **(b)** your performance fee (2–5%)
-* **(c)** your SMS costs for the month.
-
-Only if **all three are lower** do we charge the variable fee of **US$ 2 per 1,000 messages** (**never** in addition to the other items). *(“Pay only the highest” rule).*
-
-## SMS rates by country
-
-Charged per message in local currency and vary by plan. They follow the same “pay only the highest” rule. See SMS rates.
-
-## Attribution: what counts and the time window {#attribution-what-counts-and-time-window}
-
-* Performance fees apply to revenue attributed under Hellotext's published methodology.
-* Hellotext evaluates eligible source evidence, source precedence, customer and order identity, and attribution windows. The model is not a universal last-click rule.
-* The default windows are 24 hours for eligible delivery or other passive evidence, and seven days from an eligible click or engagement. Account configuration can differ, and the two windows are not added together.
-* A recognized external marketing source takes precedence over Hellotext evidence. Team participation does not automatically remove attribution, and eligible custom monetary events are not excluded only because they were created manually.
-
-Attribution and incremental impact are measured separately.
-
-**[How we attribute sales]({% link _analytics-reporting-attribution/sales-attribution.md %})**
-
-## Billing examples
-
-**Scenario 1: Starter with strong performance**
-
-* Attributed revenue: **US$ 2,000** → 5% = **US$ 100**
-* Multichannel messages: **10,000** → **US$ 20** (variable)
-* SMS: **US$ 0**
-* Floor: **US$ 0**
- **You pay Hellotext:** **US$ 100** (highest). **WhatsApp (Meta):** billed separately.
-
-**Scenario 2: Small with low performance and high volume**
-
-* Performance % for the month: **US$ 30**
-* Multichannel messages: **50,000** → **US$ 100** (variable)
-* SMS: **US$ 0**
-* Small floor: **US$ 74**
- **You pay Hellotext:** **US$ 100** (the variable fee is **higher** than the floor, performance %, and SMS).
-
-**Scenario 3: SMS dominates (variable not charged)**
-
-* Performance %: **US$ 60**
-* Multichannel messages: **40,000** → **US$ 80** (variable)
-* **SMS for the month: US$ 150**
-* Small floor: **US$ 74**
- **You pay Hellotext:** **US$ 150** (SMS). *The variable fee is NOT added or charged because it’s not the highest.*
+Hellotext uses results-based pricing. Instead of adding every type of usage together, Hellotext compares the main billable amounts for the month and uses only the highest one as the Hellotext charge.
-**Scenario 4: Floor dominates (variable not charged)**
+Current plan prices, performance rates, SMS allowances, and included features can change. Use the public [Hellotext pricing page](https://www.hellotext.com/pricing) for the current plan comparison.
-* Performance %: **US$ 0**
-* Multichannel messages: **10,000** → **US$ 20** (variable)
-* SMS: **US$ 0**
-* **Small floor: US$ 74**
- **You pay Hellotext:** **US$ 74** (floor). *Variable does not apply.*
+## The four amounts Hellotext compares
-## Frequently asked questions
+For each billing period, Hellotext compares:
-**Are AI‑powered messages “unlimited”?**
+1. **Plan minimum:** the base amount for your selected plan and billing agreement.
+2. **Performance fee:** your plan rate applied to revenue attributed to Hellotext.
+3. **SMS costs:** billable SMS usage after any allowance that applies to your plan and country.
+4. **Variable messaging fee:** non-SMS messages billed at the published rate when this amount is higher than the other three.
-For most brands, yes in practice: each month you pay just one item—the highest among floor, performance %, SMS, or the variable fee. That means you won’t see a per‑message cost when the floor, performance, or SMS is higher than the variable fee. Only if all three are lower do we charge US$ 2 per 1,000 (never in addition to the others).
+The Hellotext charge is the highest of these four amounts. They are not added together.
-**Does WhatsApp appear on the Hellotext invoice?**
+## Example of the highest-only rule
-No. Meta bills WhatsApp separately; your Hellotext invoice follows the “pay only the highest” rule.
+Suppose the amounts for one month are:
+
+- Plan minimum: **US$100**
+- Performance fee: **US$180**
+- SMS costs: **US$45**
+- Variable messaging fee: **US$20**
+
+The Hellotext charge for that comparison is **US$180**, because the performance fee is the highest amount. It is not US$345.
+
+This example only explains the comparison. Your plan, country, currency, taxes, usage, and attributed revenue determine the actual invoice.
+
+## Charges outside the comparison
+
+The highest-only rule applies to the Hellotext amounts listed above. Other charges can still be separate:
+
+- **Applicable taxes** depend on your billing country and information.
+- **Meta fees for WhatsApp** are set by Meta and are separate from the Hellotext comparison.
+- Other services covered by a custom or enterprise agreement follow that agreement.
+
+## How attributed revenue affects billing
+
+Hellotext does not apply the performance rate to all store revenue. It applies to revenue attributed under the Hellotext attribution methodology and the rate associated with your plan.
+
+See [Performance fee calculation]({% link _billing/performance-fee-calculation.md %}) and [How we attribute sales]({% link _analytics-reporting-attribution/sales-attribution.md %}) for the two parts of that calculation.
+
+## Where to review your amount
+
+Open **Settings → Billing** to review your current plan, the usage summary for a billing period, balance and payment history, payment methods, billing information, and available invoices.
+
+See [Plan usage and monthly charges]({% link _billing/understanding-plan-quotas.md %}) for help reading the usage summary.
+
+## Related guides
+
+- [Fair-use message policy]({% link _billing/fair-use-message-policy.md %})
+- [SMS pricing and sender types]({% link _billing/sms-pricing-and-number-types.md %})
+- [Meta fees for WhatsApp]({% link _billing/whatsapp-fees.md %})
+- [Billing settings, payment methods, and invoices]({% link _billing/billing-settings-and-invoices.md %})
diff --git a/_i18n/en/billing/performance-fee-calculation.md b/_i18n/en/billing/performance-fee-calculation.md
new file mode 100644
index 0000000..84a0461
--- /dev/null
+++ b/_i18n/en/billing/performance-fee-calculation.md
@@ -0,0 +1,36 @@
+The performance fee connects the price of Hellotext to results attributed to Hellotext. The calculation uses two inputs: the revenue attributed during the billing period and the performance rate for your plan.
+
+## The calculation
+
+**Performance fee = attributed revenue × your plan rate**
+
+For example, if a business has US$4,000 in attributed revenue and its plan rate is 4%, the performance fee amount is US$160.
+
+Hellotext then compares that US$160 with the plan minimum, SMS costs, and the variable messaging fee. The highest amount becomes the Hellotext charge for the period.
+
+## Which revenue is included
+
+The calculation uses revenue attributed to Hellotext, not all revenue from your store.
+
+For each eligible order, the attribution engine considers source evidence, source precedence, customer and order identity, participation, and the applicable attribution window. A purchase that happens later can still be attributed when eligible Hellotext evidence falls within its window.
+
+Read [How we attribute sales]({% link _analytics-reporting-attribution/sales-attribution.md %}) for the complete customer-facing methodology.
+
+## Which rate applies
+
+The performance rate depends on the selected plan or commercial agreement. Plans can also use a threshold before the rate becomes the amount that exceeds the plan minimum.
+
+Use the public [Hellotext pricing page](https://www.hellotext.com/pricing) for current plan rates and thresholds. Use **Settings → Billing** to confirm the plan active for your business.
+
+## Why recent amounts can change
+
+An attributed purchase can happen after the original campaign, playbook, journey, delivery, signal, click, or engagement. Reports add the result according to the date model described in each report, while billing includes eligible attributed revenue for the applicable billing period.
+
+When reconciling an amount, compare the same date range and currency in Billing and in the relevant revenue or source report.
+
+## Related guides
+
+- [Pricing model]({% link _billing/how-pricing-works.md %})
+- [Sales attribution]({% link _analytics-reporting-attribution/sales-attribution.md %})
+- [Revenue report guide]({% link _analytics-reporting-attribution/revenue-report-guide.md %})
+- [Troubleshoot billing questions]({% link _billing/billing-troubleshooting.md %})
diff --git a/_i18n/en/billing/sms-pricing-and-number-types.md b/_i18n/en/billing/sms-pricing-and-number-types.md
new file mode 100644
index 0000000..18453cc
--- /dev/null
+++ b/_i18n/en/billing/sms-pricing-and-number-types.md
@@ -0,0 +1,43 @@
+SMS pricing depends on the destination country, the active plan, any SMS allowance included for that market, and billable messages beyond that allowance.
+
+Use the public [Hellotext pricing page](https://www.hellotext.com/pricing) and select the relevant country to see current plan allowances and extra-message rates.
+
+## How SMS enters the monthly calculation
+
+Hellotext calculates the SMS amount for the billing period and compares it with the plan minimum, performance fee, and variable non-SMS messaging amount.
+
+- If SMS is the highest amount, SMS becomes the Hellotext charge for that comparison.
+- If another Hellotext amount is higher, SMS is not added on top of it.
+
+Applicable taxes and services covered by a separate agreement can still appear separately.
+
+## Included SMS and extra SMS
+
+Some plan and country combinations include an SMS allowance. Messages beyond that allowance use the published extra-message rate.
+
+Do not assume that an allowance shown for one country applies to another. Select the country where messages will be delivered and review the active plan.
+
+## Approved senders and short codes
+
+The sender available to a business depends on the country and account setup. Hellotext can send through approved senders or shared short codes where supported.
+
+An exclusive short code is dedicated to one business and is intended for higher-volume or dedicated-sender requirements. It can require a separate commercial agreement and provisioning process.
+
+See [Exclusive short codes]({% link _numbers/exclusive-short-codes.md %}) for operational details. Availability and current commercial conditions must be confirmed with Hellotext for the target country.
+
+## Before estimating an SMS campaign
+
+Confirm:
+
+- destination country or countries;
+- current plan and included SMS allowance;
+- estimated recipient count and number of sends;
+- whether message length or encoding can create more than one SMS segment; and
+- whether the business needs an approved shared sender or an exclusive short code.
+
+## Related guides
+
+- [Pricing model]({% link _billing/how-pricing-works.md %})
+- [Plan usage and monthly charges]({% link _billing/understanding-plan-quotas.md %})
+- [Messaging channels overview]({% link _numbers/messaging-overview.md %})
+- [SMS sending limits for new businesses]({% link _troubleshooting-deliverability/sms-sending-limits-for-new-businesses.md %})
diff --git a/_i18n/en/billing/understanding-plan-quotas.md b/_i18n/en/billing/understanding-plan-quotas.md
index 8c07e2a..57da0de 100644
--- a/_i18n/en/billing/understanding-plan-quotas.md
+++ b/_i18n/en/billing/understanding-plan-quotas.md
@@ -1,100 +1,54 @@
-* **[What we measure each month](#what-we-measure-each-month)**
-* **[Billing components](#billing-components)**
-* **[Billing formula](#billing-formula)**
-* **[Calculation examples](#calculation-examples)**
-* **[How to read your invoice](#how-to-read-your-invoice)**
-* **[Frequently asked questions](#frequently-asked-questions)**
+Use the Billing usage summary to understand what happened in a billing period before reconciling an invoice.
-## What we measure each month
+## Open the usage summary
-We apply a single rule: you pay only the highest amount among these four items for the month (they are not added together):
+1. Open **Settings → Billing**.
+2. Find the card for your current plan.
+3. In **Usage summary**, select the billing period you want to review.
-1. **Plan minimum**
-2. **Performance fee** (**2–5%**) on attributed revenue
-3. **SMS costs** (depending on country/plan)
-4. **Variable messaging fee** (**US$ 2/1,000**) — only if it is higher than the other three
+The plan card shows the active plan and access to **Change plan**. The usage summary shows the billable activity recorded for the selected period.
-## Billing components
+## Read the comparison
-### 1) Performance fee (2–5%)
+Hellotext can calculate four monthly amounts:
-% applied to revenue attributed to Hellotext messages, campaigns, playbooks, routes, or eligible interactions. Plan breakpoints: **5%** (Starter), **4%** from **US$ 2,000** (Small), **3%** from **US$ 10,000** (Grow), **2.5%** from **US$ 30,000** (Pro), and **2%** from **US$ 100,000** (Enterprise).
+- plan minimum;
+- performance fee from attributed revenue;
+- SMS costs; and
+- variable non-SMS messaging amount.
-> **Attribution:** Hellotext evaluates eligible source evidence and source precedence. The default windows are 24 hours for eligible delivery or other passive evidence, and seven days from an eligible click or engagement. Account configuration can differ. See [How we attribute sales]({% link _analytics-reporting-attribution/sales-attribution.md %}).
+The Hellotext charge uses only the highest amount. Use the summary to identify which component is leading for the selected period.
-### 2) Multichannel AI messages (fair‑use)
+Read [Pricing model]({% link _billing/how-pricing-works.md %}) for the complete rule.
-Included at no extra cost when **plan minimum**, **performance %**, or **SMS** are higher than the variable fee. If all are lower, US$ 2 per 1,000 messages applies. Never both: we bill the highest.
+## Compare the correct period
-### 3) SMS by country
+Choose the same month when comparing Billing with a report or invoice. Keep these differences in mind:
-Per‑message costs in local currency; they follow the “pay only the highest” rule. See the table in [Pricing explanation](https://www.hellotext.com/pricing#sms) for current values.
+- A recent period can still receive eligible attributed purchases before it is finalized.
+- Reports can organize metrics by trigger, send, interaction, or purchase date depending on the report.
+- Billing uses the applicable billing period and account currency.
-### 4) Plan minimum
+When attribution is the leading amount, use the revenue and source reports to investigate the underlying results rather than comparing unrelated date columns.
-Monthly minimum for the plan. If the other items are lower, you pay the minimum; if any one is higher, you pay that.
+## Review balance and payment history
-## Billing formula
+The Billing page also shows the business balance and a **Payment history** control. Select the relevant year and period to review recorded balance activity and charges.
-*Monthly Hellotext charge = max { Plan minimum, Performance fee,
-SMS costs, Variable fee (US$ 2/1,000) }*
+Balance activity and the monthly usage comparison answer different questions:
-
-Note: the variable fee only applies if it is the highest for the month; it is not added to any other item.
-
+- Usage explains how the monthly Hellotext amount was determined.
+- Payment history explains movements recorded against the business balance.
-## Calculation examples
+## Review older periods
-**Scenario 1: Month with strong performance (Starter)**
+The usage-period selector can include active and previous plan periods. When the business changed plans, confirm which plan was active in the month being reviewed.
-* Attributed revenue: **US$ 2,000** → 5% = **US$ 100**
-* Multichannel messages: **10,000** → **US$ 20** (variable)
-* SMS: **US$ 0**
-* Floor: **US$ 0**
- **You pay Hellotext:** **US$ 100** (highest). **WhatsApp (Meta):** billed separately.
+Use the invoice for the finalized billed amount and the usage summary for its operational context.
-**Scenario 2: Low performance and high volume month (Small)**
+## Related guides
-* Performance %: **US$ 30**
-* Multichannel messages: **50,000** → **US$ 100** (variable)
-* SMS: **US$ 0**
-* Small floor: **US$ 74**
- **You pay Hellotext:** **US$ 100** (the variable is the highest).
-
-**Scenario 3: SMS dominates**
-
-* Performance %: **US$ 60**
-* Multichannel messages: **40,000** → **US$ 80** (variable)
-* **SMS: US$ 150**
-* Small floor: **US$ 74**
- **You pay Hellotext:** **US$ 150** (SMS). *Variable does not apply.*
-
-**Scenario 4: Floor dominates**
-
-* Performance %: **US$ 0**
-* Multichannel messages: **10,000** → **US$ 20** (variable)
-* SMS: **US$ 0**
-* **Small floor: US$ 74**
- **You pay Hellotext:** **US$ 74** (floor). *Variable does not apply.*
-
-## How to read your invoice
-
-* **Billed item:** you will see one of the four (floor / performance / SMS / variable fee).
-* **WhatsApp (Meta):** appears on your Meta invoice, not on Hellotext’s.
-* **Volume detail:** the activity panel shows messages sent and attributed revenue for the period.
-
-## Frequently asked questions
-
-**What are sales attributed to Hellotext?**
-
-They are sales that meet Hellotext's published attribution methodology. The decision uses eligible evidence, source precedence, customer and order identity, and the applicable default window: 24 hours for eligible delivery or passive evidence, or seven days from an eligible click or engagement. A recognized external marketing source takes precedence. See [How we attribute sales]({% link _analytics-reporting-attribution/sales-attribution.md %}).
-
-**Where can I see SMS rates and available countries?**
-
-In the SMS rates by country table in [Pricing explanation](https://www.hellotext.com/precios).
-
-They are charged in local currency and follow the highest‑only rule.
-
-**What does each plan include besides price?**
-
-Members, playbooks access, support levels, and activity history, plus advanced features on higher plans (Grow/Pro/Enterprise).
+- [Billing settings, payment methods, and invoices]({% link _billing/billing-settings-and-invoices.md %})
+- [Performance fee calculation]({% link _billing/performance-fee-calculation.md %})
+- [Revenue report guide]({% link _analytics-reporting-attribution/revenue-report-guide.md %})
+- [Troubleshoot billing questions]({% link _billing/billing-troubleshooting.md %})
diff --git a/_i18n/en/billing/whatsapp-fees.md b/_i18n/en/billing/whatsapp-fees.md
new file mode 100644
index 0000000..9afe325
--- /dev/null
+++ b/_i18n/en/billing/whatsapp-fees.md
@@ -0,0 +1,49 @@
+WhatsApp has two separate cost layers when you use it through Hellotext:
+
+1. the Hellotext pricing model for platform, performance, SMS, and eligible non-SMS message usage; and
+2. WhatsApp Business Platform fees defined by Meta.
+
+Meta fees are separate from the Hellotext highest-only comparison.
+
+## What Meta controls
+
+Meta determines which WhatsApp messages are billable and the applicable rate. The amount can depend on factors such as the recipient's country, the message category, and Meta's current pricing rules.
+
+Because Meta can change its categories and rates, use the official [WhatsApp Business Platform pricing page](https://business.whatsapp.com/products/platform-pricing) for current values.
+
+## What Hellotext controls
+
+Hellotext applies its own pricing model to the Hellotext service. Eligible WhatsApp message volume can be part of the non-SMS variable messaging amount, but that amount is charged only when it is the highest Hellotext amount for the month.
+
+This does not replace or absorb Meta fees.
+
+## How to estimate the complete cost
+
+Review both parts:
+
+- Use **Settings → Billing** for your Hellotext plan, usage, and invoices.
+- Use your Meta billing information and Meta's current rate table for WhatsApp fees.
+- Confirm the business country, recipient markets, and expected message categories used in the estimate.
+
+Do not add all four Hellotext pricing components together. First apply the Hellotext highest-only rule, then consider applicable taxes and separate Meta fees.
+
+## Common questions
+
+**Are Meta fees included in the plan minimum?**
+
+No. They are separate from the Hellotext pricing comparison.
+
+**Does fair use mean WhatsApp has no Meta cost?**
+
+No. Fair use determines whether Hellotext's variable non-SMS amount becomes the Hellotext charge. It does not change Meta's WhatsApp pricing.
+
+**Why can two businesses have different WhatsApp costs?**
+
+Recipient countries, message mix, and Meta pricing can differ. Compare the same period and categories when reconciling costs.
+
+## Related guides
+
+- [Pricing model]({% link _billing/how-pricing-works.md %})
+- [Fair-use message policy]({% link _billing/fair-use-message-policy.md %})
+- [Billing settings, payment methods, and invoices]({% link _billing/billing-settings-and-invoices.md %})
+- [WhatsApp setup and fundamentals]({% link _numbers/whatsapp-channel-fundamentals.md %})
diff --git a/_i18n/en/journeys/replenishment-driver-playbook.md b/_i18n/en/journeys/replenishment-driver-playbook.md
index c10b916..c9057cf 100644
--- a/_i18n/en/journeys/replenishment-driver-playbook.md
+++ b/_i18n/en/journeys/replenishment-driver-playbook.md
@@ -1,6 +1,6 @@
Use this guide when customers buy products that run out, wear down, or need to be replaced on a predictable cycle.
-Replenishment Driver is an active retention playbook. It helps Hellotext remind customers to reorder around the moment they may need the product again, using product usage data, purchase history, customer behavior, channel eligibility, and send checks.
+Replenishment Driver is an active retention playbook. It helps Hellotext remind customers to reorder around the moment they may need the product again. Hellotext estimates that cadence automatically using AI, product repurchase history across the business, and the individual customer's behavior. The business can also provide an optional explicit duration with the highest priority.
It is not a generic win-back campaign and it is not a cart recovery flow. It starts after a purchase and focuses on repeat orders for products where timing matters.
@@ -11,9 +11,10 @@ Replenishment Driver helps customers reorder before the product runs out.
It can:
- React after a customer buys a replenishable product.
-- Use product-level usage data, such as `usage_duration_days`, when available.
-- Use product-family defaults or average reorder patterns when a product-specific value is missing.
-- Learn from the customer's own purchase cycle when enough history exists.
+- Estimate with AI how long a product may take to be consumed.
+- Improve the estimate with aggregate repurchase history for that product across the business.
+- Personalize it with the customer's own cycle when enough reliable history exists.
+- Use an optional explicit value, such as `usage_duration_days`, as the highest-priority source when the business defines one.
- Schedule a reminder near the estimated refill window.
- Include a reorder link, product link, or discount when those options are available and configured.
- Skip, wait, or stop when the customer already reordered, the product is not eligible, another playbook is a better owner, or the customer cannot be reached.
@@ -30,9 +31,9 @@ It is a good fit for products such as:
- Coffee, tea, food, pet food, or household staples.
- Skin care, beauty, or personal care products.
- Refills, replacement parts, filters, or consumable accessories.
-- Any product family where your team knows a reasonable usage window.
+- Any replenishable product whose duration can be estimated from AI or history, even when your team has not configured a manual window.
-It works best when Hellotext can see order history, product identity, quantity, and a refill timing signal for the SKU or product family.
+It works best when Hellotext can see order history, product identity, and quantity. You do not need to enter a duration manually for every product before using it.
Do not use it for products that are usually bought once and kept for a long time. For related product suggestions after a purchase, use [Cross-Sell Driver]({% link _journeys/cross-sell-driver-playbook.md %}). For customers who have gone cold across the brand, use a reactivation playbook. For customers who have not bought yet, use [First-Purchase Driver]({% link _journeys/first-purchase-driver-playbook.md %}).
@@ -45,12 +46,13 @@ Check that:
- Your store, ERP, or data source sends order and purchase history to Hellotext.
- Products, variants, SKUs, names, and links match your catalog.
- Replenishable products are identifiable by product, SKU, category, or product family.
-- Usage windows are available, such as a `usage_duration_days` value, product-family default, or internal average.
-- Purchase dates and quantities are reliable enough to estimate when a customer may need more.
+- Purchase dates, product identity, and quantities are reliable enough for Hellotext to evaluate a repurchase cadence.
- Reorder links, product links, prices, stock, and optional discount rules are current.
- The channel the playbook can use is connected and ready.
- Customers have consent and are eligible for the channel.
+> **Important:** `usage_duration_days` is optional. Hellotext first tries to estimate duration automatically using AI, business-level product history, and customer history. Set an explicit value only when your business knows a more accurate duration and wants it to take priority over the automatic estimates.
+
For setup validation, use [Verify your data and signals after setup]({% link _integrations/verify-data-and-signals.md %}). For custom tracking, use [Tracking events]({% link _developers/tracking-events.md %}).
After launch, use the automatically generated reports to review scheduled, sent, skipped, clicked, reordered, and attributed outcomes.
@@ -67,18 +69,22 @@ The playbook exposes the settings that control how it communicates:
Keep automatic channel selection unless you have a clear reason to limit the playbook. Replenishment Driver depends on whether the customer can actually be reached when the refill window arrives.
-Product usage duration and replenishment eligibility come from product data, purchase history, and Hellotext's internal scoring. They are inputs to the decision, not reminder-schedule controls on the playbook.
+Product usage duration and replenishment eligibility come from AI analysis and purchase history. If your catalog supports `usage_duration_days`, you can use it as an optional explicit input. It is not a control for manually scheduling the message: it is a higher-authority source that replaces the estimated cadence for that product.
## How timing works
Replenishment timing is an estimate, not proof that the customer has run out.
-Hellotext can use several levels of signal:
+Hellotext evaluates these sources from lowest to highest authority:
+
+| Priority | Source | How it is used |
+| --- | --- | --- |
+| 1 | AI estimate | Estimates the product's consumption days. High or medium confidence is considered reliable; low or unknown confidence can still be used but is less reliable. |
+| 2 | Business history | Uses a reliable aggregate repurchase cadence for that exact product across the business and blends it with the AI estimate when available. |
+| 3 | Customer history | Uses the customer's reliable personal repurchase cadence and blends it with the business result. |
+| 4, highest and optional | Explicit value | A positive `usage_duration_days` set by the business immediately overrides every other source for that product, even when the AI estimate classifies it as non-consumable. |
-- A product setting, such as `usage_duration_days`, when your team knows how long a product usually lasts.
-- A product-family or category default when a specific product does not have its own value.
-- Average reorder behavior from customers who bought the same product.
-- The customer's own repeat-purchase pattern when enough history exists.
+The explicit value is the final priority level, not the first prerequisite. If no source produces a positive number of days, Hellotext treats the cadence as unavailable and does not force a reminder.
The playbook then calculates when a reminder makes sense before the estimated refill point. Hellotext handles that delivery timing automatically rather than asking you to schedule each reminder.
@@ -132,7 +138,8 @@ Use test customer profiles that have channel consent, then:
- Place a test order with a replenishable product.
- Confirm the order and product appear on the customer profile.
-- Confirm the product has a usage window, product-family default, or enough purchase history to estimate one.
+- Confirm Hellotext can estimate a cadence from AI, business-level product history, or customer history.
+- If you configured `usage_duration_days`, confirm it is positive, reasonable, and should override the automatic estimates.
- Confirm the order and product create an eligible replenishment opportunity.
- Test a customer who reorders before the reminder, which should prevent or update the replenishment follow-up.
- Test a non-replenishable product that should be excluded.
@@ -150,7 +157,7 @@ The playbook may wait, skip, stop, or let another playbook act when:
- Purchase history is missing, delayed, or not tied to a usable customer profile.
- The product is not marked or recognized as replenishable.
-- Usage duration, product-family defaults, or average reorder data are missing.
+- No AI estimate, aggregate product history, customer history, or explicit value produces a usable positive cadence.
- The customer already reordered.
- The product is unavailable, discontinued, out of stock, or missing a usable link.
- The profile cannot be reached in an eligible channel.
@@ -167,7 +174,7 @@ During the first days, review:
- Which products and product families created eligible replenishment moments.
- Which reminders were scheduled, sent, delayed, skipped, or blocked.
-- Which products had missing or suspicious usage windows.
+- Which products had no positive cadence available or produced an estimate worth reviewing.
- Clicks, repeat purchases, attributed revenue, opt-outs, replies, and failed messages.
- Whether discounts increased repeat orders or reduced margin.
- Whether Replenishment Driver overlaps with [Cross-Sell Driver]({% link _journeys/cross-sell-driver-playbook.md %}), reactivation, or campaigns.
diff --git a/_i18n/es/billing/billing-overview.md b/_i18n/es/billing/billing-overview.md
index 63a4391..7a4c1be 100644
--- a/_i18n/es/billing/billing-overview.md
+++ b/_i18n/es/billing/billing-overview.md
@@ -1,46 +1,42 @@
-Usa esta sección para entender cómo funcionan en conjunto los planes, consumos, ingresos atribuidos y reglas de facturación de Hellotext.
-
-La mayoría de las dudas de facturación empiezan con una de estas preguntas:
-
-- ¿Qué incluye mi plan?
-- ¿Qué consumo cuenta para mi factura mensual?
-- ¿Por qué se atribuyó una venta a Hellotext?
+Usa esta sección para entender qué cobra Hellotext, por qué aparece un monto determinado y dónde administrar la facturación de tu negocio.
## Empieza por el modelo de precios
-Hellotext usa un modelo de precios basado en resultados. Según tu plan y uso, el cargo mensual de Hellotext se basa en el concepto de facturación más alto del período.
-
-Sigue leyendo: [Modelo de precios]({% link _billing/how-pricing-works.md %}).
+Hellotext compara el piso del plan, la tarifa por rendimiento, los costos de SMS y el monto variable por mensajes que no son SMS. Solo el mayor de esos cuatro se convierte en el monto de Hellotext para el período.
-Para precios actuales de planes y tablas de tarifas SMS, revisa siempre la página pública de [precios de Hellotext](https://www.hellotext.com/precios).
+Lee [Modelo de precios]({% link _billing/how-pricing-works.md %}) antes de intentar sumar consumos individuales.
-## Revisa uso y consumos del plan
+Los precios actuales, funcionalidades incluidas, tarifas y cantidades de SMS por país están en la página pública de [precios de Hellotext](https://www.hellotext.com/precios).
-Tu plan determina qué está incluido, qué uso se mide y cómo se calcula la actividad mensual.
+## Entiende los ingresos atribuidos
-Usa la guía de consumos del plan cuando necesites entender mínimos del plan, tarifas por performance, costos SMS, tarifas variables por mensajes y cómo aparecen en tus facturas.
+La tarifa por rendimiento usa ingresos atribuidos a Hellotext, no todos los ingresos de la tienda.
-Sigue leyendo: [Uso y consumos del plan]({% link _billing/understanding-plan-quotas.md %}).
+- [Cálculo de la tarifa por rendimiento]({% link _billing/performance-fee-calculation.md %}) explica el cálculo de facturación.
+- [Cómo atribuimos ventas]({% link _analytics-reporting-attribution/sales-attribution.md %}) explica qué pedidos y evidencias son elegibles.
-## Entiende la atribución
+## Entiende los costos de mensajería
-Los ingresos atribuidos importan porque pueden afectar la facturación basada en resultados y los reportes.
+La mensajería tiene tres conceptos diferentes:
-Usa la guía de atribución cuando necesites entender precedencia de fuentes, evidencia elegible, ventanas de atribución, participación del equipo, cambios de pedidos compatibles y por qué una venta fue o no atribuida a Hellotext.
+- [Política de fair use para mensajes]({% link _billing/fair-use-message-policy.md %}) explica cuándo el volumen elegible de mensajes que no son SMS se convierte en el monto de Hellotext.
+- [Precios de SMS y tipos de remitente]({% link _billing/sms-pricing-and-number-types.md %}) explica tarifas por país, cantidades incluidas y opciones de remitente.
+- [Tarifas de Meta para WhatsApp]({% link _billing/whatsapp-fees.md %}) explica los costos separados definidos por Meta.
-Sigue leyendo: [Atribución de ventas]({% link _analytics-reporting-attribution/sales-attribution.md %}).
+## Revisa consumos y facturas
-## Límites SMS para negocios nuevos
+Abre **Configuración → Facturación** para ver tu plan actual, consumos por período, saldo, historial de pagos, métodos de pago, datos de facturación y facturas disponibles.
-Algunos negocios prepago nuevos comienzan con un límite temporal de envío SMS mientras Hellotext revisa la calidad de los envíos.
+- [Uso del plan y cargos mensuales]({% link _billing/understanding-plan-quotas.md %}) te ayuda a interpretar un período seleccionado.
+- [Facturación, métodos de pago y facturas]({% link _billing/billing-settings-and-invoices.md %}) explica cada control de facturación.
-Usa la guía de límites SMS cuando los mensajes SMS estén bloqueados por un límite diario temporal, o cuando necesites entender cómo funciona el período de revisión.
+## Cambia el plan o resuelve un problema
-Sigue leyendo: [Límites de envío SMS para negocios nuevos]({% link _troubleshooting-deliverability/sms-sending-limits-for-new-businesses.md %}).
+- [Cambiar o cancelar tu plan]({% link _billing/change-or-cancel-your-plan.md %}) explica cambios a planes superiores, cambios programados a planes inferiores y cancelaciones.
+- [Solucionar dudas de facturación]({% link _billing/billing-troubleshooting.md %}) incluye una lista para conciliar montos y los datos que debes enviar a soporte.
## Guías relacionadas
+- [Guía del reporte de ingresos]({% link _analytics-reporting-attribution/revenue-report-guide.md %})
- [Resumen de canales de mensajería]({% link _numbers/messaging-overview.md %})
-- [Reportes de campaña]({% link _analytics-reporting-attribution/campaign-reporting.md %})
-- [Resumen de audiencia y segmentación]({% link _audience/audience-overview.md %})
-- [Resumen de configuración e integraciones]({% link _integrations/setup-overview.md %})
+- [Límites de envío SMS para negocios nuevos]({% link _troubleshooting-deliverability/sms-sending-limits-for-new-businesses.md %})
diff --git a/_i18n/es/billing/billing-settings-and-invoices.md b/_i18n/es/billing/billing-settings-and-invoices.md
new file mode 100644
index 0000000..3c15c2a
--- /dev/null
+++ b/_i18n/es/billing/billing-settings-and-invoices.md
@@ -0,0 +1,54 @@
+Abre **Configuración → Facturación** para administrar la información de facturación de tu negocio. La página reúne tu plan, consumos, saldo, historial de pagos, métodos de pago, datos de facturación y facturas disponibles.
+
+## Plan actual y consumos
+
+Las primeras tarjetas muestran el plan activo y el resumen de consumos. Usa **Cambiar plan** para revisar otros planes y selecciona un período en el resumen para consultar la actividad facturable.
+
+Consulta [Uso del plan y cargos mensuales]({% link _billing/understanding-plan-quotas.md %}) para interpretar la comparación.
+
+## Saldo e historial de pagos
+
+El área de saldo muestra los fondos disponibles para el negocio cuando aplica la facturación mediante saldo. Abre **Historial de pagos** y selecciona un año o período para revisar los movimientos registrados.
+
+El historial de pagos no reemplaza la factura. Úsalo para rastrear movimientos de saldo y consulta la factura como documento final del período.
+
+## Métodos de pago
+
+La sección **Métodos de pago** muestra los métodos disponibles para el negocio. Según el origen del negocio y la región, puede incluir una tarjeta guardada, facturación mediante Shopify u otro acuerdo compatible.
+
+Cuando la interfaz lo permita, usa **Nuevo método de pago** para agregar una tarjeta. Mantén al menos un método válido antes de habilitar consumos pagos o cambiar a un plan pago.
+
+La página pública de precios menciona tarjetas principales y transferencias bancarias según la región. La página de Facturación de tu negocio es la fuente de verdad sobre los métodos disponibles actualmente para esa cuenta.
+
+## Datos de facturación y país
+
+Usa **Datos de facturación** para agregar la información legal o fiscal que debe acompañar los registros de facturación.
+
+El país del negocio afecta el tratamiento de impuestos y puede afectar la moneda y los métodos de pago disponibles. Usa **Cambiar país** con cuidado y confirma el aviso fiscal mostrado por Hellotext antes de guardar.
+
+## Ver una factura
+
+1. Abre **Configuración → Facturación**.
+2. Busca **Facturas**.
+3. Selecciona el año y mes que quieres revisar.
+4. Abre la factura disponible.
+
+Las facturas aparecen cuando están disponibles para el período de facturación. Si un mes todavía no aparece, confirma que el período haya finalizado.
+
+## Antes de contactar a soporte
+
+Ten preparados estos datos:
+
+- identificador del negocio o espacio de trabajo;
+- mes y moneda de la factura;
+- línea o monto por el que consultas;
+- período correspondiente del resumen de consumos; y
+- cualquier error de pago mostrado en la interfaz.
+
+No envíes números completos de tarjetas, códigos de seguridad ni credenciales bancarias.
+
+## Guías relacionadas
+
+- [Modelo de precios]({% link _billing/how-pricing-works.md %})
+- [Cambiar o cancelar tu plan]({% link _billing/change-or-cancel-your-plan.md %})
+- [Solucionar dudas de facturación]({% link _billing/billing-troubleshooting.md %})
diff --git a/_i18n/es/billing/billing-troubleshooting.md b/_i18n/es/billing/billing-troubleshooting.md
new file mode 100644
index 0000000..303e432
--- /dev/null
+++ b/_i18n/es/billing/billing-troubleshooting.md
@@ -0,0 +1,63 @@
+Empieza en **Configuración → Facturación** y selecciona el mismo período que aparece en la factura o registro de pago.
+
+## El monto es mayor de lo esperado
+
+Revisa estos elementos por separado:
+
+1. Confirma el plan y acuerdo activos durante el período.
+2. Revisa el resumen de consumos e identifica el monto mayor de Hellotext.
+3. Comprueba si los ingresos atribuidos aumentaron después de registrar compras elegibles.
+4. Revisa el uso de SMS para el país de destino y la cantidad incluida correctos.
+5. Confirma el volumen de mensajes que no son SMS usado por el cálculo de fair use.
+6. Revisa los impuestos aplicables y las tarifas separadas de Meta.
+
+No sumes los cuatro montos comparados por Hellotext. Solo el mayor se convierte en el monto de Hellotext para el período.
+
+## La atribución no coincide con un reporte
+
+Confirma que ambas vistas usen el mismo rango de fechas, moneda y base temporal. Un reporte de playbooks puede organizar resultados por fecha de activación, mientras otro reporte puede usar una fecha de evento diferente.
+
+Usa [Cómo atribuimos ventas]({% link _analytics-reporting-attribution/sales-attribution.md %}) e [Integridad de datos y diferencias entre reportes]({% link _analytics-reporting-attribution/data-completeness-and-reporting-gaps.md %}) para conciliar los datos de origen.
+
+## Una factura no está disponible
+
+Las facturas aparecen cuando están disponibles para un período de facturación. Revisa el selector de año y mes en **Facturas** y confirma que el período haya terminado.
+
+Si falta un período anterior ya finalizado, contacta a soporte con el identificador del negocio y el mes.
+
+## Falló un método de pago
+
+- Confirma que el método siga vigente y admita la moneda de la cuenta.
+- Agrega otro método cuando esté disponible **Nuevo método de pago**.
+- Revisa el saldo del negocio cuando aplique la facturación mediante saldo.
+- Si Shopify aparece como método de pago, revisa el estado de facturación en la cuenta de Shopify conectada.
+
+No envíes códigos de seguridad de tarjetas ni credenciales completas de pago a soporte.
+
+## No se refleja un cambio de plan
+
+Abre la tarjeta del plan actual y busca un aviso de cambio programado y su fecha efectiva. Los cambios a planes superiores e inferiores pueden tener fechas efectivas diferentes.
+
+Actualiza Facturación después de completar correctamente el pago. Si el estado todavía no coincide, informa a soporte el plan actual, plan solicitado, hora de confirmación y cualquier error visible.
+
+## La moneda o los impuestos parecen incorrectos
+
+Abre **Datos de facturación** y verifica el país del negocio y los datos fiscales. Cambiar el país puede afectar el tratamiento de impuestos, la moneda y los métodos de pago disponibles.
+
+No cambies el país solo para modificar un precio. Debe representar la ubicación de facturación correcta del negocio.
+
+## Qué incluir en una solicitud de soporte
+
+- identificador del negocio o espacio de trabajo;
+- mes y moneda de facturación;
+- referencia de factura o pago;
+- monto esperado y monto mostrado;
+- captura del resumen correspondiente sin datos sensibles de pago; y
+- fecha y hora de un pago o cambio de plan fallido.
+
+## Guías relacionadas
+
+- [Modelo de precios]({% link _billing/how-pricing-works.md %})
+- [Uso del plan y cargos mensuales]({% link _billing/understanding-plan-quotas.md %})
+- [Facturación, métodos de pago y facturas]({% link _billing/billing-settings-and-invoices.md %})
+- [Cambiar o cancelar tu plan]({% link _billing/change-or-cancel-your-plan.md %})
diff --git a/_i18n/es/billing/change-or-cancel-your-plan.md b/_i18n/es/billing/change-or-cancel-your-plan.md
new file mode 100644
index 0000000..a03d5f0
--- /dev/null
+++ b/_i18n/es/billing/change-or-cancel-your-plan.md
@@ -0,0 +1,47 @@
+Usa los controles del plan en **Configuración → Facturación** para revisar otro plan o acuerdo de facturación.
+
+Antes de cambiar, compara la página pública actual de [precios de Hellotext](https://www.hellotext.com/precios) con el plan y acuerdo mostrados para tu negocio.
+
+## Abrir el selector de planes
+
+1. Abre **Configuración → Facturación**.
+2. Busca la tarjeta del plan actual.
+3. Selecciona **Cambiar plan**.
+4. Revisa el plan, acuerdo mensual o anual, fecha efectiva, impuestos y monto mostrados antes de confirmar.
+
+## Subir a un plan superior
+
+Un cambio a un plan superior puede aplicar durante el período de facturación actual. Cuando corresponde un monto prorrateado, Hellotext lo calcula para la parte restante del período y lo muestra durante el flujo de cambio.
+
+Confirma que el método de pago o saldo del negocio pueda cubrir el monto. Las capacidades del nuevo plan quedan disponibles después de completar correctamente el cambio.
+
+## Pasar a un plan inferior
+
+Un cambio a un plan inferior puede programarse para un período futuro en lugar de quitar el acceso actual inmediatamente. Después de programarlo, la página de Facturación muestra el plan de destino y la fecha efectiva.
+
+Antes de confirmar, revisa las funcionalidades que cambian entre los planes, como acceso a playbooks, agentes de IA, líneas de WhatsApp, reportes, historial de actividad, soporte y otros límites mostrados en la comparación.
+
+Si la interfaz muestra **Cancelar** junto al cambio programado, úsalo para conservar el plan actual.
+
+## Cancelar la suscripción
+
+Hellotext permite cancelar sin un contrato de largo plazo, salvo que un acuerdo separado indique lo contrario. La pantalla de suscripción muestra la fecha en que la cancelación se hará efectiva.
+
+Antes de cancelar:
+
+- exporta la información que tu equipo necesite conservar;
+- revisa campañas, playbooks, rutas y actividad de canales activos;
+- confirma si la cuenta tiene consumos o facturas pendientes; y
+- revisa cualquier acuerdo separado con Meta, operadoras, códigos cortos o servicios empresariales.
+
+Cancelar Hellotext no cancela automáticamente un acuerdo separado con terceros.
+
+## Si no aparece la opción esperada
+
+Los controles de plan y pago pueden variar según la región, el origen de facturación, los permisos de la cuenta o el acuerdo comercial. Pide al propietario del negocio o a un administrador autorizado que intente el cambio. Contacta a soporte de Hellotext cuando la cuenta esté administrada mediante un acuerdo personalizado o no aparezca la opción esperada.
+
+## Guías relacionadas
+
+- [Facturación, métodos de pago y facturas]({% link _billing/billing-settings-and-invoices.md %})
+- [Uso del plan y cargos mensuales]({% link _billing/understanding-plan-quotas.md %})
+- [Solucionar dudas de facturación]({% link _billing/billing-troubleshooting.md %})
diff --git a/_i18n/es/billing/fair-use-message-policy.md b/_i18n/es/billing/fair-use-message-policy.md
new file mode 100644
index 0000000..9e2795b
--- /dev/null
+++ b/_i18n/es/billing/fair-use-message-policy.md
@@ -0,0 +1,43 @@
+Hellotext incluye los mensajes que no son SMS mediante un modelo de fair use. Se calcula un monto variable para el mes, pero solo se convierte en el cargo de Hellotext cuando supera al piso del plan, la tarifa por rendimiento y los costos de SMS.
+
+## Qué mensajes incluye
+
+La tarifa variable publicada cubre mensajes enviados por canales compatibles que no son SMS, como WhatsApp, Webchat, Mensajes Directos de Instagram, Facebook Messenger y Mercado Libre.
+
+Los SMS usan precios propios según el país y el plan. Las tarifas de Meta para WhatsApp también se cobran por separado.
+
+## Cómo se calcula el monto variable
+
+La tarifa publicada actual es de **US$2 por cada 1.000 mensajes que no son SMS**. Hellotext calcula el monto según el volumen de mensajes elegibles del período de facturación.
+
+Consulta la página pública de [precios de Hellotext](https://www.hellotext.com/precios) para confirmar la tarifa vigente.
+
+## Cuándo se cobra
+
+Hellotext compara el monto variable por mensajes con:
+
+- el piso del plan;
+- la tarifa por rendimiento; y
+- los costos de SMS.
+
+Si alguno de esos tres es mayor, el monto variable no se suma. Si el monto variable es el mayor, se convierte en el cargo de Hellotext para el mes.
+
+### Ejemplo
+
+- Piso del plan: US$74
+- Tarifa por rendimiento: US$30
+- Costos de SMS: US$0
+- 50.000 mensajes elegibles que no son SMS: US$100 con la tarifa publicada
+
+El cargo de Hellotext es US$100 porque el monto variable por mensajes es el mayor. Hellotext no suma los otros tres montos.
+
+## Qué no incluye
+
+La comparación de fair use no elimina los impuestos aplicables ni las tarifas separadas de Meta para WhatsApp. Los servicios empresariales personalizados también pueden seguir su propio acuerdo.
+
+## Guías relacionadas
+
+- [Modelo de precios]({% link _billing/how-pricing-works.md %})
+- [Tarifas de Meta para WhatsApp]({% link _billing/whatsapp-fees.md %})
+- [Precios de SMS y tipos de remitente]({% link _billing/sms-pricing-and-number-types.md %})
+- [Uso del plan y cargos mensuales]({% link _billing/understanding-plan-quotas.md %})
diff --git a/_i18n/es/billing/how-pricing-works.md b/_i18n/es/billing/how-pricing-works.md
index 4cbefe8..83f9db5 100644
--- a/_i18n/es/billing/how-pricing-works.md
+++ b/_i18n/es/billing/how-pricing-works.md
@@ -1,193 +1,54 @@
-- **[Resumen](#resumen)**
-- **[Cómo funciona el modelo](#cómo-funciona-el-modelo)**
-- **[Planes y qué incluye cada uno](#planes-y-qué-incluye-cada-uno)**
-- **[Mensajes con IA (política de fair‑use)](#mensajes-con-ia-política-de-fairuse)**
-- **[Tarifas de SMS por país](#tarifas-de-sms-por-país)**
-- **[Atribución: qué cuenta y en qué ventana](#atribución-qué-cuenta-y-en-qué-ventana)**
-- **[Ejemplos de facturación](#ejemplos-de-facturación)**
-- **[Preguntas frecuentes](#preguntas-frecuentes)**
-
----
-
-## Resumen
-
-Hellotext usa un modelo basado en resultados: pagas una tarifa por performance de **2 % a 5 %** sobre los ingresos atribuidos a campañas, playbooks, rutas o interacciones elegibles. En los planes de esta guía, Starter usa 5 %, Small 4 %, Grow 3 % y Pro 2,5 %. Cada plan tiene un mínimo mensual (“piso”).
-
-**Regla clave:** cada mes pagas un solo concepto—el mayor entre piso del plan, tarifa por performance, costo de SMS o tarifa variable por mensajes (US $ 2 por cada 1.000). Nunca se suman los cuatro.
-
-
-
-
Importante: los costos de WhatsApp de Meta se cobran por separado por Meta. Hellotext no los incluye en tu factura.
Más información.
-
-
-## Cómo funciona el modelo
-
-* **Pay‑for‑results (2–5 %)**: % aplicado a ingresos atribuidos dentro de la ventana de atribución (ver más abajo).
-* **Piso de plataforma**: precio base por plan que actúa como mínimo mensual.
-* **Pagas una sola vez (no cuatro)**: se compara piso, % performance, SMS y tarifa variable por mensajes; abonas el mayor.
-
-## Planes y qué incluye cada uno
-
-Canales en todos los planes: **WhatsApp** (Meta factura aparte), **Instagram Direct**, **Facebook Messenger**, **Webchat**, **Mercado Libre** y **SMS**. Ver tarifas.
-
-
-
-
Starter
-
US$ 0/mes
-
Performance: 5% sobre ingresos atribuidos
-
- - Equipo: 1 miembro
- - Canales: WhatsApp (Meta aparte), Instagram Direct, Facebook Messenger, Webchat, Mercado Libre y SMS
- - WhatsApp: 1 línea verificada
- - Integraciones: Wix, Shopify, Woo, Mercado Libre y VTEX
- - Captura: Webchat, Popups, Código QR y Formularios
- - Automatización: playbooks iniciales, plantillas de rutas y automatización de chat
- - Campañas: SMS y WhatsApp
- - Reportes: básicos en tiempo real
- - Perfiles: ilimitados y plantillas
- - Playbooks: Algunos (limitado)
- - Soporte: Email estándar (≤ 24 h hábiles)
- - Historial: 2 meses
-
-
-
-
-
Small
-
US$ 74/mes US$ 67/mes con pago anual
-
Performance: 4% desde US$ 2.000 atribuidos
-
- - Equipo: Ilimitado
- - Incluye: Todo lo de Starter
- - Playbooks: 8 de eCommerce con IA
- - Marca: remueve la marca Hellotext de Webchat y Formularios
- - Links: usa el nombre de tu dominio en enlaces cortos
- - Reportes: avanzados
- - Operación: custom actions y asignación de conversaciones
- - SMS: incluidos según país y plan
- - Soporte: Prioridad (email y WhatsApp, ≤ 8 h hábiles)
- - Historial: 6 meses
-
-
-
-
-
Grow
-
US$ 299/mes US$ 269/mes con pago anual
-
Performance: 3% desde US$ 10.000 atribuidos
-
- - Equipo: Ilimitado y agentes de IA
- - Incluye: Todo lo de Small
- - Playbooks: 30 de eCommerce con IA
- - WhatsApp: 2 líneas verificadas
- - IA: 2 agentes personalizados
- - Automatización: HTTP Requests en Automatizaciones
- - Soporte: Account Manager (≤ 4 h hábiles)
- - Historial: Completo
-
-
-
-
-
Pro
-
US$ 699/mes
-
Performance: 2,5% desde US$ 30.000 atribuidos
-
- - Incluye: Todo lo de Grow
- - ERP: integración de clientes, compras y stock
- - Retail: 15 tiendas físicas incluidas
- - IA para tiendas: playbooks y agentes personalizados ilimitados
- - Equipos: visibilidad por equipo y reglas avanzadas
- - Respuesta: reglas de tiempo de respuesta para equipos
- - APIs: agentes personalizados con acceso a APIs externas
- - SMS: incluidos
- - Soporte: Ejecutivo dedicado (≤ 2 h hábiles)
-
-
-
-
-
-Canales en todos los planes: WhatsApp (Meta factura aparte), Instagram Direct, Facebook Messenger, Webchat, Mercado Libre y SMS (ver tarifas).
-
-Enterprise: planes para requerimientos de millones de envíos de SMS o WhatsApp, soporte empresarial, códigos cortos exclusivos y SLA 99,5%.
-
-
-
-> **Planes superiores:** Pro suma capacidades para retail, ERP y equipos; Enterprise cubre volúmenes y requerimientos empresariales personalizados.
-
-## Mensajes con IA (política de fair‑use)
-
-Los mensajes con IA en WhatsApp, Instagram Direct, Facebook Messenger y Webchat están incluidos sin costo siempre que cualquiera de estos tres sea mayor que la tarifa variable:
-
-* **(a)** tu piso de plan,
-* **(b)** tu tarifa por performance (2–5 %)
-* **(c)** tus costos de SMS del mes.
-
-Solo si los tres son menores, se cobra la tarifa variable de US $ 2 por cada 1.000 mensajes (nunca además de los otros conceptos). *(Regla “pagas solo el mayor”)*.
-
-## Tarifas de SMS por país
-
-Se cobran por mensaje en moneda local y varían según el plan. Participan en la misma regla de “pagas solo el mayor”. Ver tarifas SMS.
-
-## Atribución: qué cuenta y en qué ventana
-
-* Las tarifas por performance se aplican a los ingresos atribuidos según la metodología publicada de Hellotext.
-* Hellotext evalúa evidencia de origen elegible, precedencia de fuentes, identidad del cliente y del pedido, y ventanas de atribución. El modelo no es una regla universal de último clic.
-* Las ventanas por defecto son de 24 horas para una entrega elegible u otra evidencia pasiva, y de siete días desde un clic o interacción elegible. La configuración de la cuenta puede ser diferente y las dos ventanas no se suman.
-* Una fuente de marketing externa reconocida tiene precedencia sobre la evidencia de Hellotext. La participación del equipo no elimina automáticamente la atribución y los eventos monetarios personalizados elegibles no se excluyen solo por haber sido creados manualmente.
-
-La atribución y el impacto incremental se miden por separado.
-
-**[Cómo atribuimos las ventas]({% link _analytics-reporting-attribution/sales-attribution.md %})**
-
-## Ejemplos de facturación
-
-**Escenario 1: Starter con buen performance**
-
-* Ingresos atribuidos: **US$ 2.000** → 5 % = **US$ 100**
-* Mensajes multicanal: **10.000** → **US$ 20** (variable)
-* SMS: **US$ 0**
-* Piso: **US$ 0**
- **Pagas a Hellotext:** **US$ 100** (mayor). **WhatsApp (Meta):** aparte.
-
-**Escenario 2: Small con poco performance y alto volumen**
-
-* % performance del mes: **US$ 30**
-* Mensajes multicanal: **50.000** → **US$ 100** (variable)
-* SMS: **US$ 0**
-* Piso Small: **US$ 74**
- **Pagas a Hellotext:** **US$ 100** (la variable **supera** al piso, al % performance y al SMS).
+Hellotext usa un modelo de precios basado en resultados. En lugar de sumar todos los tipos de consumo, compara los principales montos facturables del mes y usa solamente el mayor como cargo de Hellotext.
-**Escenario 3: SMS domina (variable no se cobra)**
+Los precios, tarifas por rendimiento, SMS incluidos y funcionalidades de cada plan pueden cambiar. Consulta la página pública de [precios de Hellotext](https://www.hellotext.com/precios) para ver la comparación vigente.
-* % performance: **US$ 60**
-* Mensajes multicanal: **40.000** → **US$ 80** (variable)
-* **SMS del mes: US$ 150**
-* Piso Small: **US$ 74**
- **Pagas a Hellotext:** **US$ 150** (SMS). *La tarifa variable NO se suma ni se cobra porque no es la mayor.*
+## Los cuatro montos que compara Hellotext
-**Escenario 4: Piso domina (variable no se cobra)**
+En cada período de facturación, Hellotext compara:
-* % performance: **US$ 0**
-* Mensajes multicanal: **10.000** → **US$ 20** (variable)
-* SMS: **US$ 0**
-* **Piso Small: US$ 74**
- **Pagas a Hellotext:** **US$ 74** (piso). *La variable no aplica.*
+1. **Piso del plan:** el monto base del plan y acuerdo de facturación seleccionados.
+2. **Tarifa por rendimiento:** la tarifa de tu plan aplicada a los ingresos atribuidos a Hellotext.
+3. **Costos de SMS:** el uso facturable de SMS después de lo incluido para tu plan y país.
+4. **Cargo variable por mensajes:** los mensajes que no son SMS, calculados con la tarifa publicada cuando este monto supera a los otros tres.
-## Preguntas frecuentes
+El cargo de Hellotext es el mayor de estos cuatro montos. No se suman entre sí.
-**¿Los mensajes con IA son “ilimitados”?**
+## Ejemplo de la regla de pagar solo el mayor
-Para la mayoría, sí en la práctica: cada mes pagas un solo concepto—el mayor entre piso, % performance, SMS o tarifa variable. Eso significa que no verás costo por mensaje cuando piso, performance o SMS sean mayores que la variable. Solo si los tres son menores, cobramos US $ 2 por cada 1.000 (nunca además de los otros).
+Supongamos que los montos de un mes son:
-**¿WhatsApp aparece en la factura de Hellotext?**
+- Piso del plan: **US$100**
+- Tarifa por rendimiento: **US$180**
+- Costos de SMS: **US$45**
+- Cargo variable por mensajes: **US$20**
-No. Meta factura WhatsApp por separado; tu factura de Hellotext se rige por la regla de “pagas solo el mayor”.
+El cargo de Hellotext para esa comparación es **US$180**, porque la tarifa por rendimiento es el monto mayor. No es US$345.
+
+Este ejemplo solo explica la comparación. Tu plan, país, moneda, impuestos, consumos e ingresos atribuidos determinan la factura real.
+
+## Cargos fuera de la comparación
+
+La regla de pagar solo el mayor aplica a los montos de Hellotext anteriores. Otros cargos pueden cobrarse por separado:
+
+- Los **impuestos aplicables** dependen del país y de tus datos de facturación.
+- Las **tarifas de Meta para WhatsApp** son definidas por Meta y no forman parte de la comparación de Hellotext.
+- Otros servicios incluidos en un acuerdo personalizado o empresarial siguen las condiciones de ese acuerdo.
+
+## Cómo afectan los ingresos atribuidos
+
+Hellotext no aplica la tarifa por rendimiento a todos los ingresos de la tienda. La aplica a los ingresos atribuidos según la metodología de Hellotext y la tarifa asociada a tu plan.
+
+Consulta [Cálculo de la tarifa por rendimiento]({% link _billing/performance-fee-calculation.md %}) y [Cómo atribuimos ventas]({% link _analytics-reporting-attribution/sales-attribution.md %}) para entender ambas partes del cálculo.
+
+## Dónde revisar el monto
+
+Abre **Configuración → Facturación** para revisar tu plan actual, el resumen de consumos de un período, saldo e historial de pagos, métodos de pago, datos de facturación y facturas disponibles.
+
+Consulta [Uso del plan y cargos mensuales]({% link _billing/understanding-plan-quotas.md %}) para interpretar el resumen de consumos.
+
+## Guías relacionadas
+
+- [Política de fair use para mensajes]({% link _billing/fair-use-message-policy.md %})
+- [Precios de SMS y tipos de remitente]({% link _billing/sms-pricing-and-number-types.md %})
+- [Tarifas de Meta para WhatsApp]({% link _billing/whatsapp-fees.md %})
+- [Facturación, métodos de pago y facturas]({% link _billing/billing-settings-and-invoices.md %})
diff --git a/_i18n/es/billing/performance-fee-calculation.md b/_i18n/es/billing/performance-fee-calculation.md
new file mode 100644
index 0000000..569810f
--- /dev/null
+++ b/_i18n/es/billing/performance-fee-calculation.md
@@ -0,0 +1,36 @@
+La tarifa por rendimiento conecta el precio de Hellotext con los resultados atribuidos a Hellotext. El cálculo usa dos datos: los ingresos atribuidos durante el período de facturación y la tarifa correspondiente a tu plan.
+
+## El cálculo
+
+**Tarifa por rendimiento = ingresos atribuidos × tarifa de tu plan**
+
+Por ejemplo, si un negocio tiene US$4.000 en ingresos atribuidos y la tarifa de su plan es 4 %, el monto por rendimiento es US$160.
+
+Luego Hellotext compara esos US$160 con el piso del plan, los costos de SMS y el cargo variable por mensajes. El monto mayor se convierte en el cargo de Hellotext para el período.
+
+## Qué ingresos se incluyen
+
+El cálculo usa ingresos atribuidos a Hellotext, no todos los ingresos de tu tienda.
+
+Para cada pedido elegible, el motor de atribución considera la evidencia de origen, la precedencia de fuentes, la identidad del cliente y del pedido, la participación y la ventana de atribución aplicable. Una compra posterior puede atribuirse cuando existe evidencia elegible de Hellotext dentro de su ventana.
+
+Lee [Cómo atribuimos ventas]({% link _analytics-reporting-attribution/sales-attribution.md %}) para conocer la metodología completa orientada al cliente.
+
+## Qué tarifa aplica
+
+La tarifa por rendimiento depende del plan o acuerdo comercial seleccionado. Los planes también pueden tener un umbral antes de que la tarifa se convierta en un monto superior al piso del plan.
+
+Consulta la página pública de [precios de Hellotext](https://www.hellotext.com/precios) para ver tarifas y umbrales vigentes. Usa **Configuración → Facturación** para confirmar el plan activo de tu negocio.
+
+## Por qué pueden cambiar los montos recientes
+
+Una compra atribuida puede ocurrir después de la campaña, playbook, ruta, entrega, señal, clic o interacción original. Los reportes agregan el resultado según el modelo de fechas explicado en cada reporte, mientras que la facturación incluye los ingresos atribuidos elegibles para el período correspondiente.
+
+Para conciliar un monto, compara el mismo rango de fechas y moneda en Facturación y en el reporte de ingresos o de la fuente correspondiente.
+
+## Guías relacionadas
+
+- [Modelo de precios]({% link _billing/how-pricing-works.md %})
+- [Atribución de ventas]({% link _analytics-reporting-attribution/sales-attribution.md %})
+- [Guía del reporte de ingresos]({% link _analytics-reporting-attribution/revenue-report-guide.md %})
+- [Solucionar dudas de facturación]({% link _billing/billing-troubleshooting.md %})
diff --git a/_i18n/es/billing/sms-pricing-and-number-types.md b/_i18n/es/billing/sms-pricing-and-number-types.md
new file mode 100644
index 0000000..65516dc
--- /dev/null
+++ b/_i18n/es/billing/sms-pricing-and-number-types.md
@@ -0,0 +1,43 @@
+El precio de los SMS depende del país de destino, el plan activo, los SMS incluidos para ese mercado y los mensajes facturables que superen esa cantidad.
+
+Consulta la página pública de [precios de Hellotext](https://www.hellotext.com/precios) y selecciona el país correspondiente para ver los SMS incluidos y las tarifas vigentes por mensajes adicionales.
+
+## Cómo entran los SMS en el cálculo mensual
+
+Hellotext calcula el monto de SMS del período de facturación y lo compara con el piso del plan, la tarifa por rendimiento y el monto variable por mensajes que no son SMS.
+
+- Si SMS es el monto mayor, se convierte en el cargo de Hellotext para esa comparación.
+- Si otro monto de Hellotext es mayor, los SMS no se suman por encima de ese monto.
+
+Los impuestos aplicables y los servicios cubiertos por un acuerdo separado pueden aparecer por separado.
+
+## SMS incluidos y SMS adicionales
+
+Algunas combinaciones de plan y país incluyen una cantidad de SMS. Los mensajes que superan esa cantidad usan la tarifa publicada por mensaje adicional.
+
+No asumas que la cantidad incluida para un país aplica a otro. Selecciona el país donde se entregarán los mensajes y revisa el plan activo.
+
+## Remitentes aprobados y códigos cortos
+
+El remitente disponible para un negocio depende del país y de la configuración de la cuenta. Hellotext puede enviar mediante remitentes aprobados o códigos cortos compartidos donde estén disponibles.
+
+Un código corto exclusivo está dedicado a un solo negocio y está pensado para requisitos de mayor volumen o de remitente dedicado. Puede requerir un acuerdo comercial y un proceso de aprovisionamiento separados.
+
+Consulta [Códigos cortos exclusivos]({% link _numbers/exclusive-short-codes.md %}) para conocer los detalles operativos. La disponibilidad y las condiciones comerciales vigentes deben confirmarse con Hellotext para el país de destino.
+
+## Antes de estimar una campaña de SMS
+
+Confirma:
+
+- el país o los países de destino;
+- el plan actual y la cantidad de SMS incluida;
+- la cantidad estimada de destinatarios y envíos;
+- si la longitud o codificación del mensaje puede producir más de un segmento SMS; y
+- si el negocio necesita un remitente compartido aprobado o un código corto exclusivo.
+
+## Guías relacionadas
+
+- [Modelo de precios]({% link _billing/how-pricing-works.md %})
+- [Uso del plan y cargos mensuales]({% link _billing/understanding-plan-quotas.md %})
+- [Resumen de canales de mensajería]({% link _numbers/messaging-overview.md %})
+- [Límites de envío SMS para negocios nuevos]({% link _troubleshooting-deliverability/sms-sending-limits-for-new-businesses.md %})
diff --git a/_i18n/es/billing/understanding-plan-quotas.md b/_i18n/es/billing/understanding-plan-quotas.md
index c423a7d..ef77fd4 100644
--- a/_i18n/es/billing/understanding-plan-quotas.md
+++ b/_i18n/es/billing/understanding-plan-quotas.md
@@ -1,100 +1,54 @@
-- **[Qué medimos cada mes](#qué-medimos-cada-mes)**
-- **[Componentes de facturación](#componentes-de-facturación)**
-- **[Fórmula de facturación](#fórmula-de-facturación)**
-- **[Ejemplos de cálculo](#ejemplos-de-cálculo)**
-- **[Cómo leer tu factura](#cómo-leer-tu-factura)**
-- **[Preguntas frecuentes](#preguntas-frecuentes)**
+Usa el resumen de consumos de Facturación para entender qué ocurrió en un período antes de conciliar una factura.
-## Qué medimos cada mes
+## Abrir el resumen de consumos
-Aplicamos una regla única: pagas solo el monto mayor entre estos cuatro conceptos del mes (no se suman):
+1. Abre **Configuración → Facturación**.
+2. Busca la tarjeta de tu plan actual.
+3. En **Resumen de consumos**, selecciona el período que quieres revisar.
-1. **Piso del plan**
-2. **Tarifa por performance** (**2–5 %**) sobre ingresos atribuidos
-3. **Costo de SMS** (según país/plan)
-4. **Tarifa variable por mensajes** (**US $ 2/1.000**) — solo si es mayor a los tres anteriores
+La tarjeta muestra el plan activo y el acceso a **Cambiar plan**. El resumen muestra la actividad facturable registrada para el período seleccionado.
-## Componentes de facturación
+## Interpretar la comparación
-### 1) Tarifa por performance (2–5 %)
+Hellotext puede calcular cuatro montos mensuales:
-% aplicado a ingresos atribuidos a mensajes, campañas, playbooks, rutas o interacciones elegibles de Hellotext. Escalas por plan: **5 %** (Starter), **4 %** desde **US$ 2.000** (Small), **3 %** desde **US$ 10.000** (Grow), **2,5 %** desde **US$ 30.000** (Pro) y **2 %** desde **US$ 100.000** (Enterprise).
+- piso del plan;
+- tarifa por rendimiento sobre ingresos atribuidos;
+- costos de SMS; y
+- monto variable por mensajes que no son SMS.
-> **Atribución:** Hellotext evalúa evidencia de origen elegible y precedencia de fuentes. Las ventanas por defecto son de 24 horas para una entrega elegible u otra evidencia pasiva, y de siete días desde un clic o interacción elegible. La configuración de la cuenta puede ser diferente. Consulta [Cómo atribuimos las ventas]({% link _analytics-reporting-attribution/sales-attribution.md %}).
+El cargo de Hellotext usa solamente el monto mayor. Usa el resumen para identificar qué componente lidera en el período seleccionado.
-### 2) Mensajes multicanal con IA (fair‑use)
+Lee [Modelo de precios]({% link _billing/how-pricing-works.md %}) para conocer la regla completa.
-Incluidos sin costo cuando **piso**, **% performance** o **SMS** son mayores que la tarifa variable. Si todos son menores, se aplica US $ 2 por cada 1.000 mensajes. Nunca se cobran ambos: se factura el mayor.
+## Comparar el período correcto
-### 3) SMS por país
+Elige el mismo mes cuando compares Facturación con un reporte o una factura. Ten en cuenta estas diferencias:
-Costos por mensaje en moneda local; participan de la regla “pagas solo el mayor”. Ver tabla en [Explicación de tarifas](https://www.hellotext.com/precios#sms) para valores vigentes.
+- Un período reciente todavía puede recibir compras atribuidas elegibles antes de finalizarse.
+- Los reportes pueden organizar métricas por fecha de activación, envío, interacción o compra, según el reporte.
+- Facturación usa el período de facturación aplicable y la moneda de la cuenta.
-### 4) Piso del plan
+Cuando la atribución es el monto principal, usa los reportes de ingresos y por fuente para investigar los resultados subyacentes en lugar de comparar columnas de fechas diferentes.
-Mínimo mensual del plan. Si el resto de los conceptos es menor, pagas el piso; si alguno es mayor, pagas ese.
+## Revisar saldo e historial de pagos
-## Fórmula de facturación
+La página de Facturación también muestra el saldo del negocio y un control de **Historial de pagos**. Selecciona el año y período correspondientes para revisar los movimientos de saldo y cargos registrados.
-_Cargo Hellotext del mes = máx { Piso del plan, Tarifa por performance,
-Costo de SMS, Tarifa variable (US$ 2/1.000) }_
+Los movimientos de saldo y la comparación mensual responden preguntas diferentes:
-
-Nota: la tarifa variable solo aplica si es la mayor del mes; no se suma a ningún otro concepto.
-
+- El resumen de consumos explica cómo se determinó el monto mensual de Hellotext.
+- El historial de pagos explica los movimientos registrados en el saldo del negocio.
-## Ejemplos de cálculo
+## Revisar períodos anteriores
-**Escenario 1: Mes con buen performance (Starter)**
+El selector de períodos puede incluir períodos del plan actual y de planes anteriores. Si el negocio cambió de plan, confirma cuál estaba activo durante el mes revisado.
-* Ingresos atribuidos: **US$ 2.000** → 5 % = **US$ 100**
-* Mensajes multicanal: **10.000** → **US$ 20** (variable)
-* SMS: **US$ 0**
-* Piso: **US$ 0**
- **Pagas a Hellotext:** **US$ 100** (mayor). **WhatsApp (Meta):** aparte.
+Usa la factura para consultar el monto facturado final y el resumen de consumos para entender su contexto operativo.
-**Escenario 2: Mes de poco performance y alto volumen (Small)**
+## Guías relacionadas
-* % performance: **US$ 30**
-* Mensajes multicanal: **50.000** → **US$ 100** (variable)
-* SMS: **US$ 0**
-* Piso Small: **US$ 74**
- **Pagas a Hellotext:** **US$ 100** (la variable es la mayor).
-
-**Escenario 3: SMS domina**
-
-* % performance: **US$ 60**
-* Mensajes multicanal: **40.000** → **US$ 80** (variable)
-* **SMS: US$ 150**
-* Piso Small: **US$ 74**
- **Pagas a Hellotext:** **US$ 150** (SMS). *Variable no aplica.*
-
-**Escenario 4: Piso domina**
-
-* % performance: **US$ 0**
-* Mensajes multicanal: **10.000** → **US$ 20** (variable)
-* SMS: **US$ 0**
-* **Piso Small: US$ 74**
- **Pagas a Hellotext:** **US$ 74** (piso). *Variable no aplica.*
-
-## Cómo leer tu factura
-
-* **Concepto cobrado:** verás uno de los cuatro (piso / performance / SMS / tarifa variable).
-* **WhatsApp (Meta):** figura en tu factura de Meta, no en la de Hellotext.
-* **Detalle de volumen:** el panel de actividad muestra mensajes enviados e ingresos atribuidos del período.
-
-## Preguntas frecuentes
-
-**¿Qué son las ventas atribuidas a Hellotext?**
-
-Son las ventas que cumplen la metodología de atribución publicada de Hellotext. La decisión usa evidencia elegible, precedencia de fuentes, identidad del cliente y del pedido, y la ventana por defecto aplicable: 24 horas para una entrega elegible o evidencia pasiva, o siete días desde un clic o interacción elegible. Una fuente de marketing externa reconocida tiene precedencia. Consulta [Cómo atribuimos las ventas]({% link _analytics-reporting-attribution/sales-attribution.md %}).
-
-**¿Dónde veo las tarifas de SMS y los países disponibles?**
-
-En la tabla de Tarifas de SMS por país de [Explicación de tarifas](https://www.hellotext.com/precios).
-
-Se cobran en moneda local y entran en la regla del monto mayor.
-
-**¿Qué incluye cada plan además del precio?**
-
-Miembros, acceso a playbooks, niveles de soporte y historial de actividad, más funciones avanzadas en planes superiores (Grow/Pro/Enterprise).
+- [Facturación, métodos de pago y facturas]({% link _billing/billing-settings-and-invoices.md %})
+- [Cálculo de la tarifa por rendimiento]({% link _billing/performance-fee-calculation.md %})
+- [Guía del reporte de ingresos]({% link _analytics-reporting-attribution/revenue-report-guide.md %})
+- [Solucionar dudas de facturación]({% link _billing/billing-troubleshooting.md %})
diff --git a/_i18n/es/billing/whatsapp-fees.md b/_i18n/es/billing/whatsapp-fees.md
new file mode 100644
index 0000000..6e1ea43
--- /dev/null
+++ b/_i18n/es/billing/whatsapp-fees.md
@@ -0,0 +1,49 @@
+WhatsApp tiene dos capas de costos separadas cuando lo usas mediante Hellotext:
+
+1. el modelo de precios de Hellotext para la plataforma, rendimiento, SMS y uso elegible de mensajes que no son SMS; y
+2. las tarifas de la Plataforma de WhatsApp Business definidas por Meta.
+
+Las tarifas de Meta no forman parte de la comparación de pagar solo el monto mayor de Hellotext.
+
+## Qué controla Meta
+
+Meta determina qué mensajes de WhatsApp son facturables y qué tarifa aplica. El monto puede depender de factores como el país del destinatario, la categoría del mensaje y las reglas de precios vigentes de Meta.
+
+Como Meta puede cambiar sus categorías y tarifas, consulta la página oficial de [precios de la Plataforma de WhatsApp Business](https://business.whatsapp.com/products/platform-pricing) para ver los valores actuales.
+
+## Qué controla Hellotext
+
+Hellotext aplica su propio modelo de precios al servicio de Hellotext. El volumen elegible de mensajes de WhatsApp puede formar parte del monto variable por mensajes que no son SMS, pero ese monto solo se cobra cuando es el mayor monto de Hellotext del mes.
+
+Esto no reemplaza ni absorbe las tarifas de Meta.
+
+## Cómo estimar el costo completo
+
+Revisa ambas partes:
+
+- Usa **Configuración → Facturación** para consultar tu plan, consumos y facturas de Hellotext.
+- Usa tus datos de facturación de Meta y la tabla vigente de Meta para las tarifas de WhatsApp.
+- Confirma el país del negocio, los mercados de destino y las categorías de mensajes esperadas en la estimación.
+
+No sumes los cuatro componentes de precios de Hellotext. Primero aplica la regla de Hellotext de pagar solo el mayor y luego considera los impuestos aplicables y las tarifas separadas de Meta.
+
+## Preguntas frecuentes
+
+**¿Las tarifas de Meta están incluidas en el piso del plan?**
+
+No. Se cobran por separado de la comparación de precios de Hellotext.
+
+**¿Fair use significa que WhatsApp no tiene costos de Meta?**
+
+No. Fair use determina si el monto variable de Hellotext por mensajes que no son SMS se convierte en el cargo de Hellotext. No modifica los precios de WhatsApp definidos por Meta.
+
+**¿Por qué dos negocios pueden tener costos distintos de WhatsApp?**
+
+Los países de destino, la combinación de mensajes y los precios de Meta pueden ser diferentes. Compara el mismo período y las mismas categorías al conciliar los costos.
+
+## Guías relacionadas
+
+- [Modelo de precios]({% link _billing/how-pricing-works.md %})
+- [Política de fair use para mensajes]({% link _billing/fair-use-message-policy.md %})
+- [Facturación, métodos de pago y facturas]({% link _billing/billing-settings-and-invoices.md %})
+- [Configuración y conceptos básicos de WhatsApp]({% link _numbers/whatsapp-channel-fundamentals.md %})
diff --git a/_i18n/es/journeys/replenishment-driver-playbook.md b/_i18n/es/journeys/replenishment-driver-playbook.md
index 044713f..0db6494 100644
--- a/_i18n/es/journeys/replenishment-driver-playbook.md
+++ b/_i18n/es/journeys/replenishment-driver-playbook.md
@@ -1,6 +1,6 @@
Usa esta guía cuando los clientes compran productos que se consumen, se gastan o necesitan reponerse en un ciclo predecible.
-Impulsor de Recompra es un playbook activo de retención. Ayuda a Hellotext a recordar a los clientes que repongan cerca del momento en que podrían necesitar el producto otra vez, usando datos de uso del producto, historial de pedidos, comportamiento del cliente, elegibilidad de canal y chequeos de envío.
+Impulsor de Recompra es un playbook activo de retención. Ayuda a Hellotext a recordar a los clientes que repongan cerca del momento en que podrían necesitar el producto otra vez. Hellotext estima esa cadencia automáticamente mediante IA, historial de recompra del producto en el negocio y comportamiento individual del cliente. El negocio también puede definir una duración explícita opcional con máxima prioridad.
No es una campaña genérica de reactivación y no es recuperación de carrito. Empieza después de una compra y se enfoca en nuevos pedidos para productos donde el timing importa.
@@ -11,9 +11,10 @@ Impulsor de Recompra ayuda a que los clientes vuelvan a comprar antes de quedars
Puede:
- Reaccionar después de que un cliente compra un producto reponible.
-- Usar datos de uso a nivel producto, como `usage_duration_days`, cuando están disponibles.
-- Usar valores por defecto de familia de producto o patrones promedio de recompra cuando falta un valor específico del producto.
-- Aprender del ciclo propio del cliente cuando hay suficiente historial.
+- Estimar con IA cuánto podría tardar en consumirse un producto.
+- Mejorar la estimación con el historial agregado de recompra de ese producto en el negocio.
+- Personalizarla con el ciclo propio del cliente cuando existe suficiente historial confiable.
+- Usar un valor explícito opcional, como `usage_duration_days`, como la fuente de mayor prioridad cuando el negocio lo define.
- Programar un recordatorio cerca de la ventana estimada de reposición.
- Incluir un link de recompra, link de producto o descuento cuando esas opciones están disponibles y configuradas.
- Omitir, esperar o detenerse cuando el cliente ya recompró, el producto no es elegible, otro playbook es mejor dueño del momento o el cliente no puede ser alcanzado.
@@ -30,9 +31,9 @@ Encaja bien para productos como:
- Café, té, comida, alimento para mascotas o productos del hogar.
- Cuidado de la piel, belleza o cuidado personal.
- Recargas, repuestos, filtros o accesorios consumibles.
-- Cualquier familia de producto donde tu equipo conoce una ventana razonable de uso.
+- Cualquier producto reponible cuya duración pueda estimarse con IA o historial, aunque tu equipo no haya configurado una ventana manual.
-Funciona mejor cuando Hellotext puede ver historial de pedidos, identidad de producto, cantidad y una señal de timing de reposición para el SKU o familia de producto.
+Funciona mejor cuando Hellotext puede ver historial de pedidos, identidad de producto y cantidad. No necesitas cargar manualmente una duración para cada producto antes de usarlo.
No lo uses para productos que normalmente se compran una vez y duran mucho tiempo. Para sugerir productos relacionados después de una compra, usa [Impulsor de Ventas Cruzadas]({% link _journeys/cross-sell-driver-playbook.md %}). Para clientes que quedaron fríos a nivel marca, usa un playbook de reactivación. Para clientes que todavía no compraron, usa [Impulsor de Primera Compra]({% link _journeys/first-purchase-driver-playbook.md %}).
@@ -45,12 +46,13 @@ Revisa que:
- Tu tienda, ERP o fuente de datos envíe historial de pedidos y compras a Hellotext.
- Productos, variantes, SKUs, nombres y links coincidan con tu catálogo.
- Los productos reponibles puedan identificarse por producto, SKU, categoría o familia de producto.
-- Las ventanas de uso estén disponibles, como un valor `usage_duration_days`, valor por defecto de familia de producto o promedio interno.
-- Fechas de compra y cantidades sean lo suficientemente confiables para estimar cuándo un cliente podría necesitar más.
+- Fechas de compra, identidad de producto y cantidades sean lo suficientemente confiables para que Hellotext evalúe una cadencia de recompra.
- Links de recompra, links de producto, precios, stock y reglas de descuento opcionales estén actualizados.
- El canal que puede usar el playbook esté conectado y listo.
- Los clientes tengan consentimiento y sean elegibles para el canal.
+> **Importante:** `usage_duration_days` es opcional. Hellotext intenta estimar la duración automáticamente con IA, historial del producto a nivel negocio e historial del cliente. Configura un valor explícito solamente cuando tu negocio conoce una duración más precisa y quiere que tenga prioridad sobre las estimaciones automáticas.
+
Para validar la configuración, usa [Verifica tus datos y señales después de configurar]({% link _integrations/verify-data-and-signals.md %}). Para tracking personalizado, usa [Seguimiento de eventos]({% link _developers/tracking-events.md %}).
Después de activar el playbook, usa los reportes automáticos para revisar recordatorios programados, enviados, omitidos, clics, recompras y resultados atribuidos.
@@ -67,18 +69,22 @@ El playbook expone las configuraciones que controlan cómo se comunica:
Mantén la selección automática de canales salvo que tengas una razón clara para limitar el playbook. Impulsor de Recompra depende de si el cliente realmente puede ser alcanzado cuando llega la ventana de reposición.
-La duración de uso y la elegibilidad para recompra provienen de los datos de producto, el historial de compras y el análisis interno de Hellotext. Son datos de entrada para la decisión, no controles para programar manualmente el recordatorio dentro del playbook.
+La duración de uso y la elegibilidad para recompra provienen del análisis de IA y del historial de compras. Si tu catálogo admite `usage_duration_days`, puedes usarlo como una indicación explícita opcional. No es un control para programar manualmente el mensaje: es una fuente de mayor autoridad que reemplaza la cadencia estimada para ese producto.
## Cómo funciona el timing
El timing de reposición es una estimación, no una prueba de que el cliente se quedó sin producto.
-Hellotext puede usar varios niveles de señal:
+Hellotext evalúa estas fuentes desde la menor hasta la mayor autoridad:
+
+| Prioridad | Fuente | Cómo se usa |
+| --- | --- | --- |
+| 1 | Estimación de IA | Estima los días de consumo del producto. Una confianza alta o media se considera confiable; una confianza baja o desconocida todavía puede usarse, pero es menos confiable. |
+| 2 | Historial del negocio | Usa una cadencia agregada confiable de recompra para ese producto exacto en el negocio y la combina con la estimación de IA cuando existe. |
+| 3 | Historial del cliente | Usa la cadencia personal confiable de recompra del cliente y la combina con el resultado del negocio. |
+| 4, máxima y opcional | Valor explícito | Un `usage_duration_days` positivo definido por el negocio reemplaza inmediatamente las demás fuentes para ese producto, incluso cuando la estimación de IA lo clasifica como no consumible. |
-- Una configuración del producto, como `usage_duration_days`, cuando tu equipo sabe cuánto suele durar un producto.
-- Un valor por defecto de familia o categoría cuando un producto específico no tiene su propio valor.
-- Comportamiento promedio de recompra de clientes que compraron el mismo producto.
-- El patrón propio de recompra del cliente cuando hay suficiente historial.
+El valor explícito es el último nivel de prioridad, no el primer requisito. Si ninguna fuente produce una cantidad positiva de días, Hellotext considera que la cadencia no está disponible y no fuerza un recordatorio.
Luego el playbook calcula cuándo tiene sentido enviar antes del punto estimado de reposición. Hellotext maneja ese timing automáticamente en lugar de pedirte que programes cada recordatorio.
@@ -132,7 +138,8 @@ Usa perfiles del cliente de prueba que tengan consentimiento de canal, luego:
- Crea un pedido de prueba con un producto reponible.
- Confirma que el pedido y el producto aparezcan en el perfil del cliente.
-- Confirma que el producto tenga una ventana de uso, valor por defecto de familia o suficiente historial de compra para estimarla.
+- Confirma que Hellotext pueda estimar una cadencia mediante IA, historial del producto en el negocio o historial del cliente.
+- Si configuraste `usage_duration_days`, confirma que sea positivo, razonable y que realmente deba reemplazar las estimaciones automáticas.
- Confirma que el pedido y el producto creen una oportunidad elegible de recompra.
- Prueba un cliente que recompra antes del recordatorio, lo que debería evitar o actualizar el seguimiento de reposición.
- Prueba un producto no reponible que debería quedar excluido.
@@ -150,7 +157,7 @@ El playbook puede esperar, omitir, detenerse o dejar actuar a otro playbook cuan
- El historial de compra falta, llega tarde o no está conectado a un perfil del cliente usable.
- El producto no está marcado o reconocido como reponible.
-- Falta duración de uso, valores por defecto de familia o datos promedio de recompra.
+- Ninguna estimación de IA, historial agregado del producto, historial del cliente ni valor explícito produce una cadencia positiva utilizable.
- El cliente ya recompró.
- El producto no está disponible, fue discontinuado, no tiene stock o no tiene un link usable.
- El perfil no puede ser alcanzado en un canal elegible.
@@ -167,7 +174,7 @@ Durante los primeros días, revisa:
- Qué productos y familias de producto crearon momentos elegibles de reposición.
- Qué recordatorios se programaron, enviaron, demoraron, omitieron o bloquearon.
-- Qué productos tienen ventanas de uso faltantes o sospechosas.
+- Para qué productos Hellotext no pudo obtener una cadencia positiva o produjo una estimación que conviene revisar.
- Clics, recompras, ingresos atribuidos, bajas, respuestas y mensajes fallidos.
- Si los descuentos aumentan recompras o solo reducen margen.
- Si Impulsor de Recompra se superpone con [Impulsor de Ventas Cruzadas]({% link _journeys/cross-sell-driver-playbook.md %}), reactivación o campañas.