Conecta tus sistemas con Marcomm AI

1. 1
   Solicita acceso

   Describe tu sistema y elige los datos que necesitas. Revisamos las solicitudes.

2. 2
   Crea una clave

   Tras la aprobación, crea una clave en Configuración, API. La clave se muestra una sola vez, así que guárdala en tu sistema.

3. 3
   Envía una solicitud

   Envía la clave en el encabezado Authorization y llama a uno de los endpoints de abajo.

Solicitud de ejemplo

curl https://app.marcomm.works/api/v1/news/digest?days=7 \
  -H "Authorization: Bearer mc_live_..."

Envía tu clave como token Bearer en cada solicitud. Una clave personal actúa como la persona que la creó, por lo que puede leer y decidir aprobaciones en su nombre. Una clave del espacio de trabajo la crea un administrador y solo puede leer. Las claves pueden caducar, limitarse a direcciones IP y rotarse: la clave anterior sigue funcionando 24 horas después de una rotación.

Cada clave incluye solo los scopes para los que se aprobó tu solicitud.

news

Resumen de noticias, artículos y medios.

crisis

Noticias críticas e incidentes de crisis.

approvals

Aprobaciones pendientes, y aprobarlas o rechazarlas con una clave personal.

content

Lectura de notas de prensa y entradas de blog.

Las rutas empiezan por /api/v1. Los endpoints de lectura usan GET y aceptan parámetros de consulta. La respuesta es JSON con la forma {"data": ...}.

Envía {"decision": "approve"} o {"decision": "reject", "comment": "..."} al elemento. Para rechazar hace falta un comentario. La decisión sigue las mismas reglas que la aplicación y Slack, y se registra a nombre del titular de la clave. Si el texto contiene expresiones que requieren confirmación, recibirás 409 confirmation_required con las advertencias y podrás reenviar la solicitud con "force": true.

curl -X POST https://app.marcomm.works/api/v1/approvals/press-releases/<id> \
  -H "Authorization: Bearer mc_live_..." \
  -H "Content-Type: application/json" \
  -d '{"decision":"reject","comment":"Please fix the headline."}'

Los límites se aplican por espacio de trabajo, por minuto y por día (UTC). Las respuestas incluyen los encabezados siguientes. Al superar un límite recibes 429 con Retry-After. Para aumentar un límite, envía una solicitud en Configuración, API. Nuestro equipo la revisa.

X-RateLimit-Limit

Solicitudes permitidas por minuto.

X-RateLimit-Remaining

Solicitudes restantes en el minuto actual.

X-RateLimit-Reset

Hora Unix en que se reinicia la ventana del minuto.

X-RateLimit-Day-Limit

Solicitudes permitidas por día.

X-RateLimit-Day-Remaining

Solicitudes restantes hoy.

Retry-After

Segundos que hay que esperar antes de reintentar. Solo en 429.

Los errores devuelven JSON con la forma {"error": {"code": ..., "message": ...}}.

Las alertas, las solicitudes de aprobación y el resumen matutino también pueden enviarse a tu sistema. Añade un destino en Configuración, API, Webhooks. Las solicitudes son JSON con los campos event (alert, approval o briefing), workspace, title, text, url, data y sentAt. Una solicitud de aprobación incluye data.kind (press_release, blog o event) y data.id, que puedes usar para leer y decidir mediante la API.

Las solicitudes van firmadas. Calcula el HMAC-SHA256 del cuerpo sin procesar con tu secreto de firma y compáralo con el encabezado X-Marcomm-Signature, que tiene la forma sha256=<hex>. Rechaza las solicitudes que no coincidan.

Verificar un webhook en Node.js

import { createHmac, timingSafeEqual } from 'node:crypto';

export function isFromMarcomm(rawBody: string, signature: string, secret: string) {
  const expected = 'sha256=' + createHmac('sha256', secret).update(rawBody).digest('hex');
  const a = Buffer.from(expected);
  const b = Buffer.from(signature);
  return a.length === b.length && timingSafeEqual(a, b);
}