Integrar la API de la bandeja de entrada de Instagram

DMA

Nuestra solución se basa en la Ley de Mercados Digitales. Los perfiles de usuario nunca se almacenan ni se extraen, y nuestra API se centra exclusivamente en permitir la interoperabilidad de la mensajería. Los clientes deben cumplir las condiciones de cada proveedor.

E

Introducción

E

¿Qué es la API de la bandeja de entrada de Instagram?

E

Panorama general y limitaciones

E

API unificada Unipile

E

Integración de la API de Instagram

E

Unipile vs Meta APIs

E

Integrar la API de Instagram con Unipile

E

Puntos finales de la API de Instagram

E

Funciones de la API de Instagram

E

Casos de uso de los editores de software

E

Apoyo y recursos para la integración

E

Preguntas frecuentes

API de la bandeja de entrada de Instagram

¿Quieres añadir mensajes de Instagram directamente a tu software? Aquí tienes una guía práctica que muestra cómo los editores de software pueden desbloquear la bandeja de entrada de Instagram a través de Unipile. API de Instagram, con sincronización en tiempo real, configuración rápida y sin complicaciones.

Tenga en cuenta que Unipile es no es un Meta Partnery todo uso debe respetar las normas de Meta.

¿Qué es la API de la bandeja de entrada de Instagram?

Vista de conversación que muestra los mensajes de Instagram con un contacto junto con las integraciones de LinkedIn, WhatsApp, Gmail y Google Calendar.

La API de la bandeja de entrada de Instagram permite a tu aplicación enviar y recibir DMs, dando a tus usuarios un acceso sin fisuras a las conversaciones en tiempo real dentro de tu software. Mientras que Meta ofrece un acceso limitado, Unipile hace que la integración completa de la bandeja de entrada sea fácil y segura, incluso sin una asociación oficial?

Integración de Instagram DM en la interfaz de la aplicación

Visión general de las funciones de la API

La API Instagram Inbox (parte de la API Instagram Graph) permite al software:

    • Recuperar y enviar mensajes directos

    • Gestionar hilos de mensajes

    • Manejo de medios (imágenes, vídeos, audio)

    • Escuchar webhooks relacionados con mensajes

Limitaciones oficiales y restricciones de acceso de Meta

Meta restringe el acceso a:

  • Sólo cuentas de Instagram Business

  • Páginas con más de 1.000 seguidores (según la última política)

  • Aplicaciones preaprobadas en su programa de socios

Cómo Unipile salva las distancias con su API unificada

Unipile replica las interacciones de los usuarios a través de una automatización headless segura. Esto permite el acceso completo a la bandeja de entrada sin necesidad de credenciales de API públicas o asociación oficial con Meta. Además, funciona en Instagram, LinkedIn, WhatsApp, Telegram, correo electrónico, calendario, etc.

Por qué es difícil el acceso nativo a la mensajería de Instagram

Restricciones de funciones y control de socios de Meta

La mensajería de Instagram no forma parte de la Graph API pública. Para acceder a las funciones de la bandeja de entrada es necesario solicitar permisos especiales a través de la API de mensajería para Instagram.

Esto implica:

  • Justificar su caso de uso empresarial
  • Revisar las reseñas de las aplicaciones
  • Gestión de OAuth + permisos

La complejidad de OAuth, los límites de tarifa y los permisos

Incluso las aplicaciones aprobadas se enfrentan:

  • Caducidad del token OAuth
  • Límites de velocidad estrictos (especialmente para el envío de mensajes)
  • ID de aplicación que cambian por sesión

Las ventajas y desventajas de las soluciones de bricolaje o de ingeniería inversa

La ingeniería inversa lo es:

  • Lleva mucho tiempo
  • Frágil (se rompe con las actualizaciones de la interfaz de usuario)
  • Riesgo en la producción

Con Unipile, estos riesgos desaparecen: sin raspaduras, sin hacks quebradizos.

