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

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 — el camino completo está en la WABA setup guide.

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.

Create and approve a template

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

Elija una categoría — authentication, utility, marketing o service.
Elija un idioma (cada locale es un envío separado).
Escriba el cuerpo con variables numeradas, p. ej. Hi {{1}}, your order {{2}} shipped.
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.

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:

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 (message.sent, message.delivered, message.read).

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:

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?" }
  }'

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.

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.

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 — el camino completo de cuenta, número y verificación.
The 24-hour window — cómo funcionan las ventanas de servicio y el re-engagement.
WhatsApp channel reference — cada campo de la API de WhatsApp, incluidos medios y mensajes interactivos.
WhatsApp pricing — cómo se tarifican las conversaciones.
Content policy — lo que Meta aprueba y rechaza.

​Nota de idioma

​Comenzar con la WhatsApp Business Platform

​Cómo funciona la plataforma

​Antes de comenzar

​Próximos pasos

Nota de idioma

Comenzar con la WhatsApp Business Platform

Cómo funciona la plataforma

Antes de comenzar

Próximos pasos