Telegram, MAX and other messengers

You can write to the agent not only in the app but in a messenger too: the bot takes requests, sends answers and task reports, and asks questions with button cards. The conversation with the bot is not a separate one: it is your direct chat with the agent, and the app shows it with the same history.

Which messengers are available

The ready-made Samreshuuu bot works right away, with nothing to set up. An organization bot carries your company's name and avatar and is connected by an admin (see Your own organization bot below).

How to connect a private chat with the bot

You can also start from the bot: write it anything. It replies with a greeting and a Connect button, the site asks you to sign in or sign up and brings you back to the chat. Messages sent before connecting (up to 5) are passed to the agent if you connect the chat within 60 min of the first one.

You disconnect a chat in the same place, on the Messengers card. The bot stops writing to you, and other chats stay. If that messenger was the only address for some tasks' reports, the app warns you and offers to pick another one for them.

The bot asks for permission: what it is and where to answer

When the agent is about to change or send something (adjust a price, reply to a customer, create a deal), the bot sends a card saying exactly what will be done and in which service. It is the same question as in the app:

• Approve: do it this once;
• Reject: don't do it;
• Always allow: do it and remember exactly this operation, so it goes through without asking next time.

Until you answer, the agent does not perform that action. You can answer in the bot or in the app, whichever is handier. Which actions are asked about and which go on their own is set in Settings → Capabilities → Auto-review: Approving actions.

Other messages that look like a permission request:

• "An owner or admin of the organization approves this action, the card is already with them." Your organization has a rule that an admin approves such actions. Wait for their answer or write to them.
• A key, a password, a payment or a step on a website (sign-in, captcha). This is done only in the app: keys are not sent in a chat, and a purchase cannot be approved in a chat. The bot says what is needed and gives a button to the app.
• A Connect button in an unfamiliar chat. This connects the chat to an account. If someone else sent you the link, press Cancel.

How the bot differs from the app

The agent in the bot is the same: the same connected services, skills, memory and tasks. What differs is what the messenger itself can do.

More on the limit: Plans and limits.

Bot commands

The set of commands depends on the messenger: in Pachca, for example, /connect only opens sign-in to the web version.

How fast the bot answers

As fast as the agent in the app: the model and the work are the same, and the answer arrives in the chat whole once the agent is done. While it works:

• the bot shows it is typing, and your message carries a mark that it was accepted;
• if the work is long, a "Working" message appears with the current step and a Stop button;
• a new message sent during the work is not lost: the bot replies that it is queued, and the agent takes it up next.

A slow answer usually comes from the work, not the bot: an export from a marketplace, parsing a large file, waiting for your answer on a card. If an answer takes longer than usual, open this chat in the app: it shows which step the agent is on.

Files in the bot

• What you can send. Documents (PDF, Word, Excel, text), photos and voice messages. The agent receives a voice message as text, like a typed reply.
• Size. In Telegram, files up to 20 MB reach the bot, which is Telegram's own limit. If a file is larger, the bot says so: send it in the app.
• What is not read. For an attachment the bot does not parse, it asks you to describe the task in words or send a file.
• Files from the agent arrive as attachments. If attaching fails, the bot sends a link, and the files stay in the app.

All file limits: Limits.

The bot in a group

The bot can be added to a messenger group where your team talks, and to a Telegram channel for task reports. In a group it answers only when mentioned with @ or when you reply to its message.

By default a group has no connected services, skills, tasks or personal memory: any member can write there. The agent's owner can open the group to their services with the Work with the owner's services switch in Settings → Notifications & messengers → Groups and channels. How to connect a group, what becomes available and on whose messages: Group chat.

Can the agent message a counterparty in a messenger by itself

Not in someone else's private Telegram or MAX chat. The bot writes only where it was connected: your private chat with the bot and your organization's groups and channels. The agent can reach a supplier, customer or contractor like this:

• By email from its own address. The agent has its own address (Agents). It sends you the first email to a new address as a card for approval, and the reply comes back to the chat.
• With a reply link. The agent prepares the text and a link, and you send them yourself in any messenger or by email. The person answers through the link without signing up, and the answer arrives in your chat with the agent.
• Through a contact in Samreshuuu. If the counterparty also has an agent and you are each other's contacts, your agent writes to theirs.
• Through a connected service. If customers write to you in a service connected under Integrations (a CRM, open lines, a business messenger), the agent answers them in that conversation when the connection has that right: Connected services.

Your own organization bot

An organization bot carries your company's name and avatar and is needed for Pachca, Microsoft Teams and Slack, and for Telegram channels.

For a Telegram bot to see more than commands in groups, turn off Group Privacy in @BotFather (/mybots → bot → Bot Settings → Group Privacy → Turn off) and invite the bot to the group again.

If the bot stopped writing