Integración con Telegram

Crea un bot de Telegram y conéctalo a PropPilot para que tu agente de IA pueda responder a los clientes en Telegram.

Requisitos previos

Antes de configurar Telegram:

• ✅ Chatwoot conectado (consulta Configuración de Chatwoot)
• ✅ Cuenta de Telegram
• ✅ Acceso a Telegram en móvil o escritorio

Crear un bot de Telegram

Paso 1: Encuentra a BotFather

BotFather es el bot oficial de Telegram para crear y gestionar bots.

1. Abre Telegram
2. Busca @BotFather
3. Inicia una conversación

Verifica BotFather

Busca el tick azul junto al nombre de BotFather para asegurarte de que estás hablando con el bot oficial.

Paso 2: Crea tu bot

1. Envía /newbot a BotFather
2. Introduce un nombre visible para tu bot (p. ej., "Asistente de Acme Realty")
3. Introduce un username para tu bot (debe terminar en "bot", p. ej., AcmeRealtyBot)

Paso 3: Obtén el token de tu bot

Tras crearlo, BotFather te envía un mensaje con:

• El username de tu bot
• API Token (algo así como: 123456789:ABCdefGHIjklMNOpqrsTUVwxyz)

Mantén el token en secreto

Este token da control total sobre tu bot. Nunca lo compartas públicamente ni lo subas a repositorios de código.

Paso 4: Configura los ajustes del bot (opcional)

Mientras sigues en BotFather, puedes personalizar:

Comando	Descripción
/setname	Cambiar el nombre visible
/setdescription	Establecer la descripción del bot
/setabouttext	Texto de la sección "About"
/setuserpic	Establecer la foto de perfil

Configurar en PropPilot

Paso 1: Ve a la configuración de Telegram

1. Ve a Integrations → pestaña Chatwoot
2. Encuentra la tarjeta del canal Telegram
3. Haz clic en Configure o Connect

Paso 2: Introduce el token del bot

Pega el token que recibiste de BotFather en el campo Bot Token.

Paso 3: Guarda

1. Haz clic en Save para crear el canal
2. PropPilot automáticamente:
   • Valida el token
   • Configura el webhook
   • Conecta con tu bot

Verificar la conexión

Tras guardar:

1. El canal de Telegram debería mostrar el estado Connected
2. Haz clic en Test para verificar la conectividad
3. La sección de metadatos muestra:
   • Username del bot
   • URL del webhook

Probar tu bot

1. Abre Telegram
2. Busca tu bot por username (p. ej., @AcmeRealtyBot)
3. Envía /start o cualquier mensaje
4. Comprueba que el mensaje aparece en el inbox de PropPilot

Habilitar tu agente

Para que tu agente de IA responda en Telegram:

1. Ve a Agents → Selecciona tu agente
2. Ve a la pestaña Channels
3. Activa el bot en el canal Telegram
4. Envía un mensaje de prueba para verificar las respuestas de la IA

Comandos del bot (opcional)

Puedes configurar comandos que los usuarios ven al escribir /:

En BotFather

1. Envía /setcommands a BotFather
2. Selecciona tu bot
3. Envía los comandos en este formato:

start - Iniciar una conversación
help - Obtener ayuda
contact - Contactar con un agente humano

Comandos comunes

Comando	Uso sugerido
/start	Saludo e introducción inicial
/help	Mostrar opciones disponibles
/contact	Solicitar asistencia humana
/menu	Mostrar opciones del menú principal

Funcionalidades de Telegram

Tipos de mensaje soportados

PropPilot gestiona estos tipos de mensaje de Telegram:

Tipo	Soportado
Mensajes de texto	✅ Sí
Fotos	✅ Sí
Documentos	✅ Sí
Mensajes de voz	⚠️ La transcripción varía
Vídeos	✅ Sí
Stickers	⚠️ Limitado
Ubicación	✅ Sí

Limitaciones del bot

Los bots de Telegram tienen algunas limitaciones:

• No pueden iniciar conversaciones (el usuario debe escribir primero)
• No ven los mensajes en grupos a menos que se les mencione
• No pueden acceder a los números de teléfono de los usuarios (a menos que se compartan)

Resolución de problemas

El bot no responde

1. Verifica que el estado del canal sea Connected
2. Comprueba que el bot esté Enabled para tu agente
3. Asegúrate de que el agente esté en estado Active
4. Revisa el inbox de PropPilot por si llegó el mensaje

Error de token inválido

1. Copia el token de nuevo desde BotFather
2. Asegúrate de que no haya espacios o caracteres extra
3. Comprueba que el token no se haya regenerado
4. Prueba a crear un bot nuevo si el problema persiste

Errores de webhook

1. PropPilot configura los webhooks automáticamente
2. Si hay problemas, desconecta y reconecta el canal
3. Comprueba la URL del webhook en los metadatos del canal

Error de bot duplicado

Si ves "Bot already connected":

• El bot puede estar conectado a otra organización de PropPilot
• O conectado a otra instancia de Chatwoot
• Crea un bot nuevo o elimina la conexión existente

Buenas prácticas

Recomendado

• ✅ Establece una descripción clara del bot
• ✅ Añade una foto de perfil
• ✅ Configura comandos útiles
• ✅ Prueba a fondo antes de compartirlo
• ✅ Monitoriza las conversaciones con regularidad

Evita

• ❌ Compartir el token de tu bot
• ❌ Usar el mismo bot para varios sistemas
• ❌ Ignorar los fallos de entrega de mensajes
• ❌ Dejar el bot en modo de pruebas en producción

Compartir tu bot

Cuando todo funcione:

1. Comparte el enlace del bot: t.me/YourBotUsername
2. Añádelo a la página de contacto de tu web
3. Inclúyelo en materiales de marketing
4. Crea un código QR para acceso rápido

¿Qué sigue?

• Pagos con Stripe - Acepta pagos
• Canales del agente - Gestiona todos los canales