Listar los contactos de la bandeja de entrada es un GET sobre /inbox/v1/contacts, en la MakeHybrid Inbox API: una sola bandeja de entrada para WhatsApp, Instagram, Facebook, TikTok, Telegram, LINE, correo electrónico, SMS y el chat de tu sitio 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 a la cuenta de bandeja de entrada de tu propia organización.
Una bandeja de entrada reúne todos los canales que le añades, así que la respuesta vuelve por el canal en el que escribió el cliente — WhatsApp, Instagram, correo electrónico o cualquier otro — con la misma llamada.
La petición
curl -X GET "https://makehybrid.com/inbox/v1/contacts" \ -H "X-API-KEY: $MAKEHYBRID_KEY"
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/inbox/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 “Listar los contactos de la bandeja de entrada” 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 lista las conversaciones abiertas de hoy de todos los canales y redacta una respuesta para la más antigua.
Preguntas frecuentes
¿Puede un agente de IA llamar a “Listar los contactos de la bandeja de entrada” 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.
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.