Enviar un mensaje de WhatsApp es un POST sobre /whatsapp/v1/messages, en la MakeHybrid WhatsApp API: el número de WhatsApp propio de tu organización, vinculado igual que WhatsApp Web. Cada petición lleva tu propia clave en una cabecera X-API-KEY — la misma clave que la API de LinkedIn — y llega solo al número que vinculó tu organización.
El número es el de un teléfono real, vinculado igual que WhatsApp Web: escribe como lo hace una persona, al ritmo de una persona y a gente que espera saber de ti.
La petición
curl -X POST "https://makehybrid.com/whatsapp/v1/messages" \
-H "X-API-KEY: $MAKEHYBRID_KEY" \
-H "content-type: application/json" \
-d '{}'
Qué responde cuando no funciona
- 401 — falta la clave, es incorrecta o está revocada.
- 402 — el plan no está pagado. La MakeHybrid API responde esto cuando termina la prueba.
- 404 — o la cosa no está, o no es de tu organización. Las dos respuestas son la misma a propósito, para que no se puedan sondear ids.
- 429 — demasiadas peticiones, o la plataforma pidiéndonos que vayamos más despacio. Espera un momento antes de volver a intentarlo.
- 502 o 503 — la plataforma no contestó ahora mismo. Vuelve a intentarlo en un momento.
Todos los errores son JSON con la misma forma: {"type":"errors/<code>","status":<n>,"detail":"..."} — así un solo manejador los cubre todos, y el detalle está escrito para enseñárselo a una persona.
Pedírselo a un asistente
Esta operación también es una herramienta MCP. Pega https://makehybrid.com/whatsapp/mcp/<your API key> en Claude, ChatGPT o cualquier asistente que hable MCP y pide lo que quieras en lenguaje normal — el asistente elige la llamada, rellena los ids y te lee la respuesta. El agente todo en uno de https://makehybrid.com/mcp/<your API key> también la tiene, junto a la API de LinkedIn y todos los demás canales.
En una sala de proyecto
En una sala de proyecto, marca el agente de esta API en Puede usar para un agente de IA tuyo y llamará a “Enviar un mensaje de WhatsApp” como herramienta cada vez que la conversación lo necesite. Todos los de la sala ven lo que pidió y lo que devolvió. Pídelo con palabras normales; aquí el agente se llama @scout:
- @scout enséñame mis conversaciones de WhatsApp sin leer y resume lo que ha preguntado cada cliente.
Preguntas frecuentes
¿Puede un agente de IA llamar a “Enviar un mensaje de WhatsApp” por mí?
Sí. Puede cualquier asistente que hable MCP, a través de la dirección de arriba, y también un agente de IA tuyo en una sala de proyecto con el agente de esta API marcado. Los agentes integrados de una sala no pueden: aconsejan, y no tienen tu clave.
¿Funciona fuera de una sala, desde mi propio código?
Sí. La petición de arriba es la misma operación que ejecutan las herramientas de un agente de IA, con la misma respuesta y los mismos errores, y tu clave llega a los mismos canales, entres por donde entres.
¿Funciona en una sala con mi propia marca?
Sí. En una dirección de marca blanca la API, su referencia y su agente de IA llevan el nombre de tu producto, y llegan a los mismos canales con las mismas reglas.
¿Puede aprobarlo una persona antes de que lo haga un agente de IA?
Escríbelo en las instrucciones del agente de IA: que diga lo que va a enviar y espere a que una persona de la sala diga adelante. Una sala muestra cada respuesta a todos los que están en ella, así que las palabras se ven antes de que lleguen a nadie de fuera.
En qué plan está
Forma parte del plan MakeHybrid API, con la misma clave que la API de LinkedIn: $9 por puesto al mes, $7 a partir de diez puestos y $5 a partir de mil. Necesitas tantos puestos como tengas del tipo más numeroso — cuentas de LinkedIn, números de WhatsApp, cuentas de X o cuentas de bandeja de entrada — y los 30 días de prueba cubren uno.