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
| 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. |
| caption | string | No | Texto del post. Hasta 2200 caracteres. Los stories no llevan leyenda. |
| media | array | Sí | Lista de medios, en orden. Cada ítem tiene type y url. |
| media.url | string | Sí | URL https:// pública que la red puede descargar (hasta 2048 caracteres). |
| facebook.title | string | No | Título del reel, hasta 255 caracteres. Solo en reels. |
| facebook.cover_url | string | No | URL 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.
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
