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.
Publicar
Sección titulada «Publicar»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.

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.
Límites
Sección titulada «Límites»| 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.
URL pública
Sección titulada «URL pública»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.
Programación y estado
Sección titulada «Programación y estado»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).
Nunca repite a ciegas
Sección titulada «Nunca repite a ciegas»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.
Estadísticas
Sección titulada «Estadísticas»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.

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.
impressionsfue descontinuada por Meta y se rechaza convalidation_failed.- Un elemento de carrusel no tiene estadísticas propias:
422insights_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 encaptured_at(en el panel, “capturado a las …”).