La API de WhatsApp Business para tu bandeja de entrada unificada

La API de WhatsApp Business, unificada con todas tus demás bandejas de entrada.

Empieza gratis Ver la documentación

Nivel gratuito, sin tarjeta
API key al instante
Servidor MCP incluido

En WhatsApp

Maya R.

en línea

Lunes

¿Abren el domingo?

18:42

Sí, de 11 a 5.

18:45

Hoy

¿Todavía tienen estos en 42?

09:12

❤️

Maya R.¿Todavía tienen estos en 42?

Quedan dos pares. ¿Te apartamos uno?

09:14

Apartar un par

Ahora no

POST/v1/inbox/conversations/{id}/messages200 OK

Capacidades: Lo que puedes construir en WhatsApp

Cada capacidad es un endpoint, el mismo que llamas en todas las demás plataformas.Las pantallas muestran dónde llega cada llamada.

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.
- POST/v1/platforms/whatsapp/accounts/{id}/send-template
Tomás B.
en línea
Hoy
Pedido enviado
Hola Tomás, tu pedido #2318 ya salió. Llega en 2 a 3 días.
Ledge Skate & Shoe10:02
Rastrear pedido
Contactarnos
Rastrear pedido
10:05
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.
- GET/v1/inbox/conversations
- POST/v1/inbox/conversations/{id}/messages
- recibir
- responder
Mensajes multimedia e interactivos
Envía imágenes, documentos, botones y listas interactivas, ubicaciones, tarjetas de contacto y reacciones con emoji en una respuesta.
- imágenes
- documentos
- botones
- listas
- ubicaciones
- tarjetas de contacto
- reacciones
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.
Eventos de webhook
- dm.received
- enviado
- entregado
- leído
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.
- descripción
- dirección
- email
- sitio web
Números de teléfono
Lista tus números de WhatsApp Business y registra o verifica nuevos números de forma programática.
- listar
- registrar
- verificar

En todas las plataformas

Listo para agentes
Cada capacidad de WhatsApp es una herramienta tipada del servidor MCP de SocialAPI.ai.
- social_api_send_dm
Una sola API key
La key que llama a WhatsApp llama a las 13 plataformas.
Authorization: Bearer sapi_key_…
Errores predecibles
Los mismos códigos de estado en todas partes, sin importar la plataforma detrás.
- 401token expirado
- 429límite de tasa
- 501no disponible en esta plataforma

Llama a la API de WhatsApp

Responder a una conversación de WhatsApp

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.

curl -X POST https://api.social-api.ai/v1/inbox/conversations/<conversation-id>/messages \
  -H "Authorization: Bearer <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "<whatsapp-account-id>",
    "text": "Thanks for reaching out! Your order shipped today."
  }' | jq

# Response (HTTP 200)
{
  "success": true,
  "message_id": "<message-id>",
  "message_ids": ["<message-id>"]
}

# Outside the 24-hour window? Send an approved template instead:
# curl -X POST https://api.social-api.ai/v1/platforms/whatsapp/accounts/<whatsapp-account-id>/send-template \
#   -H "Authorization: Bearer <your-api-key>" \
#   -H "Content-Type: application/json" \
#   -d '{ "to": "15551234567", "template_name": "order_confirmation", "language": "en_US" }'

import requests

resp = requests.post(
    "https://api.social-api.ai/v1/inbox/conversations/<conversation-id>/messages",
    headers={"Authorization": "Bearer <your-api-key>"},
    json={
        "account_id": "<whatsapp-account-id>",
        "text": "Thanks for reaching out! Your order shipped today.",
    },
)
print(resp.json()["message_id"])

const res = await fetch(
  "https://api.social-api.ai/v1/inbox/conversations/<conversation-id>/messages",
  {
    method: "POST",
    headers: {
      Authorization: "Bearer <your-api-key>",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      account_id: "<whatsapp-account-id>",
      text: "Thanks for reaching out! Your order shipped today.",
    }),
  }
);
const message = await res.json();
console.log(message.message_id);

Comparación: La API oficial vs una sola API key

Aspecto	El WhatsApp Cloud API oficial	Con SocialAPI.ai
Obtener acceso	El WhatsApp Cloud API oficialCrea una app de Meta, pasa la verificación de empresa y configura el producto de WhatsApp antes de enviar tu primer mensaje.	Con SocialAPI.aiRegí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 oficialConstruye 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.aiLos 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 oficialArma a mano payloads de plantillas con componentes, parámetros y códigos de idioma contra el Graph API en crudo.	Con SocialAPI.aiCrea, envía a aprobación y manda plantillas a través de endpoints de plantillas dedicados.
Multiplataforma	El WhatsApp Cloud API oficialUna integración solo de WhatsApp que mantienes por separado de cualquier otra API de mensajería.	Con SocialAPI.aiLos mismos endpoints /v1/inbox cubren WhatsApp y las otras 12 plataformas, hasta donde cada una lo permite.

En detalle: Cómo funciona la API de WhatsApp en SocialAPI.ai

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.

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.

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.

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.

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.

Empieza gratis Precios de la API de redes sociales

Preguntas frecuentes

Lo que preguntan los desarrolladores antes de lanzar con WhatsApp.

¿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.

Todas las demás plataformas, una sola API: Todas las demás plataformas, una sola API

La misma key, las mismas estructuras, el mismo webhook.

¿Listo para unificar tus interacciones sociales?

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

Empieza gratis Ver la documentación

La API de WhatsApp Business para tu bandeja de entrada unificada

Capacidades: Lo que puedes construir en WhatsApp

Plantillas de mensajes

Mensajes directos

Mensajes multimedia e interactivos

Webhooks

Perfil de empresa

Números de teléfono

Listo para agentes

Una sola API key

Errores predecibles