Saltar al contenido
Automatización y agentes

Programar Reels de Instagram con la API oficial: publicación automática sin alojar el video

Actualizado el 10 min de lectura

Lo esencial

  • Se hace con la API oficial de Instagram: no le das tu contraseña a ningún programa y no rompe las normas de la plataforma.
  • El video se envía directamente desde tu equipo con la subida reanudable de Meta: no hace falta alojarlo en un servidor.
  • Son cuatro llamadas: crear el contenedor, enviar el archivo, esperar a que Instagram lo procese y publicar.
  • Cuesta cero. Límite: 100 publicaciones por API cada 24 horas por cuenta.
  • Nivel: intermedio. Necesitas una cuenta profesional, una página de Facebook y una app de Meta propia.

Programar un Reel a mano funciona mientras publicas de vez en cuando. Si publicas cada día, o si tus videos los genera un programa, lo natural es que también sea un programa el que los suba a su hora.

Esta guía explica cómo hacerlo con la API oficial de Instagram. Es el método que usa Ctrl+IA para publicar sus Reels sin que nadie toque el teléfono.

Qué necesitas

  • Una cuenta de Instagram profesional (de creador o de empresa). El cambio es gratis, en los ajustes de la cuenta.
  • Una página de Facebook conectada a esa cuenta. Esta guía usa la variante de la API que entra por Facebook, y sin página no funciona.
  • Una cuenta de desarrollador de Meta, gratuita, para crear tu propia app.
  • Python 3. El programa no usa ninguna biblioteca externa.
  • Un video vertical que cumpla las especificaciones de Instagram (están más abajo).
  • Tiempo: una hora larga la primera vez. Casi todo se va en el panel de Meta.
  • Dinero: nada. La API no cobra por publicar.

Si ya montaste la respuesta automática por mensaje directo, la app y la página te sirven: solo hay que añadir un permiso.

Por qué no hace falta alojar el video

La forma clásica de publicar por API es darle a Instagram la dirección pública de tu video, para que lo descargue. Eso te obliga a subirlo antes a un servidor o a un almacenamiento en la nube.

La guía de publicación de Meta, consultada el 12 de octubre de 2026, ofrece otra vía para los Reels: la subida reanudable (resumable upload). Tu programa envía el archivo directamente a un servidor de Meta, rupload.facebook.com, desde tu equipo o desde cualquier máquina donde se ejecute. Nada queda publicado en ningún sitio intermedio.

Según esa misma página, la subida reanudable solo está disponible para las apps que usan el inicio de sesión de Facebook para empresas. Es la variante que usa esta guía.

Cómo funciona

Publicar un Reel por API son cuatro pasos, siempre en este orden:

  1. Crear un contenedor. Le dices a Instagram que va a llegar un Reel, con su texto, y te devuelve un identificador.
  2. Enviar el archivo a ese contenedor.
  3. Esperar a que Instagram procese el video. El contenedor pasa de IN_PROGRESS a FINISHED, o a ERROR si algo falla. Meta recomienda consultar el estado una vez por minuto, durante cinco minutos como mucho.
  4. Publicar el contenedor. Hasta este paso, nadie ve nada.

Un contenedor que no se publica en 24 horas caduca solo (estado EXPIRED). Eso permite un modo de ensayo muy útil: haces los tres primeros pasos, compruebas que Instagram aceptó y procesó tu video, y no publicas.

Paso 1 · Prepara la app de Meta

  1. Entra en developers.facebook.com/apps y crea una app con el caso de uso de administrar mensajes y contenido en Instagram. Dentro de él, elige la configuración con inicio de sesión de Facebook (API setup with Facebook Login): según la página de Meta sobre ese caso de uso, consultada el 12 de octubre de 2026, cada app admite una sola de las dos configuraciones, y la subida reanudable solo funciona con esta.
  2. En el Explorador de la API Graph, genera una clave de usuario con los permisos que pide la guía de publicación: instagram_basic, instagram_content_publish y pages_read_engagement. Añade pages_show_list para poder ver tus páginas en el paso siguiente. Si el acceso a la página te lo dieron a través de un portfolio comercial (Business Manager), esa misma guía, releída el 20 de octubre de 2026, pide además ads_management y ads_read.
  3. Al autorizar, marca solo la página y la cuenta de este proyecto. Si administras otras páginas, déjalas fuera.
  4. Cambia esa clave, que dura poco, por una de larga duración: una llamada a oauth/access_token con grant_type=fb_exchange_token, el identificador y la clave secreta de tu app (client_id y client_secret) y la clave temporal (fb_exchange_token). Lo explica la página de Meta sobre claves de larga duración, consultada el 12 de octubre de 2026, que pide hacer esa llamada desde tu equipo o tu servidor, nunca desde una página web, porque lleva la clave secreta.
  5. Con la clave de larga duración, pide la lista de tus páginas (me/accounts). De la respuesta necesitas la clave de la página (access_token) y el identificador de la cuenta de Instagram conectada (campo instagram_business_account).