Cómo Unipile simplifica la integración de la bandeja de entrada de Instagram

Integración API que sincroniza los mensajes de Instagram con una plataforma SaaS

Autenticación alojada, inicio de sesión seguro y vinculación de cuentas

Unipile permite flujos de inicio de sesión alojados en marca blanca. Sus usuarios autentican sus cuentas de Instagram a través de un enlace seguro. No se almacenan credenciales en su extremo.

Sincronización en tiempo real de mensajes, hilos y archivos adjuntos

Una vez conectado, Unipile se sincroniza:

  • Historial completo de chat
  • Hilos de mensajes en curso
  • Archivos adjuntos (imágenes, vídeos, pegatinas)

Todo es accesible a través de una API RESTful limpia.

Preparado para desarrolladores: SDK, Webhooks y documentación

La experiencia de los desarrolladores de Unipile es de primer nivel:

  • SDK de Node.js y PHP
  • Documentación interactiva
  • Webhooks para nuevos mensajes, reacciones y cambios de estado

La integración lleva horas, no semanas.

Comparación de soluciones: Por qué destaca Unipile

Al considerar la integración de la mensajería de Instagram, los desarrolladores a menudo se enfrentan a la elección entre navegar por el complejo ecosistema de Meta u optar por una alternativa más racionalizada. A continuación se muestra una comparación detallada que pone de relieve las ventajas y desventajas prácticas entre las API oficiales de Meta y la solución unificada de Unipile. Desde la velocidad de integración hasta el soporte, este desglose te ayuda a entender por qué cada vez más editores de software eligen a Unipile como su proveedor de API.

Criterios Meta API Unipile
Hora de integrarse Semanas o meses 2-3 días
Esfuerzo de desarrollo Alta Bajo (REST + SDKs)
Mantenimiento Manual Totalmente gestionado
Acceso a las prestaciones Parcial (previa aprobación) Completo, al instante
Ayuda Sólo autoservicio Equipo técnico especializado

Esta tabla muestra cómo Unipile reduce la complejidad y acelera la salida al mercado. El equipo se centra en el producto principal, no en las integraciones.

Criterios Meta API Unipile
Hora de integrarse Semanas/meses 2-3 días
Esfuerzo de desarrollo Alta Bajo (REST + SDKs)
Mantenimiento Manual Totalmente gestionado
Acceso a las prestaciones Parcial (previa aprobación) Lleno, ahora
Ayuda Sólo autoservicio Equipo técnico especializado

Implantación instantánea: De cero a la integración en pocos días

No hay necesidad de pasar semanas construyendo o navegando por interminables bucles de aprobación. Con Unipile, la mayoría de los editores de software pueden pasar de la fase de pruebas a la de producción en menos de 48 horas, gracias a la sencilla vinculación de cuentas, la documentación guiada y la asistencia exclusiva para desarrolladores.

Registrarse en Unipile

Acceder al panel de control

Accede a tu espacio de trabajo y gestiona tus cuentas conectadas.

Panel de control de Unipile que muestra las cuentas operativas de LinkedIn, WhatsApp, Gmail e Instagram API.

Recuperar tus credenciales de Instagram

Para realizar una autenticación para Instagram, un usuario necesita su INSTAGRAM nombre de usuario y contraseña. La autenticación mediante credenciales de Facebook no es compatible por el momento.

Autenticación

Realice una solicitud POST a este punto final de la API de Unipile o utilice el método SDK apropiado.

Vincular una cuenta de Instagram
    
curl --request POST
     --url https://{YOUR_DSN}/api/v1/accounts
     --header 'X-API-KEY: {YOUR_ACCESS_TOKEN}''
     --header 'accept: application/json'
     --header 'content-type: application/json'
     --data "
{
  "provider": "INSTAGRAM",
  "nombre de usuario": "unipile",
  "contraseña": "********'
}
'
    
  

