Graphlogic.ai documentation

Messengers

⁠

Telegram⁠

is a messenger that has a web version, a desktop version, and a version for mobile devices. Has built-in chatbot functionality.

Connection

1. Creating a bot on the Telegram side

First of all, you need to make a configuration on the Telegram side.

Open Telegram and log in.

Search for the “BotFather”

@Bot⁠

⁠

Create a

@Bot⁠

in Telegram:

Send the /newbot command to the BotFather

@Bot⁠

In response to the

@Bot⁠

message, enter the desired name for your

@Bot⁠

⁠

Enter your desired

@Bot⁠

ID. It must be unique among all existing

@Bot⁠

s in Telegram and end with “bot”. For example, My_new_telegram_bot_username_bot.

⁠

If the submitted

@Bot⁠

ID meets the requirements, you will receive a successful bot creation message. The message will contain a link to your

@Bot⁠

in Telegram and an access token to the

@Bot⁠

⁠

Copy the access token to a convenient location.

⁠

You can configure the avatar, description, and other parameters of the bot through the BotFather

@Bot⁠

This completes the configuration of the

@Bot⁠

in Telegram.

2. Agent channel configuration in the Platform

You need to create and configure an

@Project Channel⁠

with the “Telegram” connector.

Click on the

@Agent⁠

settings button.

⁠

Click the Add channel button.

⁠

The

@End Channel⁠

selection panel will open.

⁠

Select

@Telegram⁠

The

@Project Channel⁠

creation panel will open.

⁠

Optionally, enter a title for this

@Project Channel⁠

in the Name field with the placeholder New channel.

⁠

Paste the previously copied token into the Telegram bot token field.

⁠

Optionally, enable receiving of service messages by switching the toggle switch.

⁠

To save the

@Project Channel⁠

without activating it, click the CREATE button.

⁠

To save and activate the

@Project Channel⁠

, click the CREATE & ACTIVATE button.

⁠

The

@Project Channel⁠

will be saved and activated if:

The

@Agent⁠

is trained;

The token in the Telegram bot token field is unique (there are no active channels of the same type with the same token);

The channel address is accessible;

The channel webhook is registered succesfully.

The

@Project Channel⁠

will be saved but not activated if one or more conditions are not met.

To cancel

@Project Channel⁠

creation, click the CANCEL button.

⁠

Editing and Deleting Agent Channel

To edit an

@Project Channel⁠

, click on its icon on the

@Agent⁠

card.

⁠

To edit any field, click the field and enter a new value.

To apply changes to an activated

@Project Channel⁠

, click the APPLY button.

⁠

Changes will be applied if:

The

@Agent⁠

is trained;

The token in the Telegram bot token field is unique (there are no active channels of the same type with the same token);

The channel address is accessible;

The channel webhook is registered succesfully.

Changes will not be applied if one or more conditions are not met.

To deactivate the

@Project Channel⁠

, click the DEACTIVATE button.

⁠

To apply changes to a non-activated

@Project Channel⁠

, click the SAVE button.

⁠

To apply changes and activate the

@Project Channel⁠

, click the SAVE & ACTIVATE button.

⁠

Changes will be applied and the

@Project Channel⁠

will be activated if:

The

@Agent⁠

is trained;

The token in the Telegram bot token field is unique (there are no active channels of the same type with the same token);

The channel address is accessible;

The channel webhook can be registered.

Changes will be applied but the

@Project Channel⁠

will not be activated if one or more conditions are not met.

To cancel making changes, click the CANCEL button.

⁠

To delete the

@Project Channel⁠

, click the DELETE button.

⁠

Communication

Communication in Telegram group chats

The

@Bot⁠

can be added to a Telegram group chat and process messages and events from this chat.

In order for the

@Bot⁠

to process all messages sent to the group, you must provide it with access to all messages by turning off the Group Privacy setting:

Go to BotFather;

Write the command /mybots;

Select the desired

@Bot⁠

;

Go to Bot Settings → Group Privacy;

Select Turn off.

When the Group Privacy setting is enabled, in order to send a message that will be processed by the

@Agent⁠

and recorded in

@client_message⁠

, you must either reply to the

@Bot⁠

’s message (reply) or write your own message after the / symbol.

After each processed message, the

@Channel Variables⁠

will be set to the data of the group member who sent the message.

Also, the

@Agent⁠

processes events about new users being added to the group chat. In this case, a string like “telegram_chat_new_member: telegram_user_id|telegram_username|telegram_first_name|telegram_last_name” will be written to the

@client_message⁠

variable.

When upgrading a group to a supergroup, a new group ID is generated and the

@Agent⁠

cannot send a message.

Service messages in Telegram

Service messages in Telegram

Message

End channel

Format in client_message

Description

Cases

Telegram group user joined the group

String: telegram_chat_new_member: {user.id}|{user.first_name}|{user.last_name}

When a user joins a Telegram group, a message is sent to the

@client_message

⁠

context variable in accordance with the template

When a new user joins a group, the Bot can welcome him to the conversation by displaying his name. For example, you can add a

@Script Branch

⁠

where the

@Agent

⁠

will respond to this message and display the text “Hello, {user.first_name}|{user.last_name}! Welcome to the group!”

Telegram group user left the group

String: telegram_member_left_chat: {user.id}|{user.first_name}|{user.last_name}

When a user leaves a Telegram group, a message is sent to the

@client_message

⁠

context variable in accordance with the template

When a user leaves a group, the Bot can display a message about this. For example, you can add a

@Script Branch

⁠

where the

@Agent

⁠

will respond to this message and display the text “Unfortunately, {user.first_name}|{user.last_name} has left the group”

No results from filter

⁠

About what service messages are and how to activate their transmission from the

@End Channel⁠

Deployment of Agent to different channels⁠

Mapping of Channel variables from Telegram

Mapping  of Channel variables from Telegram

Channel variable

End channel

Variable in the body of an incoming request from a channel

Peculiarities

channel_visitor_id

When replying to a bot message in a group chat, the id of the responding user is written to the variable

channel_conversation_id

channel_visitor_firstname

first_name

channel_visitor_lastname

last_name

channel_visitor_phone

channel_visitor_email

channel_visitor_account

username

channel_visitor_auth

channel_visitor_source

channel_message_id

channel_reply_to

If the

@Bot User

⁠

's Message is not a reply to the

@Bot

⁠

's message in Telegram, the variable remains empty

No results from filter

⁠

Communication in Telegram

Communication in Telegram

Functionality

Channel

Availability

Description

channel_chat_id

Yes

Format: channel_visitor_id|telegram

Messages will reach the Bot User if the Agent writes first in an existing chat

Yes

Transfer to operator

There is no such functionality in the messenger

Buttons

Yes

Transferring files as links from the Agent

Yes

The file will be transferred by link if it does not meet Telegram's requirements for files of this type.

Transferring files as files from the Agent

Yes

Telegram can accept and send “file” attachments to

@Bot User

⁠

s only in gif, pdf and zip formats. Support for other formats is possible, but Telegram does not guarantee it.

When trying to transfer an image in the

@Attachment

⁠

slot, if a link to a file from Telegram is specified, the file will arrive as a link, not an image

Receiving a file from the Bot User into a script

Yes

A string is written to

@client_message

⁠

: file:File type|File ID|File link, for example, file:photo|HgYjJJGYuxkBAAMNYK1eZR1fbZv-KQ09Omcsz9A8AjwAAsSzMRtug3FJ079jiwXcvo-egdKiLgADAQADAgADeAADE7gCAAEfBA|https://api.telegram.org/ file/bot1815753186:AAH_LtRWy_FSDAGFgstlTaQdkHHIFHV3xGI/photos/file_0.jpg . In this case, the file will be available via the link within 24 hours. To receive the file in the future, you will need to update the link to the file using the

Telegram API

⁠

Receiving geolocation from an Bot User in a Script

Yes

The

@client_message

⁠

contains a string like location:Latitude|Longitude, for example, location:83.000000|54.000000

Delivery of messages over 1000 characters from Agent to Bot User

Yes

Messages up to 4096 characters are allowed

Markdown usage