Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

Cómo permitir que tus clientes conecten Instagram a tu app

Tu backend llama a POST /connect-sessions de easyCoexistence con channel instagram y envía al cliente a la url devuelta, donde inicia sesión con Instagram Login en una cuenta Business o Creator. Vuelve a tu redirect_url con un channel_id, y GET /channels/{id}?credentials=1 devuelve un token para graph.instagram.com, para que tu app pueda publicar, leer comentarios y responder DMs.

100 posts

Publicaciones enviadas por API que una cuenta de Instagram puede hacer en cualquier periodo móvil de 24 horas; un carrusel cuenta como una.

JPEG

El único formato de imagen que Meta admite para publicar en Instagram a través de la API.

24 hours

Ventana estándar para responder a un DM de Instagram de una persona, para la mayoría de acciones del usuario; la persona debe escribir primero.

1 private reply

Mensajes que una cuenta puede enviar a quien comentó mediante una respuesta privada, dentro de los 7 días posteriores al comentario.

1 hour

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

¿Qué hace el cliente para conectarse?

Pulsa un solo botón. Tu app crea la sesión con channel en instagram, un redirect_url y el id de tu cliente como external_ref, y luego lo envía a su url. La página alojada muestra tu nombre y Continuar con Instagram, que abre el propio inicio de sesión de Instagram en la misma pestaña, así que funciona en teléfonos. El cliente aprueba el acceso y llega a tu redirect_url con status=connected y el channel_id, que tu backend confirma con GET /connect-sessions/{id}.

1Your appPOST /connect-sessions with channel instagram
2Hosted pageYour name and Continue with Instagram
3Instagram LoginThe professional account approves access
4Back to youredirect_url with status and channel_id

¿Qué cuentas de Instagram pueden conectarse?

Cuentas profesionales, Business o Creator, que es lo que sirve la API de Instagram de Meta. Una cuenta ya conectada a través de otro servicio que usa easyCoexistence se rechaza, y el last_error de la sesión lo indica; el cliente la elimina allí primero o inicia sesión con otra. Para los DMs, la cuenta también activa Permitir acceso a los mensajes en la app de Instagram, y la guía de conexión de Instagram indica el camino.

¿Qué token recibe tu app?

Un token de usuario de Instagram para graph.instagram.com/v25.0, con account_id_on_meta, el ID de Instagram de la cuenta, desde GET /channels/{id}?credentials=1. easyCoexistence lo renueva bastante antes de que se agoten sus 60 días, y al renovarlo se emite un token nuevo, así que obtén las credenciales al inicio de cada tarea en lugar de guardar una copia.

¿Cómo publica tu app en la cuenta?

Con POST /channels/{id}/posts. ig_type elige IMAGE, CAROUSEL, REELS o STORIES, y se deduce del contenido multimedia si lo omites: varios archivos forman un carrusel y un video forma un Reel. Aquí un carrusel admite de 2 a 10 elementos, las imágenes deben ser JPEG, el texto admite hasta 2,200 caracteres y una publicación de Instagram no tiene campo de enlace. Sin publish_at sale de inmediato; con él, a esa hora, hasta 90 días por adelantado.

A carousel on the customer's Instagram account
curl -X POST https://easycoexistence.com/api/v1/channels/$CHANNEL_ID/posts \
  -H "Authorization: Bearer $EC_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: ig_post_2291" \
  -d '{
    "text": "Three looks for the weekend.",
    "ig_type": "CAROUSEL",
    "media": [
      { "url": "https://cdn.example.com/look-1.jpg", "type": "image" },
      { "url": "https://cdn.example.com/look-2.jpg", "type": "image" },
      { "url": "https://cdn.example.com/look-3.jpg", "type": "image" }
    ]
  }'

¿Cómo llegan los comentarios y DMs a tu app?

Una vez que configuras un destino. PUT /channels/{id}/webhook con tu URL devuelve el secreto de firma de esa cuenta, y desde entonces sus comentarios, menciones y DMs se reenvían al llegar, firmados con X-EC-Signature. El cuerpo contiene platform, account_id, external_id y la entrada de webhook de Meta sin cambios, con changes para comentarios y menciones, y messaging para DMs.

¿Cómo responde tu app a comentarios y DMs?

A través de la API de Instagram de Meta en graph.instagram.com, con el token del cliente, de modo que cada respuesta sale de la cuenta del cliente:

  • Responder a un comentario: POST /<IG_COMMENT_ID>/replies con un message.
  • Responder a un DM: POST /<IG_ID>/messages con recipient con el ID de la persona y el texto del mensaje, dentro de las 24 horas desde su último mensaje.
  • Respuesta privada a un comentario: el mismo endpoint messages con recipient comment_id, una vez por comentario, dentro de los 7 días posteriores a este.
  • Ocultar o eliminar un comentario: POST o DELETE sobre /<IG_COMMENT_ID>.

¿Qué pasa cuando termina el acceso del cliente?

Tu URL de eventos recibe channel.disconnected cuando Instagram rechaza el token o el titular retira el acceso en la configuración de Instagram. Una nueva sesión de conexión para ese cliente devuelve la cuenta. Para terminarla desde tu lado, DELETE /channels/{id} revoca el acceso en la red y cancela las publicaciones que aún esperan en la cola, y la facturación se detiene al final del ciclo.

Errores comunes

  • Enviar imágenes PNG o WebP a Instagram. Meta publica solo JPEG, así que la publicación se rechaza antes de entrar en la cola; convierte las imágenes primero.
  • Poner un campo de enlace en una publicación de Instagram. Las publicaciones de Instagram no llevan enlace, así que la petición se rechaza; pon la URL en el texto.
  • Mostrar un botón Responder en DMs de más de 24 horas. Meta permite responder dentro de la ventana que abrió el último mensaje de la persona.
  • Enviar una segunda respuesta privada al mismo comentario. Meta permite una; un seguimiento espera hasta que la persona responda.
Hacerlo con EasyCoexistence

easyCoexistence permite que tus clientes conecten Instagram a tu app mediante un solo inicio de sesión alojado, y luego entrega a tu backend un token renovado, un endpoint de publicaciones y sus comentarios y DMs por webhook, con cada conexión monitoreada 24/7. Las mismas llamadas sirven para WhatsApp, Facebook, TikTok, YouTube, LinkedIn y más canales. De US$ 9 a US$ 0.75 por conexión al mes, que baja a medida que añades conexiones, con los primeros 3 días gratis.

Preguntas frecuentes

¿Necesito mi propia app de Meta para conectar las cuentas de Instagram de mis clientes?

No. Los clientes inician sesión con la app de easyCoexistence, y tu backend recibe el token para la API de Instagram de Meta a través de la llamada de credenciales.

¿Un cliente puede conectar varias cuentas de Instagram?

Sí, una por inicio de sesión. Crea una sesión de conexión para cada cuenta con el mismo external_ref, y GET /channels?external_ref= las lista todas para ese cliente.

¿Mi app puede programar Stories de Instagram?

Sí. Configura ig_type en STORIES con una imagen o video y una hora publish_at, y la cola la publicará entonces.

¿Cuánto cuesta easyCoexistence por cuenta de Instagram?

Cada cuenta conectada cuesta de US$ 9 a US$ 0.75 al mes, según el tramo de tus conexiones totales, con los primeros 3 días gratis.

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