Ir al contenido

Conectar canales

Publicaciones y estadísticas de Instagram

Publicar y programar fotos, videos, carruseles, Reels e historias, y leer las estadísticas de la cuenta y de las publicaciones.

Esta página vale para cuentas de Instagram ya conectadas. Publicar exige el permiso instagram_content_publish; las estadísticas exigen instagram_manage_insights. Sin ellos, la ruta responde 403 instagram_scope_missing hasta que reconectes la cuenta.

Meta no programa publicaciones: Messajo guarda el pedido y publica a la hora marcada. En el panel, usa Publicaciones → Nueva publicación; por la API, POST /v1/publications.

Pantalla de nueva publicación con cuenta, tipo, archivo, texto con contadores y la elección entre publicar ahora y programar

type Archivo Nota
photo 1 imagen Publicación en el feed
video 1 video Se convierte en Reels con share_to_feed siempre activo (Meta descontinuó el video común en el feed)
reel 1 video Acepta portada (cover), thumb_offset_ms, share_to_feed y audio_name
carousel 2 a 20 elementos, imagen y/o video Un contenedor por elemento y uno para el carrusel
story 1 imagen o video Sin texto visible

Cada elemento llega por media_id (archivo enviado con POST /v1/media y purpose=publication) o por una url pública. También aceptan alt_text, user_tags, collaborators (hasta 3) y location_id.

Regla Valor
Texto hasta 2.200 caracteres, 30 hashtags y 20 menciones (@)
Imagen JPEG, hasta 8 MiB. PNG y WebP enviados por media_id se convierten a JPEG antes de publicar
Video MP4 o MOV, hasta 300 MiB (historias hasta 100 MiB)
Programación desde ahora hasta 75 días adelante
Cuota de Meta 100 publicaciones por cuenta en 24 h móviles (GET /v1/connections/{id}/publishing-limit)

Fuera de estas reglas, la respuesta es 422 validation_failed con el campo en details.

Meta descarga el archivo desde la URL: tiene que ser accesible desde internet. El media_id se convierte en un enlace firmado del almacenamiento S3 válido por 24 h. Una URL de red privada se rechaza con 422 media_url_not_public.

Un scheduled_at vacío (o dentro del próximo minuto) publica ahora; en el futuro, la publicación queda Programada y una tarea corre a la hora indicada, con un barrido cada minuto como red de seguridad. Mientras está scheduled o queued, se puede editar (PATCH /v1/publications/{id}) o cancelar (POST /v1/publications/{id}/cancel); después, publication_not_editable.

status Qué pasa
scheduled Esperando la hora marcada
queued En cola para publicar. Con la cuota de Meta llena, vuelve a intentar cada hora; pasadas 24 h de la hora, falla con publishing_limit_reached
creating Creando los contenedores en Meta
processing Meta está procesando el archivo. Más de 30 min falla con container_timeout
publishing Pidiendo la publicación
published Publicado, con external_media_id y permalink
failed Falló; el motivo viene en error (código de Messajo + código y estado de Meta)
canceled Cancelada por ti

Salen los eventos publication.published y publication.failed (catálogo).

Si Meta no responde al pedido de publicación (timeout, 5xx), no hay forma de saber si la publicación salió. Messajo no publica de nuevo: consulta el estado del contenedor en Meta. Si ya se publicó, marca published y busca la publicación; si el contenedor está listo y sin publicar, repite una vez; si todavía se procesa, espera. Si se publicó pero no se encontró la publicación, queda published sin external_media_id, y esa publicación no acepta retry. Una publicación failed común se puede repetir con POST /v1/publications/{id}/retry, que crea contenedores nuevos.

En el panel, Estadísticas muestra la cuenta elegida en 7, 28 o 90 días: alcance, visualizaciones, cuentas que interactuaron, interacciones, seguidores ganados y perdidos, la serie diaria y el público del mes. Debajo, las publicaciones con sus métricas.

Pantalla de estadísticas con las tarjetas de alcance e interacción, el gráfico diario y la tabla de publicaciones

Ruta /v1 Qué devuelve
GET /connections/{id}/insights Métricas de la cuenta: reach, views, accounts_engaged, total_interactions, likes, comments, shares, saves, replies, reposts, follows_and_unfollows, profile_links_taps (por día) y follower_demographics, engaged_audience_demographics
GET /connections/{id}/posts · /posts/{post_id} Publicaciones de la cuenta, con me gusta y comentarios
GET /connections/{id}/posts/{post_id}/insights Métricas de la publicación, según el tipo (feed, Reels o historia)
  • Retraso: Meta puede tardar hasta 48 h en actualizar los números. Messajo guarda cada consulta durante 15 min.
  • impressions fue descontinuada por Meta y se rechaza con validation_failed.
  • Un elemento de carrusel no tiene estadísticas propias: 422 insights_not_available. Tampoco una historia con audiencia de menos de 5 personas.
  • Historias: la métrica de una historia desaparece 24 h después de que vence y el webhook de estadísticas de historias está por confirmar en el inicio de sesión unificado. Por eso Messajo toma una foto de las historias activas cada hora; la estadística de una historia vencida viene de esa foto, con source: "snapshot" y la hora en captured_at (en el panel, “capturado a las …”).