Connect
Sistemas

Instagram

Conecta una cuenta profesional de Instagram con OAuth directo para publicar imágenes, carruseles o un Reel MP4 aprobado. Beta privada por organización; no admite cuentas de consumidor ni Stories.

Beta privada por organización, pendiente de piloto real. Emisso habilita las organizaciones invitadas. El acceso fuera de las cuentas de prueba depende también de App Review y de los permisos y requisitos que Meta apruebe para la aplicación del piloto. Habilitar la beta no acredita esas aprobaciones ni una publicación real.

instagram conecta una cuenta profesional Business o Creator por conexión, mediante Instagram Login directo. Este requisito también se aplica a una cuenta personal de trabajo de su titular: una cuenta de consumidor no es compatible. La beta publica imágenes JPEG individuales, carruseles de imágenes o un Reel MP4 y verifica publicaciones conocidas; no sincroniza historial ni obtiene métricas.

Conectar la cuenta profesional

Para participar, necesitas una cuenta en Instagram profesional que controles y una organización de Connect donde seas propietario o administrador. Si la cuenta representa a una empresa, debes tener permiso sobre ella para autorizar su uso.

Crea la conexión desde Conexiones, Conectar, Explorar aplicaciones, Instagram. Durante la beta el alta se realiza en el panel, sin enlaces de conexión alojados. La sección de autorización pide un solo dato opcional:

CampoQué es
RUT de la empresa, si correspondeIdentifica a la empresa representada. Puede omitirse si no corresponde; Instagram no confirma ese RUT.

El navegador sale a Instagram para que apruebes el acceso y vuelve a Connect. Connect no pide tu contraseña: conserva cifrado el permiso emitido, exclusivamente en el servidor. Comprueba con ese mismo permiso que la cuenta sea profesional y fija su ID profesional, aunque Meta entregue otros identificadores de la misma cuenta durante la autorización.

La persona que declara la conexión debe completar el OAuth y su reautorización. Otro administrador no puede vincular su propia cuenta en ella. Una vez autorizada, la conexión conserva la misma cuenta; para un destino diferente crea otra conexión.

Permisos y vigencia

Permiso del proveedorUso
instagram_business_basicComprobar la identidad profesional y leer el estado de publicaciones conocidas.
instagram_business_content_publishPreparar y publicar las imágenes, el carrusel o el Reel aprobado.

El piloto utiliza una aplicación dedicada a esta integración y esos permisos mínimos. Si falta uno o la concesión incluye permisos adicionales no admitidos, Connect rechaza la autorización; no los recorta silenciosamente.

Connect intercambia el permiso inicial por uno de larga duración y guarda su fecha real de vencimiento. Puede renovarlo antes de vencer cuando el proveedor lo permita, sin prometer acceso indefinido. Un permiso caducado o revocado exige volver a consentir. Programar contenido no garantiza que la autorización siga vigente en la fecha de envío.

Delegación de la organización

La conexión pertenece a la organización elegida. Sus propietarios o administradores pueden otorgar una clave con el permiso explícito de publicar y acceso a esa conexión. Esa clave puede ejecutar directamente como la cuenta conectada, aunque su creador sea otro administrador: no pasa por la aprobación editorial de Cockpit. Para aislar una cuenta personal, elige cuidadosamente la organización y las conexiones accesibles desde cada clave.

El calendario de Contenido conserva su propio flujo de revisión y aprobación del responsable. Una aprobación editorial y un permiso de ejecución por API son autorizaciones distintas.

Tools y permisos de tu clave

ToolPermiso de ConnectQué hace
instagram.conexion.verificarinstagram:identityComprueba que el permiso siga correspondiendo a la cuenta profesional fijada.
instagram.publicacion.publicarinstagram:publishPublica una imagen JPEG, un carrusel de imágenes o un Reel MP4 aprobado con su texto.
instagram.publicacion.verificarinstagram:readonlyConsulta una publicación o contenedor conocido de la cuenta y comprueba su estado.

Cada llamada lleva el connectionId. Los permisos de Connect deben nombrarse explícitamente: * y los perfiles generales de claves no los incluyen. Además, la conexión necesita los permisos efectivos del proveedor. Limita la clave a las conexiones que deba operar; consulta autenticación y permisos.

Formatos y confirmación

La llamada admite una imagen o un carrusel de hasta veinte imágenes JPEG; el calendario editorial limita el carrusel a diez. Las URLs deben ser HTTPS públicas, directas, sin credenciales ni parámetros secretos, y Meta debe poder descargar los archivos al preparar la publicación. Una publicación de solo texto no es compatible.

También se admite un único video MP4 de hasta 100 MiB, publicado como Reel con distribución al feed. No se mezcla con imágenes. Connect comprueba el tipo y los bytes; los requisitos de codecs, duración y proporción siguen sujetos a la aceptación de Meta. No se ofrecen portadas personalizadas, Stories ni carruseles mixtos. Los formatos no implementados responden validation_error antes del envío. Las imágenes individuales y cada imagen del carrusel transmiten su texto alternativo cuando se proporciona.

REST/MCP espera el procesamiento del contenedor dentro del tiempo de esa llamada, sin una outbox audiovisual entre llamadas. Si no termina, no ejecuta la publicación final. Cockpit sí conserva el contenedor para continuar su procesamiento en otra corrida, bajo la misma aprobación. Un contenedor listo no equivale a un medio publicado y sus identificadores se guardan por separado.

La beta tampoco ofrece analítica, comentarios, mensajes directos, búsqueda de historial ni edición o borrado de publicaciones.

La persona debe aprobar medios, texto y cuenta de destino antes de ejecutar instagram.publicacion.publicar. Esa operación exige una Idempotency-Key UUID v4 estable. Preparar un contenedor o recibir una respuesta aceptada no significa que el contenido ya esté visible.

Connect solo informa publicado después de una lectura GET independiente del medio, con cuenta y contenido coincidentes. Un contenedor terminado puede seguir pendiente de publicación. Si se pierde la respuesta final, conserva el identificador conocido y solicita revisión: no crea otro envío por parecido del caption ni por una clave nueva. instagram.publicacion.verificar comprueba ese ID; un resultado pendiente o desconocido no permite volver a publicar.

Las tools no programan publicaciones. El calendario editorial de Emisso mantiene su propia revisión, aprobación y programación; una cuenta conectada no publica por sí sola.

Reautorizar o desconectar

En Ajustes de la conexión, usa Volver a autorizar con la misma persona responsable y la misma cuenta profesional. El tipo profesional y los permisos se vuelven a comprobar.

Eliminar la conexión corta su uso en Connect. Para revocar también el consentimiento del lado de Meta, retira la aplicación desde las aplicaciones autorizadas de Instagram.

El contrato completo está en la referencia de Instagram. Para ejecutar las tools desde un agente, consulta MCP.

En esta página