Gestionar el punto de control 2FA

Si una cuenta de Instagram tiene activada la autenticación de dos factores, te encontrarás con un punto de control a través de un estado 202. Aquí tienes un ejemplo de respuesta de punto de control.

    
{
  "objeto": "Punto de control",
  "account_id": "098dez89d",
  "punto de control": {
    "tipo": "2FA"
  }
}
    
  

En este caso, se inicia un nuevo intento de autenticación. Este intento dura 5 minutos y los puntos de control deben resolverse en este periodo de tiempo.

Resolver el punto de control 2FA

Para resolver el punto de comprobación 2FA, realice una solicitud POST a la API de Unipile utilizando el punto final Resolver punto de comprobación o utilice un método SDK indicando el parámetro account_id devuelto por la primera solicitud.

    
curl --request POST
     --url https://{YOUR_DSN}/api/v1/accounts/checkpoint
     --header 'X-API-KEY: {YOUR_ACCESS_TOKEN}''
     --header 'accept: application/json'
     --header 'content-type: application/json'
     --data "
{
  "provider": "INSTAGRAM",
  "account_id": "098dez89d",
  "code": "******'
}
'
    
  

Manejar el tiempo de espera

Si el usuario tarda más de 5 minutos en resolver el punto de control, la cuenta no se conectará. Cualquier solicitud posterior para resolver un punto de control fuera de un marco de tiempo de 5 minutos responderá primero un 408 - Tiempo de espera de solicitud, luego un 400 - Solicitud incorrecta ya que la intención de autenticación se autodestruirá.

Uso de puntos finales de API para mensajería y gestión de perfiles

Ejemplos de acciones disponibles a través de la API:

🟢 Envía un mensaje directo: /api/v1/mensajes

🟢 Lista de conversaciones recientes

Referencia completa disponible en Documentación para desarrolladores de Unipile

API de bandeja de entrada de Instagram y más puntos finales

Funciones de Instagram

instagram api

Conexión a la cuenta

Mensajes

Webhooks

Hosted Auth: marca blanca para conectar a sus usuarios finales ✓
Custom auth: conectar usuario con credenciales, cookies, su extensión chrome ✓
Enviar y responder mensajes ✓
Lista de mensajes, chats y asistentes ✓
Enviar notas de voz ✓
Lista Reacciones ✓
Leer recibos ✓
Enviar archivos adjuntos ✓
Recibir archivos adjuntos ✓
Estado de la cuenta ✓
Nuevo mensaje ✓
Nueva reacción / lectura / evento ✓
Conexión a la cuenta
✓
Hosted Auth: marca blanca para conectar a sus usuarios finales
✓
Custom auth: conectar usuario con credenciales, cookies, su extensión chrome
Mensajes
✓
Enviar y responder mensajes
✓
Lista de mensajes, chats y asistentes
✓
Historial de sincronización
✓
Lista Reacciones
✓
Leer recibos
✓
Enviar archivos adjuntos
✓
Recibir archivos adjuntos
Webhooks
✓
Estado de la cuenta
✓
Nuevo mensaje
✓
Nueva reacción / lectura / evento

Mensajería multicanal y sinergia de correo electrónico

Unipile no solo ofrece integración con la API de Instagram, sino que proporciona a tus usuarios un completo centro de comunicación. Al conectar la mensajería de Instagram con otros canales esenciales como el correo electrónico y el calendario, Unipile te ayuda a ofrecer flujos de trabajo realmente unificados.

Tanto si tus usuarios son reclutadores que gestionan la captación de candidatos como si son equipos de ventas que realizan el seguimiento de clientes potenciales, la sincronización de los mensajes de texto de Instagram con los hilos de correo electrónico y los eventos del calendario crea interacciones fluidas y ricas en contexto a lo largo del recorrido del cliente.

