OdooWiki OCA HUB

Mail Instagram Gateway

mail_gateway_instagram folder_open OCA/social open_in_new
Sin categoría Licencia: AGPL-3

Este módulo conecta Odoo Discuss con los mensajes directos de Instagram a través de OCA mail_gateway. Los mensajes directos entrantes se convierten en canales de gateway; las respuestas desde Discuss se envían de vuelta como mensajes de texto de Instagram.

Traducción automática al español (DeepSeek) de la descripción original de OCA, que está en inglés.

auto_awesome Qué hace este módulo

Generado por IA a partir del código · Odoo 18.0

Conecta Odoo Discuss con Instagram Direct Messages: los mensajes entrantes de Instagram aparecen como canales de chat, y las respuestas escritas en Odoo se envían de vuelta al usuario de Instagram como mensajes de texto.

Este módulo añade Instagram como un nuevo tipo de pasarela en la pantalla de configuración de pasarelas. Cuando eliges Instagram, aparecen campos adicionales: una clave de seguridad (token de verificación), el ID de la cuenta profesional de Instagram y la versión de la Graph API (por defecto 26.0). Una pestaña dedicada "Configuración de Instagram" muestra la URL del webhook y las instrucciones de configuración paso a paso.

Una vez configurado e integrado el webhook, los mensajes directos entrantes de Instagram se convierten en canales de Discuss. Cada remitente se identifica por su ID de Instagram; Odoo intenta obtener el nombre de perfil y el nombre de usuario de la persona, y recurre al ID si falla. El canal recibe el nombre del remitente y obtiene un avatar al estilo de Instagram.

  • Los mensajes de texto se convierten en mensajes de chat en el canal.
  • Las imágenes, los vídeos, el audio y los archivos se descargan y se adjuntan al mensaje, con un límite de tamaño de 25 MB.
  • Los enlaces a publicaciones, reels e historias se añaden como enlaces en los que se puede hacer clic.
  • Se ignoran los ecos de tus propios mensajes y los mensajes eliminados.
  • Los mensajes llevan la marca de tiempo con la hora de envío original de Instagram.

Cuando respondes en Discuss, el texto sin formato se envía de vuelta al usuario de Instagram a través de la API de mensajería de Instagram. Si el envío falla, el mensaje se marca con una excepción y se registra el motivo del fallo. El handshake del webhook se verifica con la clave de seguridad, y las llamadas entrantes se comprueban con una firma basada en el secreto del webhook.

Depende de

mail_gateway
Modelos y campos (2)
  • mail.gateway · amplía un modelo existentegateway_type, instagram_version, instagram_account_id, instagram_security_key
  • mail.gateway.instagram · modelo nuevo

Texto generado por IA (DeepSeek) al leer el código de la versión 18.0 en GitHub; puede contener errores, así que verifícalo en el código antes de decidir. Ver el código en GitHub

Disponibilidad por versión

Revisado: 2026-11-03
Confirmado (verificado en repositorio y rama) Estimado (sin verificar) Sin información

Estado de confirmación: 1 confirmada, 8 sin información de 9 versiones.

terminal Instalación y uso

Documentación de OCA · Odoo 18.0

Configuración

Fuente · Odoo 18.0

El conector usa la API de Instagram con Instagram Login (graph.instagram.com). Facebook-Login / Page-scoped Instagram no es compatible.

Meta app

IMPORTANTE — publica la Meta app (modo Live). La verificación del webhook puede tener éxito mientras la app sigue en Development, pero los Mensajes Directos de Instagram no se entregan a Odoo hasta que la app se publica (se cambia a Live). Sin el modo Live verás un webhook integrado y ningún POST entrante, y ningún canal de Discuss. Haz esto antes de esperar que los DM reales funcionen. App Review / Advanced Access también es necesario para los permisos que atienden cuentas de Instagram que la app no posee.

  • Usa una cuenta profesional de Instagram (Business o Creator).
  • Crea una Meta app en developers.facebook.com/apps y añade el producto Instagram Login.
  • Solicita instagram_business_basic y instagram_business_manage_messages. Advanced Access es necesario para atender cuentas de Instagram que la app no posee.
  • Publica la app (Development → Live). Este paso es obligatorio para la entrega de mensajes; omítelo y los DM entrantes nunca llegarán.

Odoo gateway

  • Activa el modo desarrollador y ve a Settings > Technical > Email > Gateway. (Technical solo es visible en el modo desarrollador.)
  • Crea un gateway de tipo Instagram.
  • Rellena:
  • Token: token de acceso de usuario de Instagram (se envía como Authorization: Bearer).
  • Webhook Secret: secreto de la Meta app (clave HMAC para X-Hub-Signature-256). Cópialo desde la Meta app Settings > Basic > App Secret.
  • Instagram Security Key: una cadena que elijas. Introducirás el mismo valor en Meta como webhook verify token (hub.verify_token).
  • Instagram Account: IGID de la cuenta profesional usado en la URL de envío.
  • Instagram Version: versión de la Graph API sin el prefijo v (por defecto 26.0).
  • Webhook Key: segmento de ruta de URL que elijas. Pasa a formar parte de la URL del webhook.
  • Webhook User: usuario que crea los mensajes entrantes.
  • Members: usuarios de Discuss que se unen a las nuevas conversaciones.
  • Guarda. Webhook Key y Webhook User deben estar establecidos o el botón Integrate Webhook permanece oculto.
  • Pulsa Integrate Webhook en el formulario del gateway (cabecera). El estado pasa a pending. El GET de verificación de Meta solo se acepta en este estado.
  • Abre la pestaña de configuración de Instagram en el mismo formulario. Copia Webhook URL. Odoo la construye como https://<your-odoo-host>/gateway/instagram/<webhook_key>/update. Esta URL no la obtienes de Meta.

El mismo campo Webhook URL en el grupo del formulario principal solo es visible en el modo desarrollador. Usa la pestaña; esa copia es para los operadores.

Meta webhook

  • En la Meta app, abre la configuración de webhook / callback del producto Instagram Login.
  • Callback URL: pega la Webhook URL copiada de Odoo.
  • Verify token: pega la misma cadena que Instagram Security Key.
  • Suscribe solo el campo messages.
  • Meta envía un GET a Odoo. Si tiene éxito, el estado del gateway pasa a integrated.

El endpoint del webhook debe ser accesible públicamente por HTTPS. Meta no acepta certificados autofirmados.

Ventana de mensajería de 24 horas

Instagram solo permite a la cuenta profesional enviar mensajes a un usuario después de que ese usuario le haya enviado un mensaje, y solo durante 24 horas tras el último mensaje del usuario. Las respuestas desde Discuss fuera de esa ventana son rechazadas por Meta. Todo lo que deba enviarse más tarde tiene que pasar por otro canal. Una etiqueta de agente humano que amplía la ventana está listada en la hoja de ruta del módulo y no está implementada aquí.

Uso

Fuente · Odoo 18.0

Los mensajes directos entrantes de Instagram aparecen como canales de Discuss de tipo gateway. El remitente es un mail.guest hasta que un usuario lo promueve a contacto desde el menú de seguidores.

Las respuestas escritas en ese canal de Discuss se entregan como mensajes directos de Instagram (solo texto). Los mensajes que la cuenta profesional envía desde la aplicación de Instagram no se duplican en el canal.

Las publicaciones compartidas, las menciones en historias y los reels llegan como enlaces en el cuerpo del mensaje, no como archivos descargados. Las imágenes, los vídeos, el audio y los archivos se descargan y se adjuntan al mensaje de Discuss.

Traducción automática al español (DeepSeek) de la documentación original de OCA; los comandos y el código no se traducen. Sin información verificada en OCA: Instalación.

info

Datos importados de GitHub: esta ficha refleja la última revisión del catálogo, no una consulta en directo. Verifica siempre en la documentación del módulo y en staging antes de instalar en producción.