# 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](/es/connect/instagram/). Publicar exige el permiso `instagram_content_publish`; las estadísticas exigen `instagram_manage_insights`. Sin ellos, la ruta responde `403` [`instagram_scope_missing`](/es/errors#instagram_scope_missing) hasta que reconectes la cuenta.

## 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`.

![Pantalla de nueva publicación con cuenta, tipo, archivo, texto con contadores y la elección entre publicar ahora y programar](../../../../assets/screenshots/publication-composer-es.png)

### Tipos

| `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

| 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`](/es/errors#validation_failed) con el campo en `details`.

### 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`](/es/errors#media_url_not_public).

### 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`](/es/errors#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`](/es/errors#publishing_limit_reached) |
| `creating` | Creando los contenedores en Meta |
| `processing` | Meta está procesando el archivo. Más de 30 min falla con [`container_timeout`](/es/errors#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](/es/webhooks/events/#catálogo)).

### 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

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](../../../../assets/screenshots/insights-es.png)

| 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`](/es/errors#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 …").
