WhatsApp

El API de WhatsApp Business para tu bandeja de entrada unificada

Conecta un número de WhatsApp Business a través de Embedded Signup y lee y responde los mensajes de tus clientes con la misma API de mensajes directos que usas para todas las demás plataformas. SocialAPI.ai envuelve el WhatsApp Cloud API y entrega los mensajes entrantes a tu bandeja de entrada unificada en tiempo real a través de webhooks. WhatsApp es un conector de mensajería: gestiona conversaciones y plantillas de mensajes.

Nivel gratuito disponible
API key al instante
Incluye servidor MCP

Míralo en acción.

Responder a una conversación de WhatsApp

api.social-api.ai
1curl -X POST https://api.social-api.ai/v1/inbox/conversations/<conversation-id>/messages \
2  -H "Authorization: Bearer <your-api-key>" \
3  -H "Content-Type: application/json" \
4  -d '{
5    "account_id": "<whatsapp-account-id>",
6    "text": "Thanks for reaching out! Your order shipped today."
7  }' | jq
8
9# Response (HTTP 201)
10{
11  "id": "wamid.HBgL...",
12  "platform": "whatsapp",
13  "conversation_id": "<conversation-id>",
14  "text": "Thanks for reaching out! Your order shipped today.",
15  "created_at": "2026-08-15T10:24:00Z"
16}
17
18# Outside the 24-hour window? Send an approved template instead:
19# curl -X POST https://api.social-api.ai/v1/platforms/whatsapp/accounts/<whatsapp-account-id>/send-template \
20#   -H "Authorization: Bearer <your-api-key>" \
21#   -H "Content-Type: application/json" \
22#   -d '{ "to": "15551234567", "template_name": "order_confirmation", "language": "en_US" }'

Los mensajes entrantes llegan a la bandeja de entrada unificada vía webhooks; responder es un solo POST. Dentro de la ventana de servicio de 24 horas puedes enviar texto libre. Fuera de ella, envía una plantilla aprobada a través de los endpoints de plantillas.

Qué puedes hacer con WhatsApp.

Soportado

Mensajes directos

Recibe mensajes de clientes en tiempo real y responde a través del mismo endpoint de bandeja de entrada unificada que usas para los DMs de Instagram, Facebook y Telegram.

Soportado

Plantillas de mensajes

Crea plantillas, envíalas a Meta para su aprobación y envía plantillas aprobadas: la vía para llegar a clientes fuera de la ventana de servicio de 24 horas.

Soportado

Mensajes multimedia e interactivos

Envía imágenes, documentos, botones y listas interactivas, ubicaciones, tarjetas de contacto y reacciones con emoji en una respuesta.

Soportado

Webhooks

Los mensajes entrantes y los estados de entrega (enviado, entregado, leído) llegan como eventos de webhook en tiempo real en el momento en que ocurren.

Soportado

Perfil de empresa

Lee y actualiza tu perfil de empresa de WhatsApp, incluyendo descripción, dirección, email y sitio web, a través de la API.

Soportado

Números de teléfono

Lista tus números de WhatsApp Business y registra o verifica nuevos números de forma programática.

La API oficial vs una sola API key.

Obtener acceso

el WhatsApp Cloud API oficial

Crea una app de Meta, pasa la verificación de empresa y configura el producto de WhatsApp antes de enviar tu primer mensaje.

Con SocialAPI.ai

Regístrate y conecta tu número a través de Embedded Signup en minutos. Sin app de Meta propia, sin revisión de aplicación.

Recibir mensajes

el WhatsApp Cloud API oficial

Construye y aloja tu propio endpoint de webhooks y luego configura dos capas de suscripción independientes. Si falta una, los mensajes simplemente nunca llegan.

Con SocialAPI.ai

Los webhooks se registran y verifican al momento de conectar. Los mensajes llegan a la bandeja de entrada unificada con el mismo esquema que los DMs de Instagram, Facebook y Telegram.

Mensajes fuera de 24 horas

el WhatsApp Cloud API oficial

Arma a mano payloads de plantillas con componentes, parámetros y códigos de idioma contra el Graph API en crudo.

Con SocialAPI.ai

Crea, envía a aprobación y manda plantillas a través de endpoints de plantillas dedicados.

Multiplataforma

el WhatsApp Cloud API oficial

Una integración solo de WhatsApp que mantienes por separado de cualquier otra API de mensajería.

Con SocialAPI.ai

Los mismos endpoints /v1/inbox cubren WhatsApp y otras nueve plataformas.

Bueno saberlo.

Los mensajes de texto libre están limitados a una ventana de servicio al cliente de 24 horas que se reinicia con cada mensaje entrante del cliente. Fuera de la ventana, solo se pueden enviar plantillas aprobadas.

