Base de conocimiento de GetMyBot

Canales: Telegram, WhatsApp, VK

Cómo conectar Telegram, WhatsApp y VK a un mismo proyecto, qué puede hacer cada canal y dónde reciben los clientes las respuestas.

En esta página

Un proyecto de GetMyBot puede responder en Telegram, WhatsApp y VK. Por ejemplo, puedes usar la misma regla sobre horarios de clase en las tres aplicaciones. La respuesta llega por el canal desde el que escribió la persona.

Al conectar otro canal, comprueba los botones y las acciones: cada aplicación ofrece funciones diferentes. Aquí encontrarás las diferencias y los pasos para conectarlo.

Qué es un canal

Un canal es un lugar conectado donde el bot recibe y envía mensajes: un bot de Telegram, un número de WhatsApp Business o una comunidad de VK. Un proyecto puede tener varios canales. Las reacciones son las mismas en todos: si alguien escribe por WhatsApp, el bot aplica las reglas del proyecto y responde por WhatsApp.

Los botones, el formato del texto y algunas acciones varían entre aplicaciones. GetMyBot puede ocultar una opción que no esté disponible o adaptarla. Prueba el mensaje en cada canal antes de usarlo con clientes.

Canal principal (primary_channel)

Cada bot tiene un canal principal (primary_channel). Suele ser Telegram, pero puedes crear un bot para WhatsApp o VK sin conectar Telegram. El canal principal se elige al crear el bot y aparece en la lista de proyectos. Después puedes añadir otros canales.

Matriz de capacidades de los canales

Estas son las principales funciones disponibles en cada canal. Si necesitas la lista técnica actualizada, está en GET /api/channels/capabilities.

Telegram: botones bajo el mensaje y teclado de respuestas, acciones al pulsar botones, reacciones con emoji, enlaces que abren /start, edición, eliminación y reenvío de mensajes, respuestas como disparador, eventos de participantes y moderación. Las tarjetas de un carrusel de fotos se recorren con botones dentro de un mismo mensaje. Formato de texto: simple, HTML o Markdown. No utiliza plantillas, listas interactivas ni límite de 24 horas para responder.

WhatsApp: botones bajo el mensaje, acciones al pulsarlos, reacciones con emoji, enlaces que abren /start, plantillas de mensajes, listas interactivas y un plazo de 24 horas para enviar respuestas normales tras el último mensaje del cliente. Formato: texto simple o Markdown. No admite teclado de respuestas, edición, eliminación ni reenvío de mensajes, moderación de grupos ni un carrusel que se recorra dentro de un mismo mensaje. Consulta WhatsApp.

VK: mensajes y archivos adjuntos, botones y teclado de respuestas, acciones al pulsar botones, reacciones con emoji, enlaces que abren /start, edición, eliminación y reenvío de mensajes, eventos de participantes, bloqueo y desbloqueo, aprobación de solicitudes para entrar en una comunidad privada y eventos de suscripción de VK Donut. Solo admite texto simple: se eliminan las marcas HTML y Markdown. No tiene plantillas de WhatsApp, listas interactivas, carruseles que se recorran dentro de un mensaje ni plazo de 24 horas.

Los tres canales admiten botones bajo el mensaje, acciones al pulsarlos, reacciones con emoji y enlaces que abren /start. El bloque de carrusel de fotos está disponible donde se pueden enviar fotos. En Telegram, las tarjetas se recorren dentro de un mismo mensaje si todas las fotos tienen un ID de archivo utilizable. En WhatsApp y VK, y también en Telegram cuando no se pueden obtener esos ID, las tarjetas se envían como mensajes de foto separados. Consulta Mensajes y botones.

VK Donut

Si tu comunidad usa VK Donut, el bot puede reaccionar a estos cambios de suscripción:

Evento en GetMyBotClaveDatos disponibles
Suscripción iniciadadonut_subscription_created{{event.donut_amount}}, {{event.donut_amount_without_fee}}
Suscripción renovadadonut_subscription_prolonged{{event.donut_amount}}, {{event.donut_amount_without_fee}}
Suscripción terminadadonut_subscription_expiredNingún importe
Suscripción canceladadonut_subscription_cancelledNingún importe

