Volver al blog

Guía Paso a Paso: Configuración de WhatsApp Business API (Cloud API)

Creación y configuración de una app en Meta for Developers para integrar la WhatsApp Business

6 de noviembre de 2026

Requisitos Previos

Antes de comenzar, asegúrate de contar con lo siguiente:

  1. Una cuenta personal de Facebook.
  2. Una cuenta de Meta Business Manager (Administrador Comercial / Business Portfolio).
  3. Un número telefónico dedicado para WhatsApp API (este número no debe estar registrado en una cuenta activa de WhatsApp personal o Business en un teléfono móvil).

Paso 1: Crear una Cuenta de Desarrollador en Meta

  1. Ve al portal de Meta for Developers.
  2. Inicia sesión con tu cuenta personal de Facebook.
  3. Haz clic en Comenzar (Get Started) en la esquina superior derecha y completa el registro aceptando los términos y condiciones.

Paso 2: Crear una Aplicación en Meta

  1. En el panel principal de Meta for Developers, haz clic en el botón Crear aplicación (Create App).
  2. Selecciona el caso de uso: Conectarse con clientes mediante WhatsApp (o la opción Negocio / Business según la interfaz actual).
  3. Completa la información básica:
  • Nombre de la app: Elige un nombre identificativo (ej. MiAppWhatsAppIntegration).
  • Correo electrónico de contacto: Ingresa tu correo de trabajo.
  • Cuenta de Business Manager: Selecciona tu portafolio comercial existente.
  1. Haz clic en Crear aplicación.

Paso 3: Configurar el Producto "WhatsApp"

  1. Una vez creada la app, accederás al panel de control (Dashboard) o directamente a la guía de inicio del producto.
  2. Si estás en el panel general, busca la tarjeta de WhatsApp en Añadir productos y haz clic en Configurar (Set up).
  3. Acepta las condiciones del servicio de WhatsApp Business.

Paso 4: Obtener Credenciales Temporales de Prueba

En el menú lateral izquierdo, ve a WhatsApp > API Setup (Configuración de la API).

Aquí encontrarás la información principal para realizar tus primeras pruebas:

  • Identificador de la cuenta de WhatsApp Business (WABA ID).
  • Identificador de número de teléfono de prueba (Phone Number ID).
  • Token de acceso temporal (válido por 24 horas).

Probar el envío de un mensaje de prueba:

  1. En la sección Enviar y recibir mensajes, verás un número de prueba proporcionado por Meta en el campo De (From).
  2. En el campo Para (To), selecciona Añadir número de teléfono e ingresa tu número de teléfono personal (donde recibirás los mensajes de prueba).
  3. Confirma tu número ingresando el código OTP enviado a tu WhatsApp.
  4. Haz clic en Enviar mensaje (Send message). Deberías recibir un mensaje de plantilla (Hello World) de inmediato.

Paso 5: Agregar un Número de Teléfono Real (Producción)

Para usar la API en producción con tu propio número comercial:

  1. Ve a WhatsApp > API Setup.
  2. En la parte inferior de la página, busca la sección Añadir un número de teléfono y haz clic en el botón correspondiente.
  3. Completa el perfil de la empresa:
  • Nombre de pantalla: Nombre que verán los clientes (debe cumplir con las políticas de nombres de Meta).
  • Categoría de la empresa y descripción opcional.
  1. Ingresa el número de teléfono que usarás para la API.
  2. Selecciona el método de verificación (SMS o Llamada de voz).
  3. Introduce el código de verificación recibido para completar el registro.

Paso 6: Generar un Token de Acceso Permanente (System User)

El token temporal expira en 24 horas. Para integrar la API en producción, necesitas un token permanente mediante un Usuario del Sistema.

  1. Ve a tu Meta Business Manager.
  2. Accede a Configuración del negocio (Business Settings).
  3. En el menú izquierdo, dirígete a Usuarios > Usuarios del sistema (System users).
  4. Haz clic en Añadir (Add):
  • Asigna un nombre (ej. SystemUserAPI).
  • Selecciona el rol de Administrador.
  1. Haz clic en Añadir activos (Add Assets):
  • Ve a Apps y selecciona la app de WhatsApp creada.
  • Otorga control total (Full Control).
  1. Haz clic en Generar nuevo token (Generate New Token):
  • Selecciona la app de WhatsApp.
  • Elige la expiración: Nunca (Never).
  • Marca los permisos requeridos:
  • whatsappbusinessmessaging
  • whatsappbusinessmanagement
  1. Haz clic en Generar Token y copia inmediatamente la clave. (Guárdala en un lugar seguro, ya que no se volverá a mostrar).

Paso 7: Configuración de Webhooks

Los Webhooks te permiten recibir notificaciones en tiempo real cuando un cliente te envía un mensaje o cambia el estado de un mensaje enviado (entregado, leído, etc.).

  1. En el panel de tu app en Meta for Developers, ve a WhatsApp > Configuration.
  2. En la sección Webhook, haz clic en Editar.
  3. Introduce los siguientes datos:
  • URL de devolución de llamada (Callback URL): Endpoint de tu servidor HTTPS encargado de procesar las peticiones.
  • Token de verificación: Una clave secreta definida por ti en tu código backend para validar la petición GET de Meta.
  1. Haz clic en Verificar y guardar.
  2. Haz clic en Administrar campos (Manage fields) y suscríbete al evento messages para recibir alertas de nuevos mensajes.

Resumen de Parámetros Necesarios para Tu Servidor

Para realizar peticiones HTTP a la API desde tu lenguaje de programación (Node.js, Python, PHP, etc.), necesitarás guardar estas variables:

ParámetroDónde encontrarlo
Token de Acceso PermanenteCreado en Meta Business Manager (Usuario del sistema)
Phone Number IDMeta Developers > WhatsApp > API Setup
WABA IDMeta Developers > WhatsApp > API Setup
Versión de la APIActualmente v21.0

Ejemplo de llamada API (cURL)

curl -X POST \
  'https://graph.facebook.com/v21.0/TU_PHONE_NUMBER_ID/messages' \
  -H 'Authorization: Bearer TU_TOKEN_PERMANENTE' \
  -H 'Content-Type: application/json' \
  -d '{
    "messaging_product": "whatsapp",
    "to": "573001234567",
    "type": "template",
    "template": {
      "name": "hello_world",
      "language": { "code": "en_US" }
    }
  }'