Posts
Publicar stories en la Página de Facebook con la API
Con format story e integration_slug facebook, Connect publica el medio como story en la Página que tu cliente conectó, con la misma llamada POST /posts de los otros formatos.
La llamada
POST /api/posts?customer_integration=<connection uuid>
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Idempotency-Key: <unique key>
{
"external_reference": "fb-story-23",
"format": "story",
"media": [
{
"type": "image",
"url": "https://cdn.example.com/story.jpg"
}
]
}Qué puedes hacer
- Publicar un story desde una URL https:// pública de imagen o video.
- Apuntar a la Página por conexión (customer_integration) o por integration_slug y source_name.
- Reintentar con seguridad usando Idempotency-Key.
Reglas y límites
- Los stories no llevan leyenda: no envíes caption.
- El formato story no tiene opciones en el bloque facebook.
- 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 y evita publicar dos veces la misma referencia en la cuenta (409).
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). |
Para quién
Avisos rápidos
El SaaS publica un story de promoción del día en la Página del cliente con un clic del usuario.
Cadena de tiendas
Publica el mismo arte vertical como story en las Páginas de varias sucursales.
Agente de IA
Un agente convierte un lanzamiento en una imagen vertical y la publica como story.
Funciona con
Facebook
Preguntas frecuentes
¿Puedo poner leyenda en el story?
No. Los stories no llevan leyenda.
¿Hay opciones extra del bloque facebook?
No para story. El bloque facebook tiene link en el feed y título y portada en reels.
¿Cómo sigo la publicación?
POST /posts responde 202. Consulta GET /posts/{uuid}.
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
