Guía · WhatsApp Cloud · Capítulo 1 de 3
WhatsApp Cloud API — Capítulo 1: tu número y tu primer mensaje
Conecta WhatsApp con la API oficial de Meta · ~30 minutos · Sin experiencia previa
Qué vas a lograr (en este capítulo 1): crear/usar tu App de Meta, agregar el producto WhatsApp, obtener tus credenciales de WhatsApp Cloud (Phone Number ID, WhatsApp Business Account ID y un token), yenviar tu primer mensaje de prueba. La conexión al asistente y la puesta en producción van en el Capítulo 2.
Qué necesitas antes de empezar:
- Una cuenta de Facebook y un Business portfolio(portafolio de negocio) en Meta Business. Si no tienes, Meta te deja crearlo en el camino.
- Un número de teléfono que NO esté activo hoy en la app normal de WhatsApp / WhatsApp Business (Cloud API requiere un número dedicado). Para probar puedes usar el número de prueba que Meta te regala.
- Un navegador de computadora.
Cloud API vs. el modo QR: con QR (no oficial) conservas tu app del teléfono pero hay riesgo de bloqueo. Con Cloud API (oficial) el número vive en los servidores de Meta: máxima estabilidad, pero el número se dedica a la API. Elige según tu caso (ver la ficha del canal WhatsApp).
Índice de la guía
PARTE 1 · Crear la App y agregar WhatsApp
1.1 Entra al portal y crea (o reutiliza) tu App
Ve a https://developers.facebook.com → My Apps. Si ya tienes una app (por ejemplo de Messenger), úsala. Si no: Create App → tipo Business →nombre + email + tu Business portfolio → Create App.
1.2 Agrega el producto WhatsApp
En el dashboard de la app, Add product → WhatsApp → Set up. Meta te pedirá seleccionar (o crear) tu WhatsApp Business Account (WABA).
PARTE 2 · Tus credenciales de WhatsApp Cloud
En WhatsApp → API Setup verás todo lo que necesitas en una sola pantalla:
2.1 Phone Number ID
Bajo "From", Meta te da un número de prueba y suPhone number ID (un número largo). Ese ID —no el número telefónico— es lo que la plataforma usa. Cópialo.
2.2 WhatsApp Business Account ID (WABA ID)
En la misma pantalla, WhatsApp Business Account ID. Cópialo.
2.3 El token
Meta te da un token temporal de 24 horas para probar hoy mismo. Sirve para el Capítulo 1. Para producción necesitarás un token permanente de System User (Capítulo 2).
Ojo: si el botón dice "Generate token" y no ves ninguno listado, es normal — generá: el primer token no existe hasta que lo pedís.
2.4 App Secret (para el webhook)
Igual que en Messenger/Instagram: App settings → Basic → App secret → Show. Son 32 caracteres hexadecimales exactos. Lo necesitarás al conectar el webhook.
PARTE 3 · Tu primer mensaje de prueba
3.1 Agrega un número destinatario
En API Setup → "To", agrega tu propio número de WhatsApp como destinatario de prueba. Meta te lo verifica con un código que llega por WhatsApp al número que agregaste — abrilo en ese teléfono y pegá el código. En modo de prueba solo puedes enviar a números que agregues aquí.
3.2 Envía el "Hello World"
Pulsa Send message. Meta manda una plantilla hello_world a tu número.
3.3 Confirma la recepción
Fin del capítulo 1
Ya tienes: Phone number ID, WABA ID, untoken y tu App Secret, y comprobaste que Meta envía mensajes a tu número.
Sigue en el Capítulo 2: token permanente (System User), conectar el webhook en 2 pasos desde el panel, y salir a producción (verificación del negocio y número propio).
RESUMEN DE 1 MINUTO
| Paso | Dónde | Resultado |
|---|---|---|
| Crear/usar app Business | developers.facebook.com | App lista |
| Agregar WhatsApp | Add product → WhatsApp → Set up | WABA seleccionada |
| Phone Number ID | WhatsApp → API Setup → "From" | Phone number ID |
| WABA ID | API Setup | WhatsApp Business Account ID |
| Token | API Setup (temporal 24h) | Token de prueba |
| App Secret | App settings → Basic → Show | App Secret (32 hex) |
| Destinatario | API Setup → "To" | Tu número verificado |
| Primer mensaje | Send message | hello_world recibido 🎉 |
Capítulo 1 basado en el proceso real de configuración de WhatsApp Cloud API. La interfaz de Meta cambia con frecuencia: si una pantalla no coincide, busca los mismos rótulos en la sección equivalente.