Saltar al contenido

Conectar Zapier con una clave de API personal

Con la app de Marcomm AI para Zapier, inicia Zaps desde notas de prensa, entradas de blog y eventos de prensa, y créalos, publícalos y envíalos. La app se usa por invitación.

  1. 1
    En Marcomm, ve a Configuración → Integraciones → Zapier para ver el estado y los valores que necesitas.
    Configuración, Integraciones, Zapier, con el estado, los pasos de conexión, los permisos que marcar y el estado del acceso a la API
    La página de Zapier 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
    Abre el enlace de invitación de Marcomm AI y añade la app de Marcomm AI a tu cuenta de Zapier.
  5. 5
    Crea un Zap, elige Marcomm AI como disparador o acción y pega la clave en API Key (clave de API) cuando Zapier pida la conexión.

Prueba primero los pasos de publicar y enviar con un borrador, porque no se pueden deshacer.

La app aún no está en el directorio público de Zapier, así que necesitas un enlace de invitación de Marcomm AI. Tiene siete disparadores: New Press Release, Press Release Approval Requested, Press Release Published, New Blog Post, Blog Post Published, New Press Event y RSVP Invite Updated. Sus acciones crean, actualizan, envían a aprobación, publican y envían notas de prensa, crean y publican entradas de blog, crean eventos de prensa, y crean, completan y envían invitaciones RSVP. Dos búsquedas encuentran una nota de prensa o una entrada de blog.

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. Cada paso de escritura envía una clave de idempotencia creada a partir del Zap y sus datos. Si un Zap debe repetir a propósito exactamente el mismo paso en menos de 24 horas, escribe en Repeat Key un valor que cambie en cada ejecución.

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 Zapier, 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 Zapier como conectada. En Configuración → API ves cuándo se usó cada clave por última vez.

No. La app de Zapier puede solicitar la aprobación, y quien aprueba decide en Marcomm. Con la API, una clave personal con el ámbito Aprobaciones puede aprobar o rechazar.

Integraciones