Saltar a la navegación

Telegram

Envía actualizaciones de llamadas a un chat o grupo de Telegram con una herramienta de webhook.

Un bot de Telegram permite a tu recepcionista enviarte mensajes a ti o al grupo de tu equipo durante una llamada, por ejemplo cuando alguien pide que le devuelvan la llamada o informa de algo urgente. La herramienta de webhook llama al método sendMessage de la API de bots de Telegram.

Crea un bot y busca el ID del chat

1

Crea el bot

En Telegram, abre un chat con @BotFather, envía /newbot y sigue las indicaciones para darle un nombre. BotFather responderá con un token de bot, como 123456789:AA.... Trátalo como un secreto: cualquiera que lo tenga controla el bot.

2

Inicia un chat con el bot

Los bots solo pueden enviar mensajes a chats en los que están.

  • Para enviarte mensajes a ti: abre un chat con tu bot nuevo y selecciona Iniciar.
  • Para enviar mensajes a un grupo: añade el bot al grupo y, después, envía un mensaje que lo mencione, como /start@YOUR_BOT_NAME.
3

Busca el ID del chat

En un navegador, abre https://api.telegram.org/botBOT_TOKEN/getUpdates, sustituyendo BOT_TOKEN por el token de tu bot. Busca tu mensaje en la respuesta y copia el número que aparece después de "chat":{"id":. El ID de un grupo es negativo, por ejemplo -1001234567890; conserva el signo menos.

Si la respuesta está vacía, envía otro mensaje al bot y vuelve a cargar la página.

Crea la herramienta de webhook

Ve a Integraciones, selecciona Añadir integración y elige Webhook Tool.

CampoValor
Nombrenotify_team_in_telegram
Descripción”Envía un mensaje al equipo en Telegram. Úsala cuando alguien pida que le devuelvan la llamada, quiera hablar con una persona o informe de un problema urgente.”
MétodoPOST
URLhttps://api.telegram.org/botBOT_TOKEN/sendMessage, sustituyendo BOT_TOKEN por el token de tu bot
Parámetros del cuerpochat_id (cadena, obligatorio): “Siempre el valor exacto CHAT_ID.”
text (cadena, obligatorio): “El mensaje: el nombre de quien llama, su número de teléfono y lo que necesita.”
Asignar a agentesRecepcionista

Sustituye CHAT_ID en la descripción por el ID de tu chat. La URL contiene el token de tu bot, así que trátalo también como un secreto.

Selecciona Activar y después prueba tu recepcionista pidiendo que te devuelvan la llamada. El bot publica el mensaje en el chat.

Para enviar mensajes a varios chats, crea una herramienta por cada ID de chat. El mismo bot puede publicar en todos ellos.

Solución de problemas

ProblemaQué comprobar
Telegram devuelve 401El token de bot de la URL es incorrecto o se ha revocado en BotFather. La URL debe incluir bot justo antes del token.
Bad Request: chat not foundComprueba el ID del chat, incluido el signo menos para grupos, y que hayas iniciado un chat con el bot o lo hayas añadido al grupo.
Forbidden: bot was kickedEl bot se ha eliminado del grupo. Vuelve a añadirlo.
getUpdates no muestra nadaEn grupos, los bots solo ven mensajes que los mencionan. Envía /start@YOUR_BOT_NAME y vuelve a cargar.
La recepcionista nunca publicaHaz que la descripción de la herramienta indique las situaciones en las que debe publicar.