Esta sinergia entre canales se traduce en menos mensajes perdidos, automatizaciones más inteligentes e interacciones más personalizadas, sin necesidad de cambiar de aplicación.

Bandeja de entrada unificada que muestra mensajes de LinkedIn, Instagram y WhatsApp en una interfaz de aplicación SaaS.

Características principales de la API Instagram Inbox de Unipile

Interfaz de bandeja de entrada que muestra mensajes de varios contactos a través de Instagram, LinkedIn, WhatsApp y Outlook.
Lista de todos los chats
    
curl --request GET
     --url https://api1.unipile.com:13111/api/v1/chats
     --header 'accept: application/json'
    
  

Listar todos los chats mediante API

¿Necesitas una instantánea rápida de todas las conversaciones que tienen lugar en Instagram? Este punto final te permite recuperar una lista completa de las conversaciones asociadas a tus cuentas de Instagram conectadas. Tanto si estás construyendo una cronología de CRM como si estás apoyando análisis de alcance, esta ruta ayuda a centralizar los datos de comunicación sin esfuerzo.

Crea secuencias automatizadas con la API de la bandeja de entrada de Instagram

La mensajería de Instagram puede ir más allá de las respuestas puntuales cuando se integra en tu producto. Al utilizar la API de mensajería, puedes crear secuencias personalizadas que guíen las conversaciones paso a paso. Un primer mensaje podría confirmar el interés, un segundo podría compartir más detalles y un tercero podría escalar la conversación al compañero de equipo adecuado.

Estos escenarios ofrecen a los usuarios la posibilidad de planificar sus flujos de trabajo de contacto o asistencia con antelación, al tiempo que mantienen todos los intercambios dentro de su CRM o ATS. El resultado es un proceso de comunicación más predecible que ahorra tiempo, reduce las oportunidades perdidas y garantiza una experiencia más fluida tanto para los equipos como para los usuarios finales.

Casos prácticos para editores de software

CRM: DMs centralizados, etiquetado de prospectos, plantillas de mensajes

Permitir a los agentes responder a los clientes potenciales a través de IG DM directamente en el CRM

Añade etiquetas o tags a los contactos en función del contenido del DM

Activar seguimientos con plantillas de mensajes

ATS: Compromiso del candidato con el historial de mensajería IG

Mostrar las interacciones de los candidatos a través de Instagram en el registro de candidatos

Sincroniza respuestas e inicia mensajes in-app

Útil para sectores en los que la captación de talento se realiza a través de las redes sociales.

Herramientas de divulgación: Automatización de secuencias mediante activadores de DM

Crea campañas de varios pasos con Instagram DMs como uno de los pasos

Activar secuencias basadas en respuestas, reacciones o aperturas

Supervisar las bandejas de entrada para detectar mensajes no leídos en todas las cuentas

Conclusión: La vía rápida para la integración de la mensajería de Instagram

La demanda de una comunicación integrada y multicanal es mayor que nunca, especialmente en las herramientas de ventas, contratación y captación de clientes. Los DM de Instagram son una parte vital de ese ecosistema. Pero integrarlos no debería ser una lucha.

Con la API Instagram Inbox de Unipile, los editores de software obtienen acceso inmediato a funciones de mensajería en tiempo real sin tener que lidiar con las limitaciones de Meta o los cuellos de botella de la API. Ya sea que estés lanzando un CRM, construyendo una herramienta de difusión o mejorando un ATS, la API unificada de Unipile te da la flexibilidad para salir al mercado más rápido, con menos esfuerzo de desarrollo y más impacto.

Desde la sincronización de las bandejas de entrada hasta la generación de secuencias, Unipile no es sólo una capa de integración, es su infraestructura de mensajería backend.

¿Listo para empezar? Construya ahora con Unipile y desbloquea todo el poder de Instagram, LinkedIn, Email, ¡y mucho más!

Soporte de integración y recursos para Instagram Inbox API

1 Icono

