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
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| external_reference | string | Sí | El id del post en tu sistema (hasta 100 caracteres). Evita publicar el mismo post dos veces en la misma cuenta. |
| format | string | Sí | Formato del post. En Instagram: feed, reels o story. En Facebook: feed, reels o story. |
| caption | string | No | Leyenda. En Instagram, hasta 2200 caracteres, 30 hashtags y 20 menciones. Los stories no llevan leyenda. |
| media | array | Sí | Lista de medios, en orden. Cada ítem tiene type y url. |
| media.url | string | Sí | URL https:// pública que la red puede descargar (hasta 2048 caracteres). |
| instagram.trial_graduation_strategy | string | No | Publica 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_feed | boolean | No | Si 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.
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
