Adaptateur Telegram pour InterSystems IRIS

L' adaptateur Telegram pour InterSystems IRIS sert de pont entre la populaire plateforme de messagerie Telegram et InterSystems IRIS, facilitant une communication et un échange de données transparents. En exploitant les capacités de l'API Telegram, l'adaptateur permet aux développeurs de créer des chatbots robustes, d'automatiser des tâches et d'intégrer Telegram aux applications d'InterSystems IRIS.

Les scénarios les plus courants dans lesquels l'adaptateur Telegram peut être utilisé sont les suivants :

• Notifications système en temps réel : Envoi de notifications immédiates sur des événements spécifiques se produisant dans le système. Il peut s'agir d'alertes, de mises à jour ou d'informations système importantes transmises aux utilisateurs ou aux administrateurs via Telegram.
• Interaction avec les clients et applications de chatbot : Il peut s'agir de diverses activités telles que la prise de rendez-vous, les rappels de rendez-vous et la réalisation d'enquêtes NPS (taux de recommandation net) pour recueillir les commentaires des clients. Il est possible de créer des chatbots intelligents qui s'intègrent aux systèmes existants, ont accès à des bases de connaissances étendues et sont capables de répondre aux questions des utilisateurs.
• Apprentissage et test : Il peut être utilisé pour diffuser du matériel de formation, des quiz interactifs ou effectuer des évaluations par l'intermédiaire de Telegram.

Caractéristiques et fonctionnalités clés

• Communication bidirectionnelle
• Toutes les fonctionnalités de l'API Telegram Bot sont prises en charge (https://core.telegram.org/bots/api)
• Services commerciaux, opérations métier et messages prêts à l'emploi

Caractéristiques techniques de l'adaptateur.

Le paquet telegram-adapter comprend non seulement l'adaptateur lui-même, mais aussi des services commerciaux prêts à l'emploi (Telegram.LongPollingService.cls et Telegram.WebHookService.cls), une opération métier (Telegram.BusinessOperation) et la classe de message Telegram.Request.

On suppose que vous n'aurez pas besoin de créer vos propres services métier ou opérations métier.

Chacun de ces services métier créera et enverra un message contenant toutes les données brutes (reçues de telegram) au composant de production désigné, comme spécifié dans les paramètres. En outre, vous avez la possibilité de configurer l'enregistrement automatique des fichiers (documents) à partir des messages entrants.

Pour envoyer un message, vous devez créer un message Telegram.Request, en spécifiant la méthode API à invoquer, et dans le champ Data, inclure le JSON avec tous les champs requis pour l'API Telegram. Par exemple, envoyons un message texte :

Set msg = ##class(Telegram.Request).%New()
Set msg.Method = "sendMessage"
// Tous les champs possibles sont décrits ici https://core.telegram.org/bots/api#sendmessage
Set msg.Data = {
    "chat_id" : (..ChatId),
    "text": ("*bold text*" _$$$NL_ "_italic text_ " _$$$NL_ "```"_$$$NL_"pre-formatted fixed-width "_$$$NL_"code block```"),
    "parse_mode": "MarkdownV2",
    "disable_notification": "true"
}
Return ..SendRequestAsync("Telegram.BusinessOperation", msg)

Pour envoyer des fichiers tels que des images, des fichiers vidéo, des fichiers audio et d'autres types de fichiers, vous devez ajouter le nom complet du fichier (y compris le chemin d'accès) à la collection "Files" de l'objet Telegram.Request et utiliser le même chemin d'accès dans les champs correspondants du message JSON. Voici un exemple :

Set filePath = "/path/to/photo.jpg"
Set msg = ##class(Telegram.Request).%New()
Set msg.Method = "sendPhoto"
Do msg.Files.Insert(filePath)
// Tous les champs possibles sont décrits ici https://core.telegram.org/bots/api#sendphoto
Set msg.Data = {
    "chat_id": (..ChatId),
    "photo": (filePath),
    "caption": ("IRIS Telegram Adapter Demo")
}
Return ..SendRequestAsync("Telegram.BusinessOperation", msg)

Démonstration de l'adaptateur Telegram

Le paquet telegram-adapter-demo comprend un exemple de mise en œuvre d'un chatbot Echo..

Le chatbot répond à tout message texte qui lui est envoyé. Si vous envoyez un fichier .png, il répondra également avec une vignette de cette image, générée automatiquement par Telegram. Pour exécuter cet exemple, suivez toutes les étapes d'installation décrites dans la documentation fournie ici : . Une fois le processus d'installation terminé, vous pourrez lancer et expérimenter cet exemple de chatbot Echo.