Llamada de integración
Consiga una reunión a petición con nuestros fundadores (Director Técnico y Director General) para alinearse en la estrategia técnica y de producto.

1 Icono

Llamada de integración
Consiga una reunión a petición con nuestros fundadores (Director Técnico y Director General) para alinearse en la estrategia técnica y de producto.

Icono de entregabilidad

Conectar con la asistencia en directo
Nuestra asistencia en directo está a su disposición antes, durante y después de la integración, garantizándole orientación en cada paso sin coste adicional.

Icono de entregabilidad

Conectar con la asistencia en directo
Nuestra asistencia en directo está a su disposición antes, durante y después de la integración, garantizándole orientación en cada paso sin coste adicional.

Asistencia específica durante la integración

Nuestro equipo de asistencia está a su lado en todo momento (antes, durante y después de la integración) para garantizarle una experiencia perfecta. Estamos aquí para ofrecerle asistencia en tiempo real y ayudarle a evitar contratiempos y costes adicionales.

Recursos completos para desarrolladores

Nuestra API incluye documentación detallada y código de ejemplo para simplificar la integración. Estos recursos están diseñados para mejorar las capacidades de su aplicación, haciendo que el proceso de envío de Mensajes y otros sea más fluido y eficiente.

Actualizaciones y mantenimiento continuos

Con actualizaciones proactivas y un mantenimiento regular, nuestra API se mantiene alineada con los últimos estándares y mejoras de Instagram, garantizando un rendimiento constante y minimizando cualquier posible tiempo de inactividad.

Preguntas frecuentes

¿Qué es la API de la bandeja de entrada de Instagram?

 Es una forma de que las aplicaciones envíen, reciban y gestionen mensajes directos de Instagram a través de la API.

¿Puedo enviar y recibir mensajes de Instagram a través de la API?

 Sí, con la API unificada de Unipile, puedes enviar, recibir y sincronizar historiales de mensajes completos.

¿Cómo autentico las cuentas de Instagram?

 Unipile proporciona una URL de inicio de sesión segura alojada para que los usuarios se autentiquen sin almacenar credenciales.

¿Es la API Instagram de Unipile compatible con DMA?

Sí. Nuestra API está diseñada de acuerdo con la Ley de Mercados Digitales (DMA). Sólo proporcionamos interoperabilidad para la mensajería y no almacenamos ni extraemos perfiles de usuario. Tenga en cuenta que Unipile no es un Meta Partner, y que nuestra solución se centra exclusivamente en casos de uso de mensajería seguros y conformes a la ley.

¿Existen límites o condiciones al utilizar Unipile con plataformas Meta?

Sí. Los clientes deben respetar siempre las Condiciones de servicio de Meta. Esto significa evitar el spam, la automatización masiva o el scraping no autorizado. La API sólo debe utilizarse para escenarios de mensajería legítimos, como la atención al cliente, la comunicación en equipo o las interacciones con los usuarios, actuando de forma responsable y dentro de las normas de Meta.

¿Puedo conectar varias cuentas de Instagram con una API?

 Sí. Unipile admite un número ilimitado de conexiones de cuenta por usuario, todas vinculadas mediante acceso tokenizado.

¿Cuánto tiempo se tarda en integrar la API Instagram Inbox de Unipile?

La mayoría de los editores de software entran en funcionamiento en 2 días laborables.

También le puede interesar

Extensión de LinkedIn para Chrome vs Integración API

Extensión de LinkedIn para Chrome vs Integración API

LinkedIn se ha convertido en un canal fundamental para las plataformas de CRM, ATS y difusión. Los equipos esperan poder acceder a información sobre perfiles, conversaciones en bandejas de entrada y datos de participación directamente desde el software que utilizan a diario. Muchos proveedores empiezan añadiendo una extensión de LinkedIn para Chrome porque ofrece una forma rápida de...

leer más
es_ESES