Conectar Make con el módulo HTTP
La app de Marcomm AI para Make está en revisión. Hasta que se apruebe, llama a la API de Marcomm AI desde un escenario de Make con el módulo HTTP y una clave de API personal.
- 1En Marcomm, ve a Configuración → Integraciones → Make para ver el estado y los valores que necesitas.

La página de Make muestra el estado actual, los pasos, los valores que copiar y si el acceso a la API está aprobado para este espacio de trabajo. - 2Abre Configuración → API. Si el espacio de trabajo aún no tiene acceso a la API, un propietario o administrador rellena Solicitar acceso a la API y selecciona Enviar solicitud.
- 3Tras la aprobación, abre Crear una clave, elige Clave personal, marca los Ámbitos que necesitas y selecciona Crear clave. Copia la clave en ese momento, porque solo se muestra una vez.
- 4En un escenario de Make, añade el módulo HTTP y elige Make a request.
- 5Escribe un endpoint de la documentación para desarrolladores tras
https://marcomm.works/api/v1y añade el encabezadoAuthorizationconBearerseguido de tu clave.
Empieza con GET /me para comprobar la clave antes de montar el resto del escenario.
La app de Marcomm AI para Make está en revisión y aún no se puede añadir. Cuando se apruebe, su módulo Make an API call llamará a cualquier endpoint de la referencia de la API con la misma clave personal. Hasta entonces, el módulo HTTP hace el mismo trabajo. Los eventos de Marcomm AI también pueden ir a una dirección de webhook de Make que añadas en la pestaña Webhooks de Configuración → API.
Los ámbitos deciden lo que puede hacer una clave. Contenido (content) lee notas de prensa, entradas de blog y eventos de prensa, Escribir contenido (content:write) crea y edita borradores, Publicar y enviar (distribution) publica y envía por correo, y Aprobaciones (approvals) cubre los pasos de aprobación. Los tres últimos solo funcionan con una Clave personal, porque la acción queda registrada a nombre de quien creó la clave. Una Clave del espacio de trabajo solo puede leer, y cada clave actúa con el rol y los permisos de quien la creó.
Publicar y enviar no se puede deshacer. La API solo lo ejecuta cuando la solicitud lleva confirm: true o un encabezado Idempotency-Key, y no publica nada y responde 409 mientras falte una aprobación o el contenido esté programado o bajo embargo. Un reintento con el mismo Idempotency-Key y la misma solicitud devuelve el primer resultado durante 24 horas en lugar de ejecutarse otra vez. En el módulo HTTP, añade tú mismo el encabezado Idempotency-Key a cada solicitud de escritura.
La API está disponible en el plan Team y superiores. El equipo de Marcomm AI revisa cada solicitud, y las claves solo funcionan tras la aprobación. Una clave solo puede usar los ámbitos aprobados para el espacio de trabajo, y cada persona puede tener hasta 10 claves. Por defecto, un espacio de trabajo puede hacer 60 solicitudes por minuto y 10.000 al día; por encima, la API responde 429 con un encabezado Retry-After. Para subir los límites, usa ¿Necesitas límites más altos? en Configuración → API. Para desconectar Make, selecciona Revocar junto a la clave; los sistemas que la usan pierden el acceso al momento.
Preguntas frecuentes
Llama a
GET https://marcomm.works/api/v1/mecon el encabezadoAuthorization: Bearerseguido de tu clave. Funciona con cualquier clave aprobada, tenga los ámbitos que tenga, y devuelve el espacio de trabajo, el nombre de la clave y sus ámbitos.Una clave no registra qué servicio la usa, así que Marcomm no marca la tarjeta de Make como conectada. En Configuración → API ves cuándo se usó cada clave por última vez.
Pon
https://marcomm.works/api/v1seguido de una ruta de la documentación para desarrolladores, por ejemplo/press-releasespara listar las notas de prensa.