Posts

Publicar trial reels en Instagram con la API

Un trial reel se muestra primero a quienes aún no siguen la cuenta. Con format reels e instagram.trial_graduation_strategy, Connect publica el reel en ese modo, sin app review y sin manejar tokens.

La llamada

POST /api/posts?customer_integration=<connection uuid>
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Idempotency-Key: <unique key>

{
  "external_reference": "reel-trial-12",
  "format": "reels",
  "caption": "Teste novo: o que acha?",
  "media": [
    {
      "type": "video",
      "url": "https://cdn.example.com/trial.mp4"
    }
  ],
  "instagram": {
    "trial_graduation_strategy": "SS_PERFORMANCE"
  }
}

Qué puedes hacer

  • Publicar un reel como trial reel con una sola opción, trial_graduation_strategy.
  • Elegir MANUAL para que la cuenta decida si promueve el reel al perfil.
  • Elegir SS_PERFORMANCE para que Instagram lo promueva solo si rinde bien.
  • Combinarlo con portada, audio, colaboradores y primer comentario, como en cualquier reel.

Reglas y límites

  • trial_graduation_strategy solo vale con format reels y acepta MANUAL o SS_PERFORMANCE.
  • Reels acepta exactamente 1 video.
  • La respuesta es 202: la publicación corre en segundo plano. Síguela con GET /posts/{uuid}.
  • external_reference es obligatorio e Idempotency-Key permite repetir la llamada sin 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.
captionstringNoLeyenda. En Instagram, hasta 2200 caracteres, 30 hashtags y 20 menciones. 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).
instagram.trial_graduation_strategystringNoPublica como trial reel. MANUAL: la cuenta decide si lo promueve al perfil. SS_PERFORMANCE: Instagram lo promueve si rinde bien. Solo en reels.
instagram.share_to_feedbooleanNoSi el reel también aparece en la grilla del perfil. Solo en reels.

Para quién

  • Pruebas de contenido

    Tu SaaS publica variaciones de un video como trial reels para medir el alcance entre no seguidores antes de ir al perfil.

  • Agencia

    Valida creativos de varios clientes: SS_PERFORMANCE promueve solo los que rindan bien.

  • Agente de IA de growth

    Un agente publica un lote de reels de prueba y, con MANUAL, deja la decisión final a la cuenta.

Funciona con

  • Instagram Business
  • Instagram

Preguntas frecuentes

¿Qué es un trial reel?

Es un reel que se muestra primero a no seguidores. Tú defines cómo se promueve al perfil: MANUAL o SS_PERFORMANCE.

¿Cuál es la diferencia entre MANUAL y SS_PERFORMANCE?

Con MANUAL la cuenta decide si promueve el reel al perfil. Con SS_PERFORMANCE Instagram lo promueve automáticamente si rinde bien.

¿Puedo usar trial_graduation_strategy en feed o story?

No. La opción solo vale en reels.

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.