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

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).

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}.

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.