OdooWiki OCA HUB

Mail Telegram Gateway

mail_gateway_telegram folder_open OCA/mail open_in_new
Sin categoría Licencia: AGPL-3

Este módulo permite responder a los chats de telegram como un bot de telegram.

De esta forma, un grupo de usuarios puede responder a clientes o a cualquier otro conjunto de contactos de forma integrada.

No está pensado para integrarse en el chatter por defecto, ya que los usuarios no necesitan revisarlo de nuevo cuando alguien ha respondido.

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 19.0

Conecta Odoo a Telegram para que un equipo pueda chatear con usuarios de Telegram desde Odoo y responder como un bot. Los mensajes, fotos, archivos, stickers y ubicaciones se intercambian automáticamente entre los chats de Telegram y las conversaciones de Odoo.

Este módulo añade Telegram como un nuevo tipo de pasarela en la configuración existente de pasarelas de correo. En el formulario de la pasarela, cuando el tipo es Telegram, aparece una pestaña dedicada "Configuración de Telegram" con instrucciones paso a paso para crear un bot con BotFather, pegar su token y establecer una clave y un secreto de webhook. Se puede habilitar un campo adicional "Clave de seguridad de Telegram" para que las nuevas conversaciones solo se creen cuando un usuario envíe el comando /start seguido de esa clave.

Una vez conectado, los mensajes entrantes de Telegram se convierten en mensajes de conversación de Odoo: se admiten texto, fotos, documentos, contactos, stickers (convertidos en imágenes animadas) y ubicaciones (mostradas como un enlace de Google Maps). Cada usuario de Telegram se vincula a un partner o invitado, y las respuestas enviadas desde Odoo se entregan de vuelta al chat de Telegram como un bot; los mensajes editados también se actualizan en Telegram. Si el envío falla, el mensaje se marca con un error y se registra el motivo.

En la interfaz de mensajería, los mensajes de Telegram muestran un icono de avión de papel y un avatar de Telegram, y el estado de entrega es visible. El módulo afecta a la configuración de la pasarela (mail.gateway), a las conversaciones (discuss.channel) y a las notificaciones de mensajes.

Depende de

mail_gateway

Lo necesitan otros módulos

mail_gateway_telegram_standalone
Modelos y campos (2)
  • mail.gateway · amplía un modelo existentegateway_type, telegram_security_key
  • mail.gateway.telegram · modelo nuevo

Texto generado por IA (DeepSeek) al leer el código de la versión 19.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: 3 confirmadas, 6 sin información de 9 versiones.

terminal Instalación y uso

Documentación de OCA · Odoo 19.0

Configuración

Fuente · Odoo 19.0

Crear el bot

  • Crear un Bot en telegram
  • Crear un broker siguiendo los ejemplos con el TOKEN proporcionado

Configurar Odoo

  • Acceder en modo debug
  • Acceder a Ajustes \> Ajustes Técnicos \> Correo electrónico \> Mail Gateway.
  • Acceder a Telegram e iniciar una conversación con BotFather.
  • Crear un bot usando el comando /newbot. El sistema pedirá un nombre para el bot. Recuerda que debe terminar con la palabra bot.
  • Copiar el token para acceder a la HTTP API en el campo token.
  • Definir la Webhook key y el webhook secret que elijas en su campo correspondiente, para asegurar la conexión.
  • Pulsar el botón guardar y aparecerá el botón inteligente integrate webhook.
  • Pulsar el botón Integrate webhook.
  • Si quieres añadir una capa extra de seguridad, puedes marcar Has New Channel Security y definir una Telegram security key. Los nuevos chats se crearán solo con el comando /start SECURITY_KEY.

Limitaciones

La funcionalidad de Webhook solo se puede usar si tu sistema es accesible desde internet. En instalaciones locales puede ser problemático, ya que Telegram no podrá contactar con tu sistema. En ese caso, es posible que necesites crear un telegram bot que te envíe datos en un proceso externo con el siguiente código.

from telegram.ext import Filters, MessageHandler, Updater
import requests
dp = Updater(YOUR_TOKEN)

def message_callback(update, _context):
    requests.post(YOUR_CONTROLLER, json=update.to_dict())


dp.dispatcher.add_handler(MessageHandler(Filters.all, message_callback))
dp.start_polling()
dp.idle()

Uso

Fuente · Odoo 19.0
  • Access Gateway
  • Espere hasta que alguien inicie una conversación con su bot.
  • Ahora podrá responder y recibir mensajes de esta persona.

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.