WhatsApp API para empresas · Activación, aprendizaje y soporteDocumentación técnica para desarrolladores
MensajAPI
Activar WhatsApp APIPara empresasDe principiante a expertoGuíasAcademiaPreguntasDesarrolladoresHerramientasComparar partnersSeguridadPaísesTodas las páginas
Inicio › WhatsApp API para desarrolladores: referencia práctica de Cloud API
Desarrolladores

WhatsApp API para desarrolladores: referencia práctica de Cloud API

Endpoints, arquitectura, webhooks y decisiones de producción para equipos que sí van a construir una integración directa o una capa propia.

Esta área concentra el contenido técnico que antes estaba disperso por MensajAPI. Está pensada para desarrolladores backend, arquitectos e integradores. Si tu empresa no va a construir software, utiliza la ruta para empresas y la guía de activación con una plataforma.

Mapa de endpoints esenciales

POST
https://graph.facebook.com/{VERSION}/{PHONE_NUMBER_ID}/messages

Enviar texto, plantillas, media e interactivos compatibles.

GET
https://graph.facebook.com/{VERSION}/{WABA_ID}/phone_numbers

Listar números asociados a la WABA y obtener Phone Number ID.

POST
https://graph.facebook.com/{VERSION}/{PHONE_NUMBER_ID}/register

Registrar el número y establecer el PIN de verificación en dos pasos según el flujo documentado.

POST
https://graph.facebook.com/{VERSION}/{WABA_ID}/subscribed_apps

Suscribir la aplicación a eventos de la WABA para recibir webhooks.

GET
https://graph.facebook.com/{VERSION}/{WABA_ID}/message_templates

Listar plantillas de mensajes.

POST
https://graph.facebook.com/{VERSION}/{WABA_ID}/message_templates

Crear una plantilla y enviarla a revisión.

POST
https://graph.facebook.com/{VERSION}/{PHONE_NUMBER_ID}/media

Cargar multimedia.

GET
https://graph.facebook.com/{VERSION}/{MEDIA_ID}

Obtener metadatos y URL temporal de multimedia.

Importante: no existe un GET para “consultar el estado actual” de cada mensaje

Al enviar un mensaje recibes un identificador wamid.... Los cambios de estado se reciben de forma asíncrona en el webhook del campo messages. Diseña persistencia de eventos sent, delivered, read y failed; no construyas polling imaginando un endpoint de estado que la Cloud API no documenta para ese propósito.

Arquitectura mínima de producción

Meta Cloud API
   ↓ webhook HTTPS
Verificación de firma
   ↓
Persistencia / cola durable → HTTP 200
   ↓
Workers → CRM / bot / reglas / base de datos
   ↑
Servicio de envío → POST /{PHONE_NUMBER_ID}/messages

El webhook debe responder rápido. La IA, llamadas a CRM, archivos y automatizaciones se procesan después en workers. La cola permite reintentar sin depender de que Meta repita el callback.

Enviar mensajes

Texto, plantilla, respuesta y correlación de wamid.

Webhooks

GET challenge, POST de eventos, firma y subscribed_apps.

Estados

Persistencia y máquina de estados sin polling.

Tokens y permisos

Bearer, secretos y scopes.

WABA y números

Inventario, IDs y registro.

Producción

Idempotencia, reintentos y observabilidad.

¿Tu empresa no necesita desarrollar esto?

Optimify ya integra la capa empresarial sobre WhatsApp API

Esta sección existe para equipos que realmente quieren construir o integrar. Si la empresa solo necesita CRM, multiagente, campañas, automatización e IA, MensajAPI recomienda comparar el costo de desarrollo y mantenimiento frente a usar Optimify, que ofrece una plataforma lista y soporte en español.

Ver alternativa gestionada con Optimify

Documentación oficial para mantener la integración actualizada

Versionado: los ejemplos usan {VERSION} en lugar de fijar una versión de Graph API. Sustituye esa variable por una versión vigente y soportada en tu aplicación y revisa cambios antes de actualizar producción.

Buscar en MensajAPI