Integraciones y autopublicación

La sección «Desarrolladores» de la aplicación es el punto de entrada para las integraciones. Aquí creas claves de API para trabajar con la REST API v1 pública, configuras webhooks para recibir eventos de las publicaciones en tu propio servidor y conectas la autopublicación desde RSS — cuando los nuevos artículos de tu feed se convierten automáticamente en publicaciones.

Claves de API

Necesitas una clave de API para cualquier petición a la API pública. Para crear una clave:

1. Abre la sección «Desarrolladores» y pulsa «Crear clave».
2. Elige los permisos (scopes) — qué podrá hacer exactamente la clave.
3. Copia la clave justo después de crearla.

Nota

La clave completa se muestra solo una vez — justo después de crearla. Después, en la lista solo se ve su prefijo. Si pierdes la clave, crea una nueva.

Permisos (scopes)

Scope	Qué permite
posts:read	Leer publicaciones
posts:write	Crear y publicar publicaciones
accounts:read	Ver la lista de redes sociales conectadas
media:read	Leer archivos multimedia
media:write	Subir archivos multimedia

Concede a la clave solo los permisos que la integración realmente necesita — así es más seguro.

Autorización y límite

La clave se pasa en la cabecera Authorization: Bearer sk_... o x-api-key: sk_....

El límite de la API pública es de 60 peticiones por minuto por clave. Si lo superas, las peticiones empezarán a rechazarse; espera un minuto y continúa.

Revocar una clave

Si una clave está comprometida o ya no la necesitas, elimínala en la lista de claves. Dejará de funcionar de inmediato y las peticiones que la usen serán rechazadas.

Ejemplo — crear una publicación con curl

curl -X POST https://api.repost21.com/v1/posts \
  -H "Authorization: Bearer sk_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hello from API 👋",
    "platforms": ["TELEGRAM"],
    "scheduledAt": "2026-07-01T09:00:00Z"
  }'

Sin scheduledAt se crea un borrador; con una fecha futura, la publicación va al «Plan de contenido» y se publica según lo programado. La lista completa de endpoints está en la referencia de la REST API v1.

Webhooks

Los webhooks envían una petición HTTP a tu servidor cuando ocurre un evento en Repost21. Para configurarlo:

1. En la sección «Desarrolladores», añade un webhook — indica la URL de tu endpoint.
2. Elige los eventos a los que quieres suscribirte.
3. Guarda el secreto — al igual que la clave de API, se muestra solo una vez.

Eventos

Evento	Cuándo llega
post.created	Se ha creado una publicación
post.published	Una publicación se ha publicado correctamente
post.failed	La publicación terminó con un error

Firma y verificación

Cada entrega llega como una petición POST con estas cabeceras:

Cabecera	Qué contiene
x-repost21-event	El nombre del evento
x-repost21-signature	Una firma del tipo sha256=<hex>
x-repost21-delivery	El ID de la entrega

La firma es un HMAC-SHA256 del cuerpo de la petición, calculado con tu secreto. Verifícala siempre por tu parte: calcula el HMAC-SHA256 del cuerpo recibido con el secreto y compáralo con la cabecera. Así confirmas que la petición vino realmente de Repost21. Tienes un ejemplo de verificación listo para usar en Node.js en el bloque «Inicio rápido» de la sección «Desarrolladores».

Consejo

Si tu servidor no responde a tiempo o devuelve un error, Repost21 reintentará la entrega — hasta 5 intentos con un intervalo creciente. Responde al webhook rápidamente (solo 200 OK) y realiza el procesamiento pesado de forma asíncrona.

Cualquier webhook se puede desactivar temporalmente con un interruptor sin eliminarlo — útil mientras depuras.

Autopublicación desde RSS

La autopublicación convierte los nuevos artículos de un feed RSS en publicaciones listas — sin que intervengas. Es ideal para un blog, un sitio de noticias o cualquier fuente con RSS.

1. En la sección «Desarrolladores», busca el bloque «Autopublicación desde RSS» y añade un feed — indica su URL. Se admiten los formatos RSS 2.0 y Atom.
2. Elige en qué redes sociales publicar, así como el tono y el idioma de las publicaciones.
3. Define la frecuencia con que se revisa el feed — por defecto se revisa cada 6 horas.

Cuando aparecen nuevos artículos en el feed, la IA los lee y prepara publicaciones adaptadas a las redes sociales elegidas. Por defecto, las publicaciones se crean como borradores — las revisas en el «Plan de contenido» y las publicas tú mismo. Si activas la autopublicación, las publicaciones irán directamente a las redes sociales sin revisión.

Nota

Las redes sociales para la autopublicación deben estar ya conectadas — consulta Conectar redes sociales.

Qué sigue

• La referencia completa de endpoints — REST API v1
• Trabajar con publicaciones y la programación en la interfaz — Publicaciones y plan de contenido
• Integraciones CRM (AmoCRM, Bitrix24, RetailCRM, Zapier, Make, Slack) — en desarrollo; en la sección «Desarrolladores» están marcadas como «Próximamente»