Posts

Publicar stories en Instagram con la API

Con format story, Connect publica el medio como story en la cuenta de Instagram que tu cliente conectó. Es la misma llamada POST /posts de los otros formatos, para cualquier cuenta conectada.

La llamada

POST /api/posts?customer_integration=<connection uuid>
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Idempotency-Key: <unique key>

{
  "external_reference": "story-77",
  "format": "story",
  "media": [
    {
      "type": "image",
      "url": "https://cdn.example.com/story.jpg"
    }
  ],
  "instagram": {
    "collaborators": [
      "marca_parceira"
    ]
  }
}

Qué puedes hacer

  • Publicar un story desde una URL https:// pública de imagen o video.
  • Invitar colaboradores con instagram.collaborators.
  • Etiquetar usuarios en el medio con media[].user_tags.
  • Apuntar a la cuenta por customer_integration o por integration_slug y source_name.

Reglas y límites

  • Los stories no llevan leyenda: no envíes caption.
  • En el bloque instagram, el story acepta solo collaborators, hasta 5, sin @.
  • Hasta 10 medios por llamada, cada uno se convierte en una story, publicadas en orden. La red verifica todos los archivos antes de que salga el primero, así que un archivo con problemas no deja la secuencia a medias.
  • La respuesta es 202: la publicación corre en segundo plano. Síguela con GET /posts/{uuid}.
  • external_reference es obligatorio e Idempotency-Key evita duplicar la llamada.

Campos principales

CampoTipoObligatorioDescripción
external_referencestringSíEl id del post en tu sistema (hasta 100 caracteres). Evita publicar el mismo post dos veces en la misma cuenta.
formatstringSíFormato del post. En Instagram: feed, reels o story. En Facebook: feed, reels o story.
mediaarraySíLista de medios, en orden. Cada ítem tiene type y url.
media.typestringSíTipo de medio: image, video o document (documento solo en LinkedIn).
media.urlstringSíURL https:// pública que la red puede descargar (hasta 2048 caracteres).
instagram.collaboratorsarrayNoHasta 5 usuarios invitados como colaboradores, sin @. Vale en feed, reels y story.

Para quién

  • Avisos y promociones

    Tu SaaS publica un story de oferta relámpago en la cuenta del cliente en el momento en que el usuario pulsa publicar.

  • Herramienta de eventos

    Genera un story con el arte del evento para cada asistente y publícalo en la cuenta de cada uno.

  • Agente de IA

    Un agente convierte una noticia de la marca en una imagen vertical y la publica como story automáticamente.

Funciona con

  • Instagram Business
  • Instagram

Preguntas frecuentes

¿Puedo poner leyenda en un story?

No. Los stories no llevan leyenda; el texto debe ir en la propia imagen o video.

¿Qué opciones del bloque instagram valen en el story?

Solo collaborators. Las demás opciones son de feed y reels.

¿Funciona en cuentas instagram e instagram_business?

Sí, las dos conexiones aceptan format story.

Relacionadas

Ver todo lo que puedes hacer con Posts

Mira Connect aplicado a tu producto.

Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.