WhatsApp Cloud API (Meta)

WhatsApp Cloud API es la puerta oficial de Meta para automatizar WhatsApp en un negocio. A diferencia de las plataformas que la revenden, aquí hablás directo con la infraestructura de Meta: envías mensajes con un request HTTP y recibís las respuestas por Webhook. Es la opción de menor costo por mensaje y máximo control, a cambio de que vos pongas el código y el servidor que recibe los Webhooks.

Cómo empezar

1. Entra a Meta for Developers y crea una app de tipo “Business”.
2. Añade el producto WhatsApp a la app. Meta te da un número de prueba y un Business Account de WhatsApp asociado.
3. Copia el ID del número de teléfono (Phone Number ID) y genera un token de acceso temporal (sirve para probar; dura unas horas).
4. En la pantalla de inicio rápido puedes cargar un número destino de prueba y mandar tu primer mensaje.
5. Configura un Webhook (una URL pública tuya) para recibir mensajes entrantes y estados de entrega.
6. Para producción: registra tu propio número, verifica el negocio y genera un token permanente (System User) para tu servidor.

Ejemplo real

Enviar un mensaje de texto (reemplaza el ID del número, el token y el destinatario):

curl -X POST \
  'https://graph.facebook.com/v23.0/PHONE_NUMBER_ID/messages' \
  -H 'Authorization: Bearer ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "messaging_product": "whatsapp",
    "recipient_type": "individual",
    "to": "5491122334455",
    "type": "text",
    "text": { "preview_url": false, "body": "Hola, te escribo desde la Cloud API." }
  }'

El número de destino va en formato internacional sin signos (E.164). La versión del endpoint (v23.0 arriba) va cambiando; revisa en la doc oficial cuál es la vigente.

Trucos y errores comunes

• Ventana de 24 horas. Para iniciar una conversación o escribir fuera de las 24 horas desde el último mensaje del usuario, tienes que usar una plantilla aprobada (no texto libre). El texto libre solo funciona dentro de esa ventana.
• Capa gratuita. Meta ofrece conversaciones gratuitas por mes; arriba de ese tope se cobra. El esquema de precios cambia con el tiempo: confirmalo siempre en la web oficial, no asumas un número.
• Token temporal vs permanente. El temporal vence rápido y sirve solo para pruebas. Para tu servidor necesitás un token permanente de System User.
• Webhook con HTTPS válido. Meta exige una URL pública con certificado válido y un token de verificación; si falla la verificación inicial no vas a recibir mensajes.
• Plantillas con tiempo de aprobación. Las plantillas pasan por revisión de Meta; deja margen antes de un lanzamiento.

Cuándo conviene

Conviene cuando tienes (o puedes tener) un equipo técnico que arme el backend y los Webhooks, y quieres el menor costo por mensaje y control total. Si en cambio buscas algo sin código, con bandeja de entrada y bot visual, mira WATI o respond.io. Si ya trabajas con Twilio o quieres una sola API para SMS, voz y WhatsApp, mira Twilio. Si quieres acceso oficial a la API sin markup pero con onboarding asistido, mira 360dialog.