WhatsApp

Los mensajes salen de tu número, por tu cuenta en Meta. Sin la integración, la app no envía nada por WhatsApp: la pantalla puede tener el botón, pero el envío se rechaza con el aviso de que WhatsApp no está configurado en esta app.

Antes de empezar

• Plan: Builder. El plan se comprueba en cada envío: si la cuenta deja Builder, la app deja de enviar;
• Cuenta en Meta for Developers y, para producción, una cuenta empresarial de Meta con un número de teléfono propio para WhatsApp;
• Costo: Meta cobra los mensajes según su tabla, en tu cuenta. Además, cada mensaje enviado por la app consume créditos de integración de la plataforma, y solo cuando Meta acepta el envío.

Qué hace la app con la integración

• enviar un mensaje de texto a un número;
• enviar un mensaje de plantilla (template) aprobado por Meta, en el idioma de la plantilla;
• recibir mensajes y disparar automatizaciones cuando alguien escribe al número. Para eso sirven los dos últimos campos de la tarjeta (consulta el final de esta guía).

Los números van en formato internacional, con el código del país: +5511999999999.

Paso a paso

Campos de la tarjeta: Phone Number ID, Access Token, Verify Token (webhook) y App Secret (firma del webhook).

1. en developers.facebook.com, crea una app de tipo Business;
2. agrega el producto WhatsApp a la app. Meta ya ofrece un número de prueba;
3. en WhatsApp → API Setup, copia el Phone number ID y el token de acceso;
4. en Configuración → Básica, muestra y copia el App Secret;
5. inventa un Verify Token: cualquier texto secreto, que vas a volver a usar en el panel de Meta si vas a recibir mensajes;
6. en el editor de la app, pestaña Integraciones, categoría Notificaciones, abre la tarjeta WhatsApp;
7. completa los cuatro campos y haz clic en Guardar y activar.

Token de prueba y token permanente

El token que aparece en API Setup es temporal y caduca en unas 24 horas. Sirve para la primera prueba y nada más. Para la app en uso, genera un token permanente con un usuario del sistema, en Configuración del negocio → Usuarios del sistema, dándole acceso a la app y a WhatsApp. Después abre la tarjeta, pega el token nuevo en su campo y guarda. Los otros campos pueden quedar en blanco: se conserva el valor guardado.

Números de destino en modo de prueba

Mientras la app de Meta está en modo de prueba, solo envía a números registrados como destinatarios permitidos en el propio API Setup, y Meta limita esa lista a pocos números. Registra el tuyo para probar.

Plantillas de mensaje (templates)

La regla es de Meta, no de la plataforma: la empresa solo puede enviar texto libre a quien escribió al número en las últimas 24 horas. Fuera de esa ventana, el primer mensaje tiene que ser una plantilla aprobada.

En la práctica, los recordatorios y avisos que la app envía por su cuenta (un recordatorio de cita, una confirmación de pedido) casi siempre necesitan plantilla. El camino:

1. en el Administrador de WhatsApp de tu cuenta empresarial, crea la plantilla, con el texto y las variables;
2. envíala a aprobación y espera a que Meta la apruebe;
3. pide en el chat que la app use esa plantilla, indicando el nombre exacto de la plantilla y el idioma. Si no indicas idioma, la app usa pt_BR.

Cómo saber que funcionó

La tarjeta de WhatsApp no prueba la credencial al guardar: Conectada significa que los campos se guardaron, no que el token sea válido. La prueba es un envío real:

1. pide en el chat un botón de prueba que envíe un mensaje a tu número (eso gasta créditos de IA, como cualquier construcción);
2. usa el botón y comprueba si llegó el mensaje;
3. si no llegó, el error que aparece trae el mensaje de la propia Meta.

Recibir mensajes

Los campos Verify Token (webhook) y App Secret (firma del webhook) existen para que la app reciba mensajes: el Verify Token le confirma a Meta que la dirección es tuya, y el App Secret prueba que cada mensaje recibido vino realmente de Meta. Sin el App Secret, todos los mensajes recibidos se rechazan.

La dirección de retorno que Meta pide registrar en ese paso hoy no aparece en la tarjeta. Si tu app necesita recibir mensajes, contacta con soporte para obtener la dirección de tu proyecto.

Problemas comunes

• Ayer funcionó y hoy no envía. Es el token temporal, que caducó. Genera el permanente (mira arriba);
• Error sobre destinatario no permitido. La app de Meta está en modo de prueba y el número de destino no está en la lista de permitidos;
• El recordatorio no llega, pero la respuesta a un cliente sí. Es la ventana de 24 horas: fuera de ella, solo plantilla aprobada;
• Error sobre la plantilla. El nombre o el idioma no coinciden con la plantilla aprobada, o todavía no se aprobó;
• El envío se rechaza por falta de créditos. Se acabó el saldo de créditos de integración. Revisa el panel, en Facturación.