La clave que usa el programa es la de la página. Trátala como una contraseña: va en una variable de entorno, nunca escrita en el código ni en un repositorio.

Paso 2 · Publica tu app

Este paso no impide publicar, y por eso es fácil pasarlo por alto. La página de Meta sobre los modos de una app, consultada el 12 de octubre de 2026, dice que lo que genera una app en modo de desarrollo solo lo ven las personas con un rol en ella, y que se vuelve visible para los demás cuando la app pasa a modo en vivo.

Nos pasó con los Reels que la app subía a Facebook: para la API figuraban como publicados y públicos, pero nadie fuera de la app los veía. Para pasarla a modo en vivo, el panel de la app nos pidió rellenar en la configuración básica la política de privacidad, las condiciones, las instrucciones para eliminar datos, la categoría y el icono. Al publicarla, los videos ya subidos se hicieron visibles sin volver a subirlos.

Paso 3 · Comprueba tu video

La referencia de la API, consultada el 12 de octubre de 2026, fija estas condiciones para un Reel:

  • Archivo MP4 o MOV, con la información del archivo al principio (moov atom at the front).
  • Video H.264 o HEVC, de 23 a 60 fotogramas por segundo y como mucho 1.920 píxeles de ancho. Recomienda la proporción 9:16.
  • Sonido AAC, a 48 kHz como máximo y en mono o estéreo.
  • De 3 segundos a 15 minutos, y 300 MB como máximo.
  • El texto admite hasta 2.200 caracteres, 30 hashtags y 20 menciones.

Si generas el video con FFmpeg, la opción -movflags +faststart coloca esa información al principio del archivo.

Paso 4 · El programa

Guárdalo como publicar_reel.py.

"""Publica un Reel en tu cuenta de Instagram desde tu equipo, con la API oficial y sin alojar el video."""
import json, os, sys, time, urllib.error, urllib.parse, urllib.request

API = "https://graph.facebook.com/v25.0"
SUBIDAS = "https://rupload.facebook.com/ig-api-upload/v25.0"
CLAVE = os.environ["INSTAGRAM_ACCESS_TOKEN"]  # la clave de tu página de Facebook
CUENTA = os.environ["INSTAGRAM_USER_ID"]      # el identificador de tu cuenta de Instagram
ENSAYO = os.environ.get("ENSAYO") == "1"      # con ENSAYO=1 sube y procesa, pero no publica


def llamar(url, cuerpo=None, cabeceras=None):
    cabeceras = {"Authorization": f"Bearer {CLAVE}", **(cabeceras or {})}
    try:
        with urllib.request.urlopen(urllib.request.Request(url, cuerpo, cabeceras), timeout=300) as respuesta:
            return json.load(respuesta)
    except urllib.error.HTTPError as error:
        sys.exit(f"Meta respondió con el error {error.code}: {error.read().decode()}")


def formulario(**campos):
    return urllib.parse.urlencode(campos).encode()


video, texto = sys.argv[1], sys.argv[2]

# 1. El contenedor: le dice a Instagram que va a llegar un Reel y con qué texto.
contenedor = llamar(f"{API}/{CUENTA}/media", formulario(
    media_type="REELS", upload_type="resumable", caption=texto))["id"]

# 2. El archivo, enviado desde tu equipo: no hace falta alojarlo en ningún sitio.
with open(video, "rb") as archivo:
    contenido = archivo.read()
llamar(f"{SUBIDAS}/{contenedor}", contenido, {
    "Authorization": f"OAuth {CLAVE}", "offset": "0", "file_size": str(len(contenido))})

# 3. Esperar a que Instagram lo procese. Meta pide consultar una vez por minuto, cinco minutos como mucho.
for _ in range(5):
    time.sleep(60)
    estado = llamar(f"{API}/{contenedor}?fields=status_code")["status_code"]
    if estado != "IN_PROGRESS":
        break
if estado != "FINISHED":
    sys.exit(f"Instagram no terminó de procesar el video: {estado}")

if ENSAYO:
    sys.exit("Ensayo correcto: Instagram aceptó y procesó el Reel. No se publicó.")

# 4. Publicar.
publicado = llamar(f"{API}/{CUENTA}/media_publish", formulario(creation_id=contenedor))["id"]
print("Publicado:", llamar(f"{API}/{publicado}?fields=permalink")["permalink"])

Se usa así, con las dos claves en variables de entorno:

ENSAYO=1 python3 publicar_reel.py reel.mp4 "Texto de la publicación #hashtag"

Empieza siempre con ENSAYO=1. Si dice “Ensayo correcto”, quítalo y vuelve a ejecutarlo para publicar de verdad. El contenedor del ensayo se queda sin publicar y caduca solo.

Paso 5 · Que publique a su hora

La API no tiene un campo para decir “publica el martes a las ocho”: publica en el momento en que se llama. Para programar, hay que ejecutar el programa a la hora que quieras. Sirve el programador de tareas de tu sistema o una tarea programada en la nube.

Lo que aprendimos con eso:

  • Las tareas programadas de GitHub Actions no salen a su hora. En nuestras pruebas llegaron con cuatro a seis horas de retraso. Lo resolvimos con un disparador programado de Cloudflare, gratuito, que le pide a GitHub que lance la tarea al minuto.
  • Protégete de publicar dos veces. Si una tarea se repite, el Reel sale duplicado. Nosotros usamos dos defensas: anotamos cada publicación en un archivo y no publicamos lo que ya está anotado, y antes de publicar pedimos las últimas publicaciones de la cuenta (<tu cuenta>/media?fields=caption) para comprobar que ninguna lleva el mismo texto.
  • Vigila el límite. La guía de Meta dice que cada cuenta puede publicar 100 veces por API en 24 horas. Más abajo, en la parte de carruseles, la misma página habla de 50. Con uno o dos Reels al día no importa, pero si publicas mucho, consulta tu uso con <tu cuenta>/content_publishing_limit.

Si además quieres que quien comente reciba un enlace, combínalo con la guía de respuestas por mensaje directo. Y si te interesa que la parte de escribir también se haga sola, mira cómo funcionan las rutinas de Claude Code.

Qué se comprobó

  • Probado en producción, el 7 de octubre de 2026: la subida reanudable de un Reel desde un equipo, con un ensayo que Instagram aceptó y procesó sin publicarlo, y ese mismo día la primera publicación real. Desde el 9 de octubre, el proyecto publica así sus Reels cada día desde una tarea de GitHub.
  • El programa de esta página, tal cual, se ejecutó el 12 de octubre de 2026 de dos formas: contra la API real de Meta con una clave falsa, que respondió con un error de clave no válida (la llamada llegó bien formada), y contra un servidor de prueba en el propio equipo que imita las respuestas de Meta, donde recorrió los cuatro pasos y el ensayo. No se publicó ningún Reel con él. Hace las mismas llamadas que el programa del proyecto; la diferencia es que envía la clave en una cabecera en lugar de en el cuerpo de la petición.
  • Sobre la revisión de Meta: la guía de publicación admite el acceso estándar y no exigió revisar la app para publicar en nuestra propia cuenta. No podemos garantizar que siga siendo así.
  • No se probó con videos largos ni pesados. Con archivos grandes, la subida puede cortarse: la subida reanudable permite continuar desde el byte donde se quedó, cambiando la cabecera offset, y este programa corto no lo hace.

Errores comunes

  • El estado se queda en ERROR. Casi siempre es el video: revisa formato, duración y que la información del archivo esté al principio.
  • Usar la clave de usuario, o sacar la de la página sin el cambio a larga duración (paso 1). La clave temporal caduca en horas, y la de página que sale de ella, también. La que sale de una clave de larga duración no tiene fecha de caducidad según Meta, aunque puede invalidarse en algunos casos y el permiso para leer datos hay que renovarlo cada cierto tiempo.
  • Dejar la app en modo de desarrollo. Publica sin errores, pero lo que sube puede no verlo nadie más (paso 2).
  • Usar un programa que pide tu contraseña de Instagram. No es la API oficial: va contra las normas de la plataforma y pone la cuenta en riesgo.
  • Publicar sin ensayar. El video de un Reel publicado no se puede cambiar: si sale con un fallo, hay que borrarlo y publicarlo de nuevo.

Esta guía es independiente: Ctrl+IA no tiene relación con Meta ni con Instagram. Lo que configures en tu cuenta lo haces bajo tu responsabilidad.

Recibe los prompts nuevos por correo

Al confirmar te llevas de regalo un PDF con los 62 prompts del sitio, listos para copiar. Sin spam, y te das de baja cuando quieras.

Te pediremos confirmar por correo. Al suscribirte aceptas la política de privacidad. Los envíos se gestionan con Kit.

Sigue con