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
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| external_reference | string | Sí | El id del post en tu sistema (hasta 100 caracteres). Evita publicar el mismo post dos veces en la misma cuenta. |
| format | string | Sí | Formato del post. En Instagram: feed, reels o story. En Facebook: feed, reels o story. |
| media | array | Sí | Lista de medios, en orden. Cada ítem tiene type y url. |
| media.type | string | Sí | Tipo de medio: image, video o document (documento solo en LinkedIn). |
| media.url | string | Sí | URL https:// pública que la red puede descargar (hasta 2048 caracteres). |
| instagram.collaborators | array | No | Hasta 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.
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