{{event.donut_amount}} es el importe pagado; {{event.donut_amount_without_fee}}, el importe sin la comisión de VK. Los eventos de finalización y cancelación no incluyen importes.

Son eventos de suscripción, no mensajes enviados por la persona. Por eso no abren un chat para responderle, no cambian su última actividad ni aumentan el contador de mensajes. Si GetMyBot todavía no conoce a la persona, crea su ficha para poder asignarle etiquetas.

Por ejemplo, para gestionar un club de pago:

  1. Cuando se inicie o renueve una suscripción, añade la etiqueta «Club» durante 31 días y envía un mensaje con el enlace a la comunidad privada.
  2. Aprueba la solicitud de acceso después de que la persona la envíe. Puedes hacerlo cuando pulse «Ya he solicitado acceso» o en una renovación posterior. Antes de que exista una solicitud, no hay nada que aprobar.
  3. Cuando caduque la etiqueta, retira el acceso con la acción Cambiar permisos → Expulsar. Así no dependes de que VK envíe el evento de finalización. Consulta Disparadores → Etiqueta caducada.
  4. Si recibes un evento de cancelación o finalización, puedes quitar la etiqueta y el acceso inmediatamente si esa es la regla de tu club.

Para moderar una comunidad de VK, el campo Chat (chat_id) debe contener el identificador de la comunidad conectada, el número que aparece en la lista de canales. Si indicas otro ID, la acción se rechaza antes de enviarla a VK. Para moderar otra comunidad, conéctala como un canal aparte.

Con Long Poll, GetMyBot activa estos eventos al conectar el canal y cada vez que inicia el servicio. Con Callback API, actívalos en los ajustes de la comunidad: Trabajo con API → Callback API → Tipos de eventos → VK Donut.

Cómo conectar un canal

Los canales se añaden en Proyectos.

  1. Abre Proyectos y busca el proyecto que necesitas.
  2. Pulsa Añadir canal en su tarjeta.
  3. Elige una plataforma — Telegram, WhatsApp o VK.
  4. Introduce las credenciales del canal (para Telegram — un token, para WhatsApp — un conjunto de credenciales de Meta, para VK — las credenciales de la comunidad).
  5. Pulsa Validar: la plataforma comprueba las credenciales en la mensajería.
  6. Pulsa Conectar.

Para WhatsApp y VK, tras la conexión el canal obtiene una dirección de webhook (icono 🔗). Esta dirección hay que registrarla del lado de la plataforma (en la aplicación de Meta para WhatsApp, en los ajustes de la comunidad para VK), para que los eventos entrantes lleguen al bot. Cómo hacerlo para WhatsApp — véase WhatsApp → Configuración del webhook.

Qué sigue

Datos de acceso del canal

Telegram necesita el token completo de BotFather. VK necesita un token de la comunidad y su ID numérico; Callback API también requiere una clave secreta y un código de confirmación. WhatsApp necesita Phone Number ID, WhatsApp Business Account ID, un token con acceso a la cuenta, Verify Token y App Secret de la aplicación Meta.

Comprueba los datos antes de conectar. Al cambiar una clave, actualiza también el valor correspondiente en VK o Meta. Verify Token confirma la dirección del webhook; App Secret permite verificar la firma de los eventos recibidos. Ninguno sustituye al token de acceso.

Mensajes entrantes y direcciones de webhook

Con VK Callback API, registra la dirección que muestra GetMyBot en los ajustes del servidor de la comunidad y utiliza la misma clave secreta y el mismo código de confirmación. Long Poll no necesita una dirección pública. Con WhatsApp, registra la dirección en tu aplicación Meta, introduce el mismo Verify Token y activa los eventos de mensajes necesarios. Tener datos para enviar mensajes no configura por sí solo su recepción.

Autorizar Instagram y Messenger

El asistente de conexión abre la autorización de Meta. Entra con una cuenta que pueda gestionar la página de Facebook o la cuenta profesional de Instagram, concede los permisos solicitados y elige las cuentas que conectarás al proyecto. El asistente comprueba los permisos, la suscripción al webhook y la recepción de mensajes. Resuelve cualquier comprobación fallida antes de usar el canal. Puedes revisar las cuentas seleccionadas desde una conexión existente.