Escribir un cliente de Telegram es fácil

¿Cuál es la diferencia entre Telegram y otros mensajeros populares? El esta abierto!
Otros mensajeros también tienen una API, pero por alguna razón, ¿se conoce a Telegram como el más abierto de los más populares?

Para empezar, Telegram tiene un cliente realmente totalmente abierto.
código Desafortunadamente, no vemos confirmaciones todos los días directamente en GitHub, pero tenemos un código bajo una licencia abierta. La arquitectura de Telegram implica que tanto Bot como API tienen casi los mismos métodos: https://core.telegram.org/methods .

De hecho, Telegram no es solo un mensajero de chat, sino una plataforma social, cuyo acceso está abierto para varios tipos de aplicaciones. Pueden proporcionar chips adicionales a los usuarios, en lugar de utilizar una red de usuarios y servidores listos para enviar mensajes. Suena tan atractivo que queríamos intentar escribir a nuestro "cliente" para Telegramas.

La esencia de la aplicación.

Principalmente nos ocupamos de los mapas y la navegación, por lo que inmediatamente analizamos algo relacionado con la geolocalización. Realmente me gustó que en Telegram, antes de todas las demás aplicaciones, había una manera conveniente de compartir su ubicación en tiempo real ( https://telegram.org/blog/live-locations ) y a menudo lo uso: ayudarme a orientarme, mostrar mi camino y Lo más importante es responder la pregunta principal "¿Cuándo estarás?". En principio, esto es suficiente para la mayoría de las personas, pero como siempre hay escenarios en los que las oportunidades simples no son suficientes. Por ejemplo, puede ser un grupo de más de 10 personas, con diferentes dispositivos (algunos dispositivos pueden no ser teléfonos) y diferentes personas. Sería conveniente para estas personas intercambiar mensajes en un grupo, así como verse mutuamente moviéndose en un mapa.

Nos centramos en la tarea de crear valor adicional para Telegram y no tratar de usarlo para otros fines. No queríamos que las personas que no tenían un cliente especial de Telegram vieran un desorden de mensajes en el chat o algo ininteligible. Las personas con un cliente "mejorado" tienen oportunidades adicionales, por ejemplo:

1. Gestión de tiempo más precisa al enviar ubicaciones en tiempo real para chatear.
2. Ver la ubicación de los contactos en el mapa.
3. Conexión al chat de dispositivos beacon a través de una API externa (Bot).

Como lo hicimos

Afortunadamente, todo el código que escribimos es de código abierto, por lo que puedo dar inmediatamente un enlace a su implementación: Implementación de Bot e Implementación de cliente de Telegram en Kotlin .

Bot - lo básico

Hay mucha documentación y ejemplos sobre la implementación de Bot, pero aun así quiero hablar sobre algunas de las dificultades. Para empezar, escribimos el lado del servidor
en Java y elegí la biblioteca org.telegram: telegrambots. Como nuestro servidor es un SpringBoot normal, la inicialización es extremadamente simple:

// Gradle implementation "org.telegram:telegrambots:3.6" TelegramBotsApi telegramBotsApi = new TelegramBotsApi(); telegramBotsApi.registerBot(new TelegramLongPollingBot() {...}); 

La característica principal de la transferencia de ubicación es que debe actualizarse con frecuencia y el bot debe editar los mensajes ya enviados. Si no hubiera tal oportunidad, Bot simplemente enviaría spam al chat y, por supuesto, sería Epic Fail. Gracias a Dios Telegram le da al bot el derecho de editar mensajes durante 24 horas (mínimo, posiblemente más).

Hay muchas formas de enviar un mensaje. Hay texto sin formato, lugar, ubicación, juego, contacto, factura, etc. Parecía que la ubicación era perfecta para nuestra tarea, pero se reveló una característica desagradable. ¡La ubicación solo se puede transferir de un dispositivo a una cuenta o bot a la vez! Imagina que tienes 2 teléfonos y desde dos teléfonos enviaste tu ubicación en un chat. Por lo tanto, se producirá un error en el servidor y la primera ubicación compartida simplemente se detendrá. Parece que este es claramente un caso neuronal, pero imagine que tiene muchas balizas chinas que pueden enviar Ubicación a una URL determinada, pero no pueden enviar directamente a Telegram. Escribes Bot, que recoge del servidor y empuja telegramas. Aquí es donde se descubre que Bot no podrá enviar más de un mensaje de baliza con el tipo de ubicación. Resulta que esto es ideal para el envío de una sola vez, pero no es adecuado para Live Location.

La solución es simple: envíe mensajes de texto y el cliente analizará el texto y mostrará las ubicaciones en el mapa. Desafortunadamente, solo los mensajes de texto serán visibles en el cliente estándar de Telegram, pero puede insertar un enlace allí para abrir el mapa.

Bot - trampas

Desafortunadamente, Bot tuvo que reescribir hasta 2.5 veces. El principal problema es el diseño incorrecto de la comunicación.

1. Por alguna razón, al principio parecía una buena idea si el robot sería un participante de pleno derecho en el chat y enviaría mensajes. Pero, esto es malo tanto en términos de privacidad de la correspondencia como en términos de interacción con el bot. La decisión correcta, usa bots en línea . Por lo tanto, se garantiza que el bot no ve nada más que su ubicación y se puede usar en cualquier chat. Hablando humanamente, no es cultural arrastrar tu bot a algún tipo de chat general, pero debes hablar con el bot uno a uno y configurarlo, y luego podrá enviar los mensajes necesarios a cualquier chat seleccionado.
2. Históricamente hay 2 tipos de interacción en la API de mensajes de Telegram: botones debajo del texto ((botones en línea) [ https://core.telegram.org/bots/2-0-intro#switch-to-inline-buttons ]) y respuestas al bot directamente texto En general, las respuestas con el bot están irremediablemente desactualizadas. Los botones son un poco más complicados desde el punto de vista de la implementación, pero esto se paga por la facilidad de uso y deben usarse para todas las entradas que no sean de texto.
3. Como ejemplo de un bot, puedes ver el popular @vote_bot o nuestro @osmand_bot.

Telegram Client

No pudimos encontrar ejemplos de clientes de telegramas listos, excepto el principal, pero la estructura bastante simple de tdlib nos ayudó a crear un cliente básico en solo un par de días.

 task downloadTdLibzip { doLast { ant.get(src: 'https://core.telegram.org/tdlib/tdlib.zip', dest: 'tdlib.zip', skipexisting: 'true') ant.unzip(src: 'tdlib.zip', dest: 'tdlib/') } } task copyNativeLibs(type: Copy) { dependsOn downloadTdLibzip from "tdlib/libtd/src/main/libs" into "libs" } task copyJavaSources(type: Copy) { dependsOn downloadTdLibzip from "tdlib/libtd/src/main/java/org/drinkless/td" into "src/org/drinkless/td" } dependencies { implementation fileTree(dir: 'libs', include: ['*.jar']) } 

Casi todas las partes internas del Telegram están escritas en C ++ y desde el punto de vista de Android, solo la clase API es visible en los métodos proxy TdApi.java de 1.5 MB. Al comparar la documentación de los bots y el nombre de los métodos, simplemente puede averiguar dónde moverse.

 fun init(): Boolean { return if (libraryLoaded) { // create client client = Client.create(UpdatesHandler(), null, null) true } else { false } } 

 private fun requestUserPhoto(user: TdApi.User) { val remotePhoto = user.profilePhoto?.small?.remote if (remotePhoto != null && remotePhoto.id.isNotEmpty()) { downloadUserFilesMap[remotePhoto.id] = user client!!.send(TdApi.GetRemoteFile(remotePhoto.id, null)) { obj -> when (obj.constructor) { TdApi.Error.CONSTRUCTOR -> { val error = obj as TdApi.Error val code = error.code if (code != IGNORED_ERROR_CODE) { listener?.onTelegramError(code, error.message) } } TdApi.File.CONSTRUCTOR -> { val file = obj as TdApi.File client!!.send(TdApi.DownloadFile(file.id, 10), defaultHandler) } else -> listener?.onTelegramError(-1, "Receive wrong response from TDLib: $obj") } } } } 

Telegram Client - trampas

1. Registro / inicio de sesión y cierre de sesión. Al registrarse, es necesario tener en cuenta diferentes escenarios: cuando el código de acceso se envía por SMS u otro cliente de telegramas, autorización de dos factores, etc. El mayor desafío es probar. Cualquier autorización más de 3 veces condujo al bloqueo de la cuenta durante 24 horas, por lo que probar Logout fue especialmente divertido. A pesar de que el registro se necesita solo una vez, esta es probablemente la parte más difícil de la integración.
2. Determine cómo y en qué orden leer los mensajes. Cualquier cliente tiene acceso a todos los mensajes en todos los chats, pero deben leerse secuencialmente. En nuestro caso, el 99% de los mensajes deben descartarse. Primero, por alguna razón, leímos todos los mensajes de los últimos 3 días con un inicio de sesión, pero luego solo causó problemas y cuando reiniciamos, los mensajes desaparecieron. Por lo tanto, ahora solo leemos mensajes nuevos y, para los mensajes que necesitamos, guardamos la identificación en la base de datos interna.

Que paso

Probablemente, conociendo todas las trampas, uno podría hacer todo muchas veces más rápido, pero resultó para aproximadamente 1-2 meses para tres personas. La aplicación final se puede encontrar en Google Play .

La pregunta principal en esta historia es cuán correcta es esta interacción desde el punto de vista de Telegram y si a los usuarios les gusta este tipo de integración. En cualquier caso, la idea en sí misma es un nicho y ya ha encontrado clientes individuales.

Estaré encantado de responder a sus preguntas.