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

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

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.