Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

Cómo conectar una cuenta de Instagram a una API o a un agente de IA

Una cuenta de Instagram se conecta a una API o a un agente de IA mediante Instagram Login. El titular inicia sesión con una cuenta profesional, Business o Creator, y aprueba los cinco permisos de la app, que cubren el acceso básico, la publicación, los comentarios, los mensajes y las métricas; después la app recibe un token de 60 días, renovable por otros 60. Para los mensajes directos, la cuenta también activa Permitir acceso a los mensajes en la app de Instagram.

easyCoexistence conecta una cuenta de Instagram Business o Creator en un solo inicio de sesión con el login propio de Instagram, mantiene su acceso renovado y lo verifica cada 6 horas, para que Claude, ChatGPT o tu propia plataforma puedan publicar, programar, responder comentarios y mensajes directos y leer métricas a través de la API oficial de Meta.

5 permissions

Lista de Meta para el producto de Instagram: instagram_business_basic, content_publish, manage_comments, manage_insights y manage_messages.

1 hour

Tiempo de validez del código de autorización del login de Instagram; solo puede canjearse una vez.

60 days

Validez del token de acceso de larga duración de Instagram User, que puede renovarse por otros 60 días.

1 hour

Tiempo que funciona un enlace de conexión de easyCoexistence antes de que expire su sesión.

¿Qué cuentas pueden conectarse?

Cuentas profesionales de Instagram, Business o Creator. La API de Meta atiende a ambos tipos por igual para publicar, comentar, mensajes directos y métricas; una cuenta personal primero pasa a profesional en la app de Instagram, en Tipo de cuenta y herramientas. Con Instagram Login, el titular inicia sesión con sus propias credenciales de Instagram, en la página de login de Instagram.

¿Qué ve el titular al iniciar sesión?

La ventana de login de Instagram. La app envía al titular a https://www.instagram.com/oauth/authorize con su ID de app de Instagram, un redirect URI y los permisos que solicita; el titular inicia sesión, los revisa y los aprueba. Instagram devuelve entonces a la app un código, válido durante una hora y de un solo uso, que el servidor de la app canjea por un token. Un inicio de sesión cancelado regresa con error=access_denied.

¿Para qué sirve cada permiso?

Cada función necesita instagram_business_basic más un permiso propio, y el titular los aprueba juntos en la misma ventana. easyCoexistence solicita estos cinco, el conjunto que Meta indica para el producto de Instagram, para que un agente pueda publicar, responder y medir en la cuenta:

instagram_business_basicThe profile and media; needed with each of the others
instagram_business_content_publishPublishing photos, carousels, Reels and Stories
instagram_business_manage_commentsReading, replying to, hiding and deleting comments, private replies and mentions
instagram_business_manage_messagesReading and replying to DMs
instagram_business_manage_insightsAccount and post metrics

¿Cómo activas los mensajes directos?

En la app de Instagram, abre Configuración, luego Mensajes y respuestas a historias, Controles de mensajes y Herramientas conectadas, y activa Permitir acceso a los mensajes. Meta exige este interruptor antes de que una app pueda gestionar los mensajes directos de la cuenta; mientras esté desactivado, los envíos fallan aunque el permiso de mensajes esté concedido, mientras que la publicación y los comentarios funcionan con normalidad.

¿Cómo se conecta a easyCoexistence?

Desde el panel, en un solo inicio de sesión: elige Nueva conexión, luego Instagram, e inicia sesión con la cuenta profesional. Si una cuenta no tiene tarjeta registrada, se le pide una primero, ya que cada conexión se factura. Cuando Instagram devuelve el control, la página del canal muestra Conectado; easyCoexistence suscribe la cuenta a sus eventos de comentarios, menciones y mensajes directos, renueva su acceso antes de que se cumplan los 60 días y lo verifica cada 6 horas.

1New connectionIn the easyCoexistence dashboard
2InstagramInstagram's own login window opens
3ApproveThe professional account and its five permissions
4ConnectedReady for Claude, ChatGPT or your code

¿Cómo conecta una plataforma las cuentas de sus clientes?

Con un enlace de conexión alojado desde la API de Partner. Tu backend envía un POST a /api/v1/connect-sessions con channel igual a instagram y un redirect_url, y luego envía al cliente a la url que devuelve; el cliente inicia sesión con Instagram allí, sin una cuenta propia de easyCoexistence. El navegador regresa con la sesión, el estado y el nuevo channel_id, que tu backend confirma con GET /connect-sessions/:id antes de confiar en ellos.

Create a connect session for an Instagram account
curl -X POST https://easycoexistence.com/api/v1/connect-sessions \
  -H "Authorization: Bearer $EC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "instagram",
    "redirect_url": "https://app.example.com/connect/return",
    "external_ref": "customer_4821"
  }'

¿Qué ocurre después de conectarse?

La cuenta queda lista para lo que se haga con ella. list_social_accounts la devuelve a Claude, ChatGPT o a tu propio agente, get_social_credentials entrega su ID y su base de API a tu código, y sus eventos de comentarios, menciones y mensajes directos llegan a tu endpoint una vez lo configures, con set_social_webhook_destination o PUT /api/v1/channels/:id/webhook.

¿Por qué podría fallar una conexión?

Normalmente por uno de cuatro motivos, cada uno con una solución directa:

  • La cuenta es personal: cámbiala a Business o Creator en la app de Instagram.
  • El titular canceló el inicio de sesión: no se conecta nada, y al volver a empezar se abre una ventana nueva.
  • La cuenta ya está conectada a otra cuenta de easyCoexistence: elimínala allí primero.
  • Se abrió el enlace de conexión después de su hora: crea una sesión nueva.

Cómo configurarlo

  1. Make the account professionalIn the Instagram app, switch to a Business or Creator account under Account type and tools.
  2. Start the connectionIn the easyCoexistence dashboard, choose New connection, then Instagram.
  3. Approve the permissionsLog in with the professional account and approve the five permissions Instagram shows.
  4. Allow access to messagesTurn on Allow access to messages under Connected tools in the Instagram app, so DMs work.
  5. Point your AI at itAdd https://easycoexistence.com/api/mcp to Claude or ChatGPT, or call the account from your own code.

Errores comunes

  • Aprobar la cuenta equivocada. La ventana de Instagram inicia sesión con la cuenta que ya está abierta en ese navegador, así que cambia de cuenta allí antes de conectar.
  • Confiar en el estado de la redirección por sí solo. Cualquiera puede escribir status=connected en una URL, así que confirma la sesión con GET /connect-sessions/:id desde tu backend.
  • Enviar webhook_url en una sesión de conexión de Instagram. La API lo rechaza en ese punto; configura el relé de eventos de la cuenta con PUT /api/v1/channels/:id/webhook una vez conectada.
Hacerlo con EasyCoexistence

De US$ 9 a US$ 0.75 por conexión al mes, bajando a medida que añades conexiones, con los primeros 3 días gratis.

Preguntas frecuentes

¿Necesito mi propia app de desarrollador de Meta para conectarme?

No. La app de Meta de easyCoexistence tiene los permisos de Instagram, así que el titular inicia sesión con Instagram y los aprueba, sin app propia, App Review ni verificación de empresa.

¿Puede conectarse una cuenta Creator?

Sí. Las cuentas Business y Creator se conectan ambas, y la API de Meta las trata igual para publicar, comentar, mensajes directos y métricas.

¿Puedo conectar varias cuentas de Instagram?

Sí, cada una con su propio inicio de sesión. Cada cuenta es una conexión, facturada de US$ 9 a US$ 0.75 por conexión al mes a medida que crece tu total.

¿Qué pasa si la cuenta ya está conectada en otro lugar?

No puede unirse a una segunda cuenta de easyCoexistence mientras esté activa en la primera, lo que impide que alguien que controle el Instagram la aparte de una cuenta de pago. Elimínala allí y luego vuelve a conectarla.

Sigue leyendo

Conecta tu primer canal en dos minutos.

Sin esperar revisiones de las plataformas. Conecta WhatsApp, Instagram, TikTok u otro canal, pídele a tu IA que publique, responda o te haga un informe, y míralo trabajar.

  • 3 días gratis
  • Cancela cuando quieras
  • Solo APIs oficiales
  • Monitorizado 24/7

Verificado el