La tarea: un solo lugar donde llegue cada mensaje de un cliente, escriba desde la aplicación que escriba, y una sola llamada que les responda allí. Cinco pasos, cada uno una petición.
1. Crea la cuenta de bandeja de entrada
curl -X POST https://makehybrid.com/inbox/v1/account \ -H "X-API-KEY: $MAKEHYBRID_KEY"
Una vez por organización. Si repites la llamada, responde con la misma cuenta, así que es seguro ejecutarla en cada despliegue.
2. Añade canales
curl -X POST https://makehybrid.com/inbox/v1/inboxes \
-H "X-API-KEY: $MAKEHYBRID_KEY" -H "content-type: application/json" \
-d '{"name":"Website","channel":{"type":"web_widget","website_url":"https://acme.com"}}'
curl -X POST https://makehybrid.com/inbox/v1/inboxes \
-H "X-API-KEY: $MAKEHYBRID_KEY" -H "content-type: application/json" \
-d '{"name":"Telegram","channel":{"type":"telegram","bot_token":"123456:ABC…"}}'
El chat web responde con el fragmento que hay que pegar antes de </body>; se carga desde tu propio dominio. Instagram y TikTok se añaden con un enlace de inicio de sesión, Facebook Messenger con un enlace que abre quien administra la página, y LINE, SMS y WhatsApp con las credenciales propias de la plataforma — la referencia describe cada uno.
3. Recibe los mensajes nuevos
curl -X POST https://makehybrid.com/inbox/v1/webhooks/endpoints \
-H "X-API-KEY: $MAKEHYBRID_KEY" -H "content-type: application/json" \
-d '{"url":"https://acme.com/hooks/inbox","events":["inbox.message_created"]}'
Guarda el secreto que devuelve: cada entrega se firma con él en la cabecera x-mh-signature, y que un mismo evento llegue repetido es normal.
4. Responde donde te escribieron
curl -X POST https://makehybrid.com/inbox/v1/conversations/$CONVERSATION_ID/messages \
-H "X-API-KEY: $MAKEHYBRID_KEY" -H "content-type: application/json" \
-d '{"content":"Thanks, we are on it.","message_type":"outgoing"}'
La respuesta sale por el canal de la propia conversación. Añade "private": true y será una nota que solo ve tu equipo.
5. Resuélvela
curl -X POST https://makehybrid.com/inbox/v1/conversations/$CONVERSATION_ID/toggle_status \
-H "X-API-KEY: $MAKEHYBRID_KEY" -H "content-type: application/json" \
-d '{"status":"resolved"}'
Una conversación resuelta se vuelve a abrir sola cuando el cliente escribe.
Algunos canales solo dejan que una empresa escriba primero con una plantilla aprobada por la plataforma — WhatsApp fuera de su ventana de 24 horas es el caso habitual. Responder siempre está permitido; empezar lo decide la plataforma.
Preguntas frecuentes
¿Puede mi equipo responder sin escribir código?
Sí. La pantalla Inbox de la aplicación instalada muestra las mismas conversaciones a cada miembro que haya iniciado sesión, con respuestas, notas privadas, asignación, etiquetas y notificaciones en el teléfono.
¿Puede un agente de IA redactar las respuestas?
Sí. Dale a un agente de IA propio el agente de la bandeja de entrada en una sala de proyecto, o conecta tu asistente a /inbox/mcp, y pídele que redacte; una persona de la sala dice «adelante» antes de que se envíe nada.