Koast Agent

Use the agent from Telegram and Slack

Link Telegram or Slack to your Koast account, then ask the agent questions and approve its changes from the chat app.

You can ask the agent from Telegram or Slack as well as from the web chat. Link your chat account to your Koast account once. After that you message the agent in the chat app, and it answers there.

In both apps you can:

  • Ask about spend, results and reports for your ad accounts without opening Koast.
  • Approve or cancel the changes the agent proposes with one tap.
  • Send a screenshot, a file or a voice clip along with your question.

You can find the links to both apps in Settings, then Agent: the line Use the agent from Telegram or Slack opens each settings page.

Before you start

  • The agent in a chat app has the same limits as the web chat. If your role is View Only, or your role doesn't allow using the agent, the agent tells you it isn't available to you.
  • If your Koast plan doesn't include the agent, the agent can't answer in the chat app either.
  • An organization owner or admin can turn Telegram or Slack off for the whole organization. See Turn an app off for your organization.
  1. Open Settings, then Account, then Telegram.

  2. Select Connect Telegram. Koast shows Open Telegram and press Start to connect. with a countdown.

  3. Select Open Telegram, or scan the QR code with your phone, and press Start in the chat with the bot.

The link works once and expires after 10 minutes. If it expires, the page says The link expired. and the button reads Get new link.

Press Start in a private chat with the bot. A link opened in a group doesn't link anything. Once it works, the bot replies that you're connected and the settings page shows your Telegram name and when you last used it.

If that Telegram account is already linked to another Koast account, the bot tells you to unlink it there first.

  1. Open Settings, then Account, then Slack.

  2. Select Connect Slack and sign in with Slack.

  3. You come back to Koast with your Slack account linked. Koast also sends you a direct message in Slack, with an Unlink button, and an email.

Each teammate links their own Slack account. To link another workspace, select Connect another workspace.

Add the Slack app to a workspace first

Koast Agent has to be added to a Slack workspace before anyone in it can use it. This happens once for the whole workspace, and it needs someone who can add apps there. Adding the app does not link anyone: every person still links their own account.

The person who connects first usually does both in one go. If the workspace doesn't have the app yet, Connect Slack sends you on to Slack's page to add it, and links your account when you finish. You can also select Add to workspace on the Slack settings page. Afterwards the page says Koast Agent is installed. Now link your Slack account.

Slack can refuse the install:

  • The install link expired. Add Koast Agent again. Start again from Add to workspace.
  • Slack denied the install. Add Koast Agent again.
  • Koast Agent can’t be installed org-wide. Choose one workspace. Pick a single workspace in Slack, not the whole Enterprise Grid organization.

Ask the agent in Telegram

In a private chat with the bot, write your question like any message. You don't need a command.

If you haven't linked Telegram yet, the bot tells you where to connect and gives an Open Koast button.

In a group

The bot only answers a message that is addressed to it. In a group, do one of these:

Do thisWhat happens
Write /ask and your questionThe agent answers your question. For example: /ask how did my ads do yesterday?
Reply to one of the bot's messagesThe agent takes your reply as the question.
Mention the bot by its @ nameThe agent takes the rest of the message as the question.
Write /helpThe bot explains how to ask. A bare /ask or /start does the same.

Good to know about groups:

  • Group chats are off by default. An organization owner or admin has to turn on Group chats first. See Turn an app off for your organization. Until then the bot tells you in a private chat: I don't answer here. Message me directly instead.
  • Everyone in the group sees the answers.
  • The bot answers as the Koast account linked to your Telegram account.
  • If you haven't linked your account, the bot replies once with a nudge to link it first. It can't tell who you are if you post as an anonymous admin, so post as yourself.
  • Forwarded messages are ignored.
  • A group has a limit of 60 messages to the agent an hour, on top of each person's own limit.

Ask the agent in Slack

Use either of these:

  • A direct message. Open a direct message with Koast Agent and write your question. Each conversation starts a thread.
  • A mention in a channel. Mention Koast Agent in a channel it's been added to, with your question. The agent answers in the thread.

If you haven't linked Slack yet, the agent sends you a private message that only you see, with a nudge to link first and an Open Koast button.

Good to know about Slack:

  • Koast Agent only answers members of the workspace it's installed in. A Slack Connect user or a member of another workspace gets Koast Agent answers members of and the workspace name.
  • Channels shared with another company are off by default. An organization owner or admin has to turn on Shared channels first. See Turn an app off for your organization.
  • A channel has a limit of 60 messages to the agent an hour, on top of each person's own limit.
  • If the agent is still working on your last message, it says so. Wait for it to finish.

Approve or cancel changes

When the agent proposes a change, it posts a card in the chat with Approve and Cancel buttons. Tap one to decide, without opening Koast. It works like the approval cards in the web chat. See What the agent does on its own, and what it asks first.

  • Only the person who asked can decide. Anyone else who taps gets Only and the asker's name can decide this.
  • After you approve, the card says Approved by your name and that it's running. After you cancel, it says Cancelled by your name and Nothing was changed.
  • Koast checks again when you tap. If your role, your organization's setting or your plan no longer allows it, the card says Not run with the reason, and nothing changes.
  • An approval card that expires says Expired. Nothing was changed. Ask again if you still want the change.
  • A change that is too large for the card says so and points you to the chat in Koast to review it there.
  • If you unlink your account, its open cards close and nothing is changed.

Send a screenshot, a file or a voice clip

Send the file or the clip with your question. The caption is your question. In a Telegram group or a Slack channel, the message has to address the agent like any other.

WhatLimit
DocumentsPDF, Word, Excel, CSV, text and Markdown, up to 25 MB
ImagesJPEG, PNG, WebP and GIF, up to 10 MB
VideosMP4 and MOV, up to 100 MB
VoiceUp to 5 minutes a clip, 20 clips an hour and 30 minutes a day
  • Telegram only lets the agent download files up to 20 MB, whatever the kind.
  • Images and videos are saved in a brand's library, so you need a brand with access picked. A video also needs the brand to have an ad account selected in Koast. Documents are saved to you and not to a brand.
  • A file needs the same permission as the web upload. If your role is View Only, the agent says it can't save files for you.
  • A file that's too large or of another type is refused with a short reply that says what it can take.
  • If the agent can't listen to voice clips right now, it asks you to type your question.

The agent acts as you

The agent uses your own Koast access, not the access of whoever owns the chat or the workspace. It sees the brands and ad accounts you can see, and it can only change what your role allows. Changes it makes after you approve them are made in your name.

Because of that, Koast emails you when a chat account is newly linked, and in Slack it also sends a direct message.

Each person can send 30 messages an hour to the agent from chat apps.

Turn an app off for your organization

An organization owner or admin can control the agent in chat apps under Settings, then Organization, in Chat apps.

SettingWhat it does
Allow TelegramWhen it's off, nobody in the organization can use the agent from Telegram. On by default.
Group chatsLets the agent answer in Telegram group chats. Everyone in the group sees the answers. Off by default.
Allow SlackWhen it's off, nobody in the organization can use the agent from Slack. On by default.
Shared channelsLets the agent answer in Slack channels shared with other companies. Off by default.

Unlinking stops the agent from answering you in that app. Your chats stay in Koast.

  1. Open Settings, then Account, then Telegram or Slack.

  2. Select Unlink next to your account.

  3. Confirm in the dialog: Unlink Telegram? or Unlink Slack?

In Slack you can also select Unlink in the direct message Koast sent when you linked. Only the linked Slack account can unlink it there.

Any card still waiting for a decision closes without changing anything. You can connect again at any time.

On this page