Posts
Publicar en la Página de Facebook con la API
Con format feed e integration_slug facebook, Connect publica en la Página que tu cliente conectó. La misma llamada POST /posts sirve para texto, links o fotos.
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-post-901",
"format": "feed",
"caption": "Conheça a novidade da semana",
"media": [
{
"type": "image",
"url": "https://cdn.example.com/foto1.jpg"
},
{
"type": "image",
"url": "https://cdn.example.com/foto2.jpg"
}
]
}Qué puedes hacer
- Publicar un post solo de texto.
- Compartir un link con facebook.link.
- Publicar hasta 10 fotos en un único post.
- Apuntar a la Página por conexión (customer_integration) o por integration_slug y source_name.
Reglas y límites
- El feed necesita al menos leyenda, link o medios.
- La leyenda llega hasta 2200 caracteres.
- Un post con link no acepta medios.
- El video en el feed se rechaza: el video de Página va como reels.
- La respuesta es 202: la publicación corre en segundo plano. Síguela con GET /posts/{uuid}.
- external_reference es obligatorio (409 si ya existe una publicación igual) e Idempotency-Key evita duplicar.
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.link | string | No | Link compartido en el post (hasta 2048 caracteres). Solo en feed. Un post con link no lleva medios. |
Para quién
Gestor de redes sociales
El usuario escribe el post en tu SaaS y sale en la Página de Facebook que conectó.
Comunicados de tiendas
Una cadena de tiendas publica el mismo comunicado, con fotos, en decenas de Páginas.
Agente de IA
Un agente resume una noticia y publica el texto con el link en la Página del cliente.
Funciona con
Facebook
Preguntas frecuentes
¿Puedo publicar video en el feed de la Página?
No. El video va como reels. El feed acepta texto, link o fotos.
¿Cuántas fotos caben en un post?
Hasta 10. Un post con link no lleva medios.
¿Publica en un perfil personal?
No. Este formato es para Páginas de Facebook, con integration_slug facebook.
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
