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

# Comenzar con la WhatsApp Business Platform

> Envíe su primer mensaje de la WhatsApp Business Platform a través de Orbit: conecte una WABA, haga aprobar una plantilla, envíela y responda dentro de la ventana de 24 horas.

## Nota de idioma

Esta versión en español es una traducción abreviada: la sección «Frequently asked questions» existe solo en inglés: [/en/guides/whatsapp/getting-started](https://docs.orbit.devotel.io/en/guides/whatsapp/getting-started). Los bloques de código, rutas de endpoints, nombres de campos de API y códigos de error permanecen en inglés.

# Comenzar con la WhatsApp Business Platform

La WhatsApp Business Platform es la API oficial de Meta para enviar y recibir mensajes de WhatsApp a escala — la misma plataforma detrás de actualizaciones de pedidos, recordatorios de citas y chats de soporte de negocios con los que ya escribe. A través de Orbit la usa con una llamada REST y una clave API, sin integrar directamente la Cloud API de Meta.

## Cómo funciona la plataforma

Dos reglas dan forma a todo lo que envía:

* **Necesita una plantilla aprobada para iniciar una conversación.** Cualquier mensaje que *usted* envíe primero — una confirmación de pedido, un código de un solo uso, un aviso de envío — debe usar una plantilla revisada y aprobada por Meta. Las plantillas vienen en cuatro categorías: **authentication**, **utility**, **marketing** y **service**. La categoría determina [lo que paga](https://docs.orbit.devotel.io/guides/whatsapp/pricing.md).
* **Una respuesta abre una ventana de 24 horas.** Cuando un cliente le escribe, se abre una *ventana de servicio* de 24 horas. Dentro puede enviar en forma libre — texto plano, medios, botones interactivos. Cuando la ventana cierra, vuelve a quedar limitado a plantillas. Vea [The 24-hour window](https://docs.orbit.devotel.io/guides/whatsapp/24h-window.md).

## Antes de comenzar

Necesita:

* Una cuenta de Orbit y una clave API live (**Settings → API Keys**). Las claves live llevan el prefijo `dv_live_sk_`; manténgalas solo en el servidor.
* Una **WhatsApp Business Account (WABA)** conectada a Orbit. Siga el [paso 1](#1-connect-a-whatsapp-business-account) — el camino completo está en la [WABA setup guide](https://docs.orbit.devotel.io/guides/whatsapp/waba-setup.md).

**1. Connect a WhatsApp Business Account**

En el dashboard de Orbit, vaya a **Settings → Channels → WhatsApp → Connect** y complete el registro embebido de Meta: elija su Business Manager, cree o seleccione una WABA y verifique un número de teléfono por código SMS o de voz.

Puede empezar a enviar en cuanto el número se verifica — no tiene que esperar a que termine la verificación de negocio de Meta. Hasta entonces, una WABA nueva está limitada a **250 destinatarios únicos por 24 horas**.

**2. Create and approve a template**

Vaya a **Channels → WhatsApp → Templates → New Template** y envíe una:

1. Elija una **categoría** — authentication, utility, marketing o service.
2. Elija un **idioma** (cada locale es un envío separado).
3. Escriba el cuerpo con variables numeradas, p. ej. `Hi {{1}}, your order {{2}} shipped.`
4. Envíe. La mayoría de las plantillas se aprueban en minutos; permita hasta 24 horas.

Mantenga la categoría honesta — un mensaje promocional enviado como `utility` es el rechazo más común. Vea la [content policy](https://docs.orbit.devotel.io/compliance/whatsapp-content-policy.md).

**3. Send your first template message**

Una vez aprobada la plantilla, envíela con un solo POST. Referencie la plantilla por `name` y `language`, y rellene sus variables vía `components`:

```bash theme={null}
curl -X POST https://api.orbit.devotel.io/api/v1/messages/whatsapp \
  -H "X-API-Key: dv_live_sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+14155552671",
    "type": "template",
    "template": {
      "name": "order_confirmation",
      "language": { "code": "en" },
      "components": [
        {
          "type": "body",
          "parameters": [
            { "type": "text", "text": "Ada" },
            { "type": "text", "text": "ORD-12345" }
          ]
        }
      ]
    }
  }'
```

La respuesta devuelve un id de mensaje que puede seguir por los [webhooks de entrega](https://docs.orbit.devotel.io/webhooks/events.md) (`message.sent`, `message.delivered`, `message.read`).

**4. Reply inside the 24-hour window**

Cuando un cliente responde, se abre la ventana de servicio de 24 horas y puede enviar mensajes en forma libre — sin plantilla:

```bash theme={null}
curl -X POST https://api.orbit.devotel.io/api/v1/messages/whatsapp \
  -H "X-API-Key: dv_live_sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+14155552671",
    "type": "text",
    "text": { "body": "Thanks for reaching out! How can we help?" }
  }'
```

**5. Check the window before you send**

¿No está seguro de si un contacto sigue dentro de la ventana? Compruébelo antes de redactar un mensaje en forma libre. Si la ventana cerró, recurra a una plantilla.

```bash theme={null}
curl "https://api.orbit.devotel.io/api/v1/messages/whatsapp/window-status?to=+14155552671&from=+18005551234" \
  -H "X-API-Key: dv_live_sk_..."
```

El pipeline de envío aplica la misma regla: un envío en forma libre fuera de la ventana se rechaza en vez de descartarse en silencio — pero el control previo le permite limitar su UI a solo plantillas.

**6. Scale beyond the starter limit**

Las WABA nuevas empiezan en 250 destinatarios únicos por 24 horas. Mientras envíe de forma constante a más destinatarios manteniendo su calidad en **Medium** o **Green**, Meta sube su nivel automáticamente — a 1.000, luego 10.000, luego 100.000 y luego ilimitado. Una calidad **Low** congela las subidas de nivel.

## Próximos pasos

* [WABA setup guide](https://docs.orbit.devotel.io/guides/whatsapp/waba-setup.md) — el camino completo de cuenta, número y verificación.
* [The 24-hour window](https://docs.orbit.devotel.io/guides/whatsapp/24h-window.md) — cómo funcionan las ventanas de servicio y el re-engagement.
* [WhatsApp channel reference](https://docs.orbit.devotel.io/channels/whatsapp.md) — cada campo de la API de WhatsApp, incluidos medios y mensajes interactivos.
* [WhatsApp pricing](https://docs.orbit.devotel.io/guides/whatsapp/pricing.md) — cómo se tarifican las conversaciones.
* [Content policy](https://docs.orbit.devotel.io/compliance/whatsapp-content-policy.md) — lo que Meta aprueba y rechaza.


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