Titan AI Docs

Setup

Slack

Connect your Slack workspace so your team can tag Titan AI in channels and DMs, approve its actions without leaving Slack, and have Titan AI post to a channel or DM you from a chat.

Connecting Slack puts Titan AI in the place your team already talks. Someone tags @TitanAI in a channel, asks a question about your account, and the answer comes back in the thread. Actions that change something raise approval buttons in Slack itself, so nobody has to open the web app to say yes.

Every turn runs as the Titan AI account that connected the workspace, whoever asked the question. Which store it reads can vary, because a person listed under Allowed Slack users can be given their own default store.

Before you start

You need a Slack workspace you are allowed to install apps into. Slack asks you to approve the install, and on many workspaces that step needs an admin.

One workspace connects to one Titan AI account. The first install wins, so if a colleague has already connected your workspace, your attempt is refused rather than quietly taking theirs over.

Connect Slack

  1. 1

    Open the catalogue

    Open Connectors & Skills from the sidebar, press Add Connector, and choose Browse Connectors. Find Slack in the list. It only appears under My Connectors once it is installed.

    The Browse Connectors catalogue with the Slack entry highlighted.
    Slack sits in the catalogue next to Titan Tools Account.
  2. 2

    Read the consent line and tick it

    The box reads "I understand that allowed Slack users in my workspace will be able to see this account's Amazon data through Titan AI." That is the whole point of the connector and it is worth reading rather than clicking past: people you allow can ask about your store from Slack. Connect Slack stays disabled until you tick it.

    The Slack connector panel with the consent checkbox ticked and the Connect Slack button enabled.
    Connect Slack stays disabled until the consent box is ticked.
  3. 3

    Approve it in Slack

    Press Connect Slack. A Slack window opens asking you to pick the workspace and approve Titan AI. Approve it and the window closes by itself.

    Slack's own permission screen for connecting your workspace, with a workspace picker, the permissions being requested and an Allow button.
    This screen is Slack's, not Titan AI's. Check the workspace before you press Allow.
  4. 4

    Confirm it connected

    The connector now shows your workspace name and the address that connected it.

    The Slack connector listed under My Connectors showing Connected.
    Connected. Slack now appears under My Connectors.

For the full connector walkthrough, see Add a connector.

Choose who can use it, and on which store

Once connected, the same panel carries five settings.

Default Titan Tools account. Which store a Slack turn runs against when nothing more specific applies. Leave it on Oldest linked account (default), or pick a store by name. This matters as soon as you have more than one store, because a question asked in Slack carries no store selector.

Channel access. Either Anyone in channels the bot is in, which is the default and means inviting Titan AI to a channel is what grants access to it, or Allowlisted users only, which restricts it to the people you list below no matter which channel they ask in. Pick the second one if your workspace has channels with people who should not see store numbers.

Allow Titan AI to make changes to your Amazon account from Slack. A tickbox, off by default. Everything Titan AI does from Slack runs against the connected Amazon account of whoever set the connector up, whoever in the workspace asked, so this is the person whose account is at risk and therefore the only one who can accept that risk. Reading data is unaffected either way.

Read the amber note under it before you rely on this. The setting is not enforced yet: your answer is saved now, but today anyone who can use Titan AI in the workspace can already propose changes to that account whichever way the box is set. It starts restricting things when Titan AI turns the restriction on. Until then, treat Channel access and Allowed Slack users as the controls that actually bite.

Notification channel ID (optional). Where Titan AI posts when you ask it to send something to Slack without naming a channel. It takes a channel ID like C0123456789, not a channel name.

Allowed Slack users. Add people by Slack user ID, in the form U0123456789. Each entry can default that person to a specific store, or leave them on Workspace default. This sets where their turns start, and does not stop them switching store later in the conversation. Adding someone here is also what lets them direct message Titan AI: channel access follows the Channel access setting above, but a DM always requires an entry in this list.

It wants a user ID, not a name

Both fields take Slack IDs rather than display names or channel names. A user ID starts with U and a channel ID with C. In Slack, open a person's profile or a channel's details and use Copy member ID or Copy channel ID.

The two fields do not behave the same way when you get it wrong. Allowed Slack users is checked and refuses a badly shaped ID on the spot. Notification channel ID still saves, and the window then checks it: it shows the channel's name when Titan AI can see that channel, and a warning when it cannot, or when it could not check. If you see the warning, fix the ID, or invite Titan AI to a private channel, before you rely on notifications. To be sure, ask Titan AI to send something to Slack without naming a channel, and check that it arrives.

The connected Slack panel showing the workspace, Default Titan Tools account, Channel access, the Amazon write tickbox with its Not enforced yet notice, Notification channel ID and Allowed Slack users.
All five settings. The amber notice under the Amazon write tickbox is worth reading.

Use it in Slack

Invite Titan AI to a channel the way you would any app, then tag it.

  • Ask in a channel. Tag @TitanAI with your question. The answer comes back as a thread on your message.
  • Keep going in the thread. Replies in that thread continue the same conversation, so you only tag it on the first message.
  • Fix a question you got wrong. Edit your message and Titan AI runs it again rather than leaving the old answer standing.
  • Ask privately. If your Slack user ID is in Allowed Slack users, you can open a direct message with Titan AI and ask there instead.

Send to Slack from a chat

In a chat on Titan AI itself you can ask it to send something into your connected workspace. It uses this Slack connection, the same Titan AI app you installed above, so you do not need any other Slack connector for it. Before a send, an approval card shows where the message is going and how it starts. Always allow on that card covers every later Slack send in the same conversation, to any channel or allowed person, so choose Allow once if you want to see each one.

  • Post in a channel. Name the channel, as #name or a channel ID. If you name neither a channel nor a person, it goes to your Notification channel ID.
  • DM yourself. Ask it to "DM me". Titan AI finds you in Slack by the email address of your Titan AI account. If your Slack account uses a different email, add your Slack member ID under Allowed Slack users, then ask again.
  • DM someone else. Give their Slack member ID (it starts with U). Titan AI only sends direct messages to you and to people under Allowed Slack users. Anyone else is refused and nothing is sent.
  • See which channels it can post to. Ask which Slack channels Titan AI can see. Public channels are listed whether or not Titan AI has joined them. A private channel only appears once you invite Titan AI to it with /invite @TitanAI. It lists up to 100 at a time, so in a large workspace ask for channels by name.

If you have connected more than one Slack workspace, Titan AI asks which one to use before it posts or lists anything, and the approval card shows the workspace you picked.

This works in chats on Titan AI. It is not available when you ask Titan AI from Slack, and scheduled tasks cannot send to Slack.

Approving actions from Slack

When Titan AI wants to do something that changes your account, it does not just do it. The message gets four buttons:

  • Allow once runs that one action.
  • Always allow stops it asking again for that action, in that thread only. It does not carry into other threads or into the web app. Archiving is the exception: an archive cannot be undone, so an archive message has no Always allow, and approving one never approves the next. Sponsored Display campaigns, ad groups, product ads and targets, and Sponsored Brands keywords, targets and negatives, are archived through their ordinary change message instead, which does offer Always allow, so answer it with Allow once, and press View raw to see exactly what it will change before you do. If Always allow was already chosen for that action in the thread, a later archive of that kind goes through with no message at all, so ask in a new thread.
  • Deny refuses it.
  • View raw opens the full request so you can read exactly what it was going to send before you decide.

Whoever can use Titan AI in that channel can press these, not only the person who asked. That keeps a request from sitting unanswered because one person is away, but it is worth being clear about the reach: on the default Anyone in channels the bot is in, that means anyone in the channel, including people who are not in your Allowed Slack users list. If a write should only ever be approved by named people, set Channel access to Allowlisted users only.

An approval expires after nine minutes

If nobody presses anything within nine minutes, the request expires and is treated as denied. Nothing runs. Ask again and a fresh set of buttons appears.

Disconnect

Press the unlink icon next to your workspace name. Titan AI stops responding in Slack straight away.

Disconnecting does not throw your history away. Your settings, your allowed users and your existing threads are kept, so reconnecting the same workspace later picks up where you left off rather than starting from an empty panel.

Troubleshooting

Titan AI does not answer when tagged. Check it is actually in the channel: invite it the way you would any other app. If Channel access is set to Allowlisted users only, also check the asker's Slack user ID is in Allowed Slack users.

A direct message goes unanswered. DMs need an explicit entry. Add that person's Slack user ID under Allowed Slack users and try again.

Sending to a channel fails with channel_not_found. Titan AI tells you which workspace it is connected to. There are two causes, and Slack does not say which: the channel is private and Titan AI has not been invited (run /invite @TitanAI in that channel), or the channel belongs to a different workspace from the connected one.

A DM from a chat asks you to reconnect Slack. Your workspace was connected before Titan AI asked Slack for permission to send direct messages. Open the Slack row under My Connectors on the Connectors & Skills page, use Connect a workspace, and pick that workspace when Slack asks. Nothing needs disconnecting first, any other connected workspace keeps working, and its settings and Allowed Slack users are kept.

A DM to a colleague is refused. Titan AI only messages you and the people under Allowed Slack users. Add their Slack member ID there and ask again.

Connecting is refused. Someone else has already connected this workspace to a Titan AI account. One workspace connects once, and the first install wins. Ask them to disconnect first if the connection should be yours.

It answers about the wrong store. Slack turns have no store selector, so they use the Default Titan Tools account, or the store that person defaults to under Allowed Slack users. Set one or both.

The approval buttons stopped working. They expire nine minutes after they appear. Re-run the request to get a new set.

Still stuck? Send us feedback and we will take a look.