API de Flux, MCP y webhooks: integra tu operación de contenidos

Con la API de Flux y el MCP de Flux, puedes conectar tu operación de contenidos con otros sistemas y asistentes de IA. Así podrás consultar información, crear y editar publicaciones y registrar aprobaciones sin abrir el panel para cada tarea.

Además, los webhooks de Flux avisan automáticamente a otros sistemas cuando ocurre algo importante, como una publicación completada, un fallo o una nueva aprobación.

API de Flux

La API permite que sistemas externos se conecten directamente con Flux. Con ella puedes integrar proyectos, publicaciones y aprobaciones con los sistemas internos, dashboards y automatizaciones de tu agencia.

Por ejemplo, puedes crear una automatización que consulte cada día qué publicaciones siguen pendientes de aprobación y organice esa información en la herramienta de tu equipo. Del mismo modo, un sistema propio puede crear posts directamente en Flux y enviarlos a aprobación.

MCP de Flux

El MCP conecta Flux con asistentes de inteligencia artificial, como Claude Code. Así puedes consultar información y crear contenidos utilizando lenguaje natural, sin desarrollar una integración.

Por ejemplo, puedes pedir al asistente:

• «¿Qué publicaciones están pendientes de aprobación esta semana?»
• «¿Qué está programado para este cliente?»
• «¿Hay algún proyecto con una red social desconectada?»
• «¿Quién tiene pendiente aprobar las publicaciones de mañana?»
• «Crea un post con esta imagen y este texto, y envíalo a aprobación.»

El asistente utiliza los datos de Flux y organiza la respuesta según tu solicitud.

👉🏻 La principal diferencia es que la API está indicada para integraciones programadas entre sistemas, mientras que el MCP permite acceder a esas funciones mediante una conversación con una IA.

Qué puedes hacer con la API y el MCP

Consultar información

• Proyectos: los proyectos disponibles en la cuenta y las redes conectadas a cada uno;
• Publicaciones: posts, textos, archivos multimedia, estados y fechas de programación o publicación;
• Aprobaciones: cantidad de aprobaciones, solicitudes de cambios y revisores pendientes;
• Historial de aprobación: quién aprobó el contenido, quién pidió cambios y los comentarios registrados;
• Grupos de aprobación: las publicaciones agrupadas para revisión y el estado de cada una;
• Redes sociales: cuentas conectadas, desconectadas o con la autorización caducada;
• Contenidos en varias redes: las distintas versiones de un mismo contenido publicado en más de una red.

Crear, editar y aprobar contenidos

• Subir archivos multimedia: fotos y vídeos para nuevas publicaciones;
• Crear publicaciones: decides si el post se guarda como borrador, se envía a aprobación o queda programado para publicarse;
• Editar publicaciones: puedes cambiar el texto, los archivos multimedia o la fecha mientras el post todavía no se haya publicado;
• Registrar aprobaciones: puedes aprobar una publicación o solicitar cambios directamente desde la integración.

Cómo funciona la programación

Cuando programas una publicación mediante la API o el MCP, Flux la publica automáticamente en la fecha y hora establecidas. No solicita una nueva confirmación antes de publicar. Funciona igual que una publicación programada desde el propio Flux.

Guardar un borrador o enviar un contenido a aprobación no lo publica automáticamente. En ese caso, debes programar el post después.

Publicaciones en TikTok y Pinterest mediante el MCP

TikTok y Pinterest exigen algunos ajustes obligatorios para publicar. Por eso, al utilizar el MCP, el asistente solicita esa información antes de continuar, siguiendo los mismos requisitos del flujo de publicación de Flux:

• Pinterest: debes indicar el tablero en el que se publicará el post;
• TikTok: debes confirmar la configuración de privacidad.

El asistente solo envía la publicación después de que confirmes esa información.

🔔 Webhooks de Flux

Los webhooks permiten que Flux avise automáticamente a un sistema externo cuando ocurren determinados eventos. Así, el sistema integrado no necesita consultar la API repetidamente para descubrir qué ha cambiado.

Crear un webhook consiste en definir qué necesita saber el otro sistema sobre Flux. El webhook establece a dónde se envía el aviso, y los eventos determinan cuándo Flux lo envía.

Eventos disponibles

• Post creado: avisa cuando se crea un nuevo post en Flux;
• Post modificado: avisa cuando se modifica un post existente;
• Post programado: avisa cuando un post queda programado para publicarse;
• Post eliminado: avisa cuando se elimina un post;
• Post publicado: avisa cuando una publicación se completa correctamente;
• Fallo de publicación: avisa cuando Flux intenta publicar, pero la publicación no se completa;
• Decisión de aprobación: avisa cuando alguien toma una decisión en el proceso de aprobación, por ejemplo, aprobar el contenido o solicitar cambios;
• Cuenta desconectada: avisa cuando una red social integrada con Flux pierde la conexión;
• Cuenta reconectada: avisa cuando se restablece la conexión.

Un ejemplo práctico

Imagina una agencia con un sistema propio de gestión de tareas. Puede crear un webhook con los eventos Post publicado y Fallo de publicación. Cuando se publica un post, el sistema marca automáticamente la tarea como completada. Si falla la publicación, crea una alerta para el equipo.

Seguridad y reintentos

Cada aviso incluye una firma que permite al sistema externo comprobar que la información procede de Flux.

Si la dirección configurada no responde, Flux vuelve a intentar enviar el aviso automáticamente durante varios días. Si los fallos persisten, desactiva el webhook.

Límites importantes

• Cada clave tiene un límite de 120 solicitudes por minuto;
• Además, cada clave tiene su propio límite de 20 acciones de creación o edición por minuto;
• Cada cuenta puede registrar hasta 5 webhooks;
• Los enlaces a archivos multimedia devueltos por la API caducan en 48 horas.

Cómo acceder

En Flux, accede a Configuración de la empresa > API y elige la opción que necesites:

• Guía de integración: instrucciones para utilizar el MCP;
• Crear token: instrucciones para utilizar la API;
• Webhooks: pestaña para crear y gestionar tus webhooks y seleccionar los eventos de cada uno.

La documentación técnica completa está disponible en estos enlaces:

• API: developers.reportei.com/flux
• MCP: developers.reportei.com/flux/mcp

Preguntas frecuentes

¿Se pueden crear o editar publicaciones mediante la API o el MCP? Sí. Puedes subir archivos multimedia, crear publicaciones, editar posts que todavía no se hayan publicado y registrar aprobaciones o solicitudes de cambios.

¿Un post programado mediante la API se publica sin confirmación? Sí. Igual que en Flux, el post programado se publica automáticamente en la fecha y hora establecidas. Si quieres revisarlo antes, guárdalo como borrador o envíalo a aprobación.

¿Qué diferencia hay entre la API y el MCP? La API está indicada para integraciones programadas entre sistemas. El MCP permite consultar y crear contenidos en lenguaje natural mediante un asistente de IA.

¿Para qué sirven los webhooks si ya existe la API? La API responde cuando tu sistema hace una consulta. Los webhooks funcionan en sentido contrario: Flux avisa a tu sistema en cuanto ocurre algo, sin que este tenga que consultar continuamente.

¿Hay algún límite de uso? Sí. Cada clave tiene un límite de 120 solicitudes por minuto y de 20 acciones de creación o edición por minuto. Además, cada cuenta puede tener hasta cinco webhooks y los enlaces a archivos multimedia caducan en 48 horas.

Si tienes alguna pregunta, ponte en contacto con nuestro equipo de soporte a través del chat. =)