Todo el mundo da por hecho que integrar WhatsApp es un proyecto de varias semanas. Casi nunca lo es. El primer mensaje puede salir en unos cinco minutos, siempre que sigas los pasos correctos y evites las trampas que convierten una tarea rápida en un proyecto de un trimestre.
Esta guía recorre el camino rápido, minuto a minuto, y explica por qué cada paso importa.
Por qué se estancan la mayoría de las integraciones
Los equipos rara vez se atascan en el código. Se atascan en tres problemas evitables: eligen una herramienta no oficial que acaba bloqueada, dejan las plantillas de mensajes para el día del lanzamiento y se olvidan de dirigir las respuestas a algún sitio útil. Resuelve esas tres cosas desde el principio y el resto es sencillo.
Minuto 1: Usa la API oficial
Olvídate de las librerías no oficiales y de los trucos de automatización del navegador. Parecen más rápidos el primer día, pero hacen que tu número quede marcado y bloqueado en cuanto empiezas a enviar volumen real.
Usa la WhatsApp Business Platform, también llamada Cloud API, alojada por Meta. No tienes servidores que mantener, los mensajes entrantes son gratuitos y obtienes un número de prueba desde el que puedes enviar de inmediato. Crea una app de desarrollador en Meta, añade el producto de WhatsApp y Meta te entrega al instante un número temporal y un token de acceso.
Minuto 2: Envía tu primer mensaje de prueba
Toma el ID de teléfono del número de prueba y tu token, y lanza una sola petición:
curl -X POST \
'https://graph.facebook.com/v21.0/<PHONE_NUMBER_ID>/messages' \
-H 'Authorization: Bearer <TOKEN>' \
-H 'Content-Type: application/json' \
-d '{
"messaging_product": "whatsapp",
"to": "<YOUR_NUMBER>",
"type": "text",
"text": { "body": "It works." }
}'
Si tu teléfono vibra, el canal está activo y ya tienes superada la parte más difícil.
Minuto 3: Envía una plantilla
Fuera de la ventana de atención al cliente de 24 horas, WhatsApp no te deja enviar texto libre. Solo puedes enviar una plantilla previamente aprobada. Envía una ahora para que se apruebe en segundo plano mientras terminas el resto del desarrollo:
Hola {{1}}, tu pedido {{2}} está confirmado. Responde aquí si necesitas algo.
Mantenla transaccional, rellena las variables y elige la categoría correcta, como utilidad o marketing. La aprobación suele llegar en cuestión de minutos a unas pocas horas. Ese retraso es justo el motivo por el que la envías en el minuto tres y no la noche del lanzamiento.
Minuto 4: Configura el webhook de respuestas
Un mensaje que tu equipo no puede ver es peor que ningún mensaje. Apunta un webhook a Meta para que las respuestas entrantes se sincronicen con tu CRM o tu servicio de soporte:
POST /webhooks/whatsapp
1. verifica el token
2. analiza messages[].text.body
3. envíalo a tu bandeja de entrada o CRM
Ahora el canal es una conversación real en dos sentidos y no un agujero negro.
Minuto 5: Pasa a producción
Cambia el número de prueba por un número de empresa verificado y pasa tu token de temporal a permanente. El código se queda igual. Solo cambian las credenciales y el número, y ya estás gestionando tráfico de producción.
La lista de los cinco minutos
- API oficial Cloud, nunca trucos de navegador
- Primer mensaje de prueba enviado
- Plantilla enviada pronto
- Webhook de respuestas sincronizando
- Número real y token permanente
Haz bien estas cinco cosas y la integración se mantiene aburrida, en el mejor sentido posible. Sáltate una y la tarea de cinco minutos se convierte sin que te des cuenta en una reconstrucción de tres meses.
Creamos Whatsable para que estas cinco cosas funcionen desde el primer momento: API oficial, plantillas aprobadas, sincronización en dos sentidos y listo en minutos. Visita whatsable.app para probarlo.