No hay backfill del historial de mensajes. El Cloud API no tiene un endpoint de historial, por lo que la bandeja de entrada se llena con los webhooks recibidos después de conectarte.

Un número de teléfono no puede estar en la app de WhatsApp para consumidores y en el Cloud API al mismo tiempo. Migrar un número a la plataforma de empresas lo desconecta de la app.

Meta tiene pausadas las plantillas de marketing hacia números de EE. UU. (+1) desde abril de 2025. Las plantillas de utilidad y autenticación no se ven afectadas.

Por qué los desarrolladores aman WhatsApp en SocialAPI.ai

1

Mensajes entrantes en tiempo real

Cuando conectas un número, SocialAPI.ai registra y verifica automáticamente la suscripción de webhooks de WhatsApp. Cada mensaje de cliente se ingiere en tiempo real y aparece en la bandeja de entrada unificada con el mismo esquema de conversación y mensaje utilizado en todas las plataformas, de modo que una sola API de mensajes directos cubre WhatsApp junto a Instagram, Facebook y Telegram.

2

Respuestas enriquecidas en una sola llamada

Responde con texto, imágenes, documentos, botones y listas interactivas, ubicaciones, tarjetas de contacto o reacciones con emoji. SocialAPI.ai mapea cada respuesta al tipo de mensaje correcto del Cloud API por ti, a través del mismo endpoint de envío de mensajes que ya usas en todas las demás plataformas de mensajería.

3

Plantillas para la ventana de 24 horas

WhatsApp solo permite respuestas de texto libre dentro de las 24 horas posteriores al último mensaje del cliente; después, las plantillas aprobadas son obligatorias. SocialAPI.ai te da el ciclo de vida completo de plantillas: crea una plantilla, envíala a Meta para su aprobación, sigue su estado y envíala, todo a través de la API o del dashboard.

4

Embedded Signup, no revisión de aplicación

Conectar WhatsApp normalmente implica crear una app de Meta, pasar la verificación de empresa y configurar webhooks a mano. Con SocialAPI.ai recorres el flujo de Embedded Signup de Meta en el dashboard: eliges tu empresa, eliges tu número y listo. El almacenamiento de tokens, la renovación y la suscripción de webhooks quedan resueltos por ti.

Precios simples y honestos.

Leer comentarios, DMs y menciones es gratis e ilimitado en todos los planes. Los planes de pago comienzan en $29/mes con posts e interacciones ilimitados. El nivel gratuito no requiere tarjeta de crédito.

FAQ

Preguntas frecuentes.

¿WhatsApp tiene una API?

Sí. La plataforma WhatsApp Business de Meta expone el Cloud API para enviar y recibir mensajes de forma programática. Usarlo en crudo implica operar una app de Meta, verificación de empresa, infraestructura de webhooks y plomería de plantillas por tu cuenta. SocialAPI.ai envuelve el Cloud API detrás de una sola API REST: conecta un número a través de Embedded Signup y lee y responde mensajes desde la misma bandeja de entrada unificada que todas las demás plataformas.

¿Cuánto cuesta el API de WhatsApp Business?

Aplican dos costos. Meta cobra las plantillas por mensaje entregado según su categoría (marketing, utilidad, autenticación), con tarifas que varían por país; responder a un cliente dentro de la ventana de servicio de 24 horas es gratis. SocialAPI.ai empieza en $0: el plan Free incluye 2 perfiles sociales y 50 interacciones al mes, y los planes pagos tienen interacciones ilimitadas.

¿Cómo envío un mensaje de WhatsApp con una API?

Conecta tu número de WhatsApp Business a través de Embedded Signup en el dashboard de SocialAPI.ai y luego haz un POST a /v1/inbox/conversations/:id/messages con tu API key y el texto de la respuesta. Dentro de la ventana de servicio de 24 horas se entrega como mensaje de texto libre; fuera de ella, envía una plantilla aprobada a través de los endpoints de plantillas.

¿Necesito mi propia app de Meta o un BSP?

No. SocialAPI.ai actúa como tu proveedor del API de WhatsApp Business: te conectas a través de nuestra app de Meta aprobada vía Embedded Signup, así que no hay app propia que crear, ni revisión de aplicación que pasar, ni contrato aparte con un BSP que firmar. Tú conservas la propiedad de tu cuenta de WhatsApp Business y de tu número.

Empieza hoy

¿Listo para unificar tus interacciones?

Nivel gratuito disponible · Sin tarjeta de crédito · Incluye servidor MCP

We use essential cookies for security, and analytics cookies with your consent. Privacy Policy.