Saltar al contenido

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.

  1. 1
    En Marcomm, ve a Configuración → Integraciones → Make para ver el estado y los valores que necesitas.
    Configuración, Integraciones, Make, con el estado, los pasos de conexión, los permisos que marcar y el estado del acceso a la API
    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.
  2. 2
    Abre 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.
  3. 3
    Tras 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.
  4. 4
    En un escenario de Make, añade el módulo HTTP y elige Make a request.
  5. 5
    Escribe un endpoint de la documentación para desarrolladores tras https://marcomm.works/api/v1 y añade el encabezado Authorization con Bearer seguido 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/me con el encabezado Authorization: Bearer seguido 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/v1 seguido de una ruta de la documentación para desarrolladores, por ejemplo /press-releases para listar las notas de prensa.

Integraciones