Posts

Publicar reels en la Página de Facebook con la API

Con format reels e integration_slug facebook, Connect publica un reel en la Página que tu cliente conectó. El video de Página en Facebook va por este formato.

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-reel-55",
  "format": "reels",
  "caption": "Bastidores da loja",
  "media": [
    {
      "type": "video",
      "url": "https://cdn.example.com/reel.mp4"
    }
  ],
  "facebook": {
    "title": "Bastidores",
    "cover_url": "https://cdn.example.com/capa.jpg"
  }
}

Qué puedes hacer

  • Publicar un reel desde una URL de video https:// pública.
  • Definir el título con facebook.title.
  • Elegir la portada con facebook.cover_url.
  • Apuntar a la Página por conexión o por integration_slug y source_name.

Reglas y límites

  • Reels acepta exactamente 1 video.
  • El título llega hasta 255 caracteres.
  • Si la red rechaza la imagen de cover_url, el reel sale con la portada que ella elija.
  • 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 publicación.

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.
captionstringNoTexto del post. Hasta 2200 caracteres. Los stories no llevan leyenda.
mediaarraySíLista de medios, en orden. Cada ítem tiene type y url.
media.urlstringSíURL https:// pública que la red puede descargar (hasta 2048 caracteres).
facebook.titlestringNoTítulo del reel, hasta 255 caracteres. Solo en reels.
facebook.cover_urlstringNoURL https:// de la portada del reel. Si la red rechaza la imagen, el reel sale con la portada que ella elija. Solo en reels.

Para quién

  • Herramienta de video

    Tu SaaS publica el video corto exportado directo en la Página del cliente, con título y portada.

  • Agencia

    Publica el mismo reel en las Páginas de varios clientes con una llamada por conexión.

  • Agente de IA

    Un agente genera el video, define el título y publica el reel sin intervención.

Funciona con

  • Facebook

Preguntas frecuentes

¿Por qué no puedo enviar video en el feed?

El feed de la Página rechaza video: el video de Página va como reels.

¿Puedo elegir la portada?

Sí, con facebook.cover_url. Si la red rechaza la imagen, el reel sale con la portada que ella elija.

¿Cuántos videos por reel?

Exactamente 1.

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.