Graphlogic.ai documentation

How to create and configure Slots

Sending files to bot users | Attachment slot

Purpose and general information

⁠

@Attachment⁠

is a

@Slot⁠

designed for sending attachment files of the specified type from the

@Agent⁠

to the Interlocutor. For example, using this

@Slot⁠

you can send an audio, video or image to your

@Bot User⁠

, which will be displayed correctly in the messenger with a preview. One

@Attachment⁠

@Slot⁠

sends one file.

⁠

Slot creation and settings

Slot attributes

⁠

Name — the name of the

@Slot⁠

that will be displayed in the

@Script Tree⁠

. The maximum length of a field value is 40 characters.

Source — a link to a file or a

@Context Variable⁠

containing a link to the file that should be sent.

Trimming spaces: by clicking the CREATE button (when creating a

@Slot⁠

) or SAVE (when editing a

@Slot⁠

), spaces and line breaks at the beginning and end of the Source field are trimmed.

Caption — an accompanying text message to the file or a variable with text that should be attached to the file. Line breaks are preserved.

Long messages will be trimmed to 1024 characters (this message length meets the requirements of all supported instant messengers and omnichannel platforms).

Concatenation of strings and variables is allowed by including variables in the format {{ var }} in the text, for example: here is your file {{ filename }}.

The outer spaces of the final message will be trimmed.

Primary type — type of file being sent, for correct display and preview of the

@End Channel⁠

. Valid options:

Image

Audio

Video

File

Validation: by pressing the CREATE button (when creating a

@Slot⁠

) or SAVE (when editing a

@Slot⁠

), the presence of the selected file type is checked:

If there is no type of the selected file type, the error Please choose a primary type is displayed

⁠

The user selects the desired type in which the file should be displayed to the

@Bot User⁠

. For example, in Telegram an image can be sent with the Image type, then it will be displayed directly in the messenger, or with the File type, then it will be displayed as a file that can be downloaded.

Using syntax in Slot

In the

@Attachment⁠

@Slot⁠

, it is allowed to use

@Expression⁠

and

@Expression with Control Structure⁠

in the Text List field. More details:

Syntax⁠

Slot operation

When executing an

@Attachment⁠

@Slot⁠

The

@Agent⁠

receives the values in the Source and Caption fields, performs concatenation in these fields, if present, trims the Caption value to 1024 characters.

The

@Agent⁠

sends a file available via a link in the Source field and an accompanying message from the Caption field to the

@End Channel⁠

indicating the Primary type — the type by which the file should reach the

@Bot User⁠

The

@End Channel⁠

validates the link from the Source field to the item:

this is a direct link to the file (the file is downloaded from this link);

the file in the link corresponds to Primary type;

the file in the link meets the criteria for the Primary type in this

@End Channel⁠

in size and content.

Important: to determine the requirements for files of each type, you must read the official documentation of the channels to where you deply the
@Agent⁠
; each messenger and social network has its own requirements, which can be changed at any time by the developers of these channels.

If the file is successfully validated from Source, it is delivered in the specified Primary type to the

@Bot User⁠

, and an accompanying message is attached to the file (no more than 1024 characters from the Caption field).

Important: delivery of large files to the
@Bot User⁠
may take a long time; this must be taken into account when constructing the
@Script⁠
. The
@Bot User⁠
may have time to write before the large file is delivered to him.

In case of unsuccessful file validation from Source or sending error from the

@End Channel⁠

, the

@Agent⁠

repeats sending data from the

@Attachment⁠

@Slot⁠

, but in the form of 2 text messages: the first is the value from the Source field, the second is the value from the Caption field. Before such sending, concatenation and retrieval of variable values also occurs, if they are used in these fields.

If the

@End Channel⁠

does not generally support sending files, the value of the Source and Caption fields are sent in two text messages. Before such sending, concatenation and retrieval of variable values also occurs, if they are used in these fields.

Not all

@End Channel⁠

s support transferring files to the

@Bot User⁠

“in the form of files”; some can only transfer a link to download the file. The table shows which

@End Channel⁠

s support “file-based” file transfers.

Possibility of transferring files to the channel

Possibility of transferring files to the channel

Functionality

Channel

Availability

Description

Transferring files as files from the Agent

Webim (External Bot API 2.0)

In WhatsApp via Webim: if the bot sent buttons to the

@Bot User

⁠

, then Webim will convert them into a numbered list and process only the entry of the element number; entering a button label or other text will not be processed — Webim will not accept other characters/text

Transferring files as files from the Agent

Jivo

Transferring files as files from the Agent

Webim (External Bot API 1.0)

Yes

Transferring files as files from the Agent

Webim (External Bot API 1.0)

The

@Attachment

⁠

slot will pass a text link

Transferring files as files from the Agent

Livetex

Yes

Transferring files as files from the Agent

Edna Chat Center

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

Transferring files as files from the Agent

360Dialog (WhatsApp)

Partially

The picture is not transmitted, the video is transmitted, the audio is transmitted as an audio file, the file is transmitted as a file for downloading

Transferring files as files from the Agent

Debug widget

Transferring files as files from the Agent

Chat2Desk

Yes

The widget receives an icon leading to a link like

https://storage.chat2desk.com/companies/company_236200/messages/199219/Kalimba.mp3

⁠

; when you click, the content is automatically played.

Images are transmitted as images.

Transferring files as files from the Agent

Chat API

Transferring files as files from the Agent

Viber

Transferring files as files from the Agent

Microsoft Teams

Yes

Transferring files as files from the Agent

Edna Pulse

Yes

Transferring files as files from the Agent

VK Teams

Partially

Attachment is sent as a link from Source field of

@Attachment

⁠

@Slot

⁠

, which is turned into a file by VK Teams

Transferring files as files from the Agent

Line messenger

Transferring files as files from the Agent

360Dialog (cloud)

Partially

The picture is not transmitted, the video is transmitted, the audio is transmitted as an audio file, the file is transmitted as a file for downloading

Transferring files as files from the Agent

Widget

Transferring files as files from the Agent

Bitrix24

Yes

No results from filter

⁠

Purpose and general information

Slot creation and settings

Slot attributes

Using syntax in Slot

Slot operation

Possibility of transferring files to the channel

Want to print your doc?
This is not the way.

Try clicking the ⋯ next to your doc name or using a keyboard shortcut (

CtrlP

) instead.