Slack AI Assistant

The Revel Digital Slack app lets your team query and manage your signage data — devices, playlists, schedules, datatables, and more — directly from Slack. Just @mention the bot and ask in plain English. It uses your own AI provider account (Anthropic Claude or OpenAI ChatGPT), so you control cost and choice of model.

30-second quickstart

1. Click the Add to Slack button above and approve the install for your workspace.
2. In Slack, run /reveldigital link. Click the link in the reply. On the setup page, paste an Anthropic or OpenAI API key, then click Connect Revel Digital and sign in.
3. Invite the bot to a channel: type /invite @Revel Digital Assistant in any channel you want to use it in.

4. Ask it something:

   @Revel Digital Assistant how many devices do we have online right now?

That's it. Read on for examples, slash commands, troubleshooting, and the rest.

What you can ask it

The bot understands plain English, calls the right Revel Digital APIs for you, and replies in the same Slack thread. A few examples:

• "How many devices are online right now?"
• "Which devices haven't checked in this week?"
• "What's currently scheduled on the lobby kiosk?"
• "Add a new playlist called 'Holiday Specials'."
• "Update the espresso price to $4.50 in the menu datatable."
• "Send a screenshot command to all devices in the New York group."

You can keep the conversation going in the same thread — the bot remembers what you've been talking about.

What the assistant can't do (by design)

For safety, the Slack assistant cannot delete records or run wide-blast-radius commands. Specifically blocked:

• Deleting datatables, datatable rows, devices, device groups, media, media groups, playlists, or schedules
• Batch-deleting datatable rows
• Sending bulk device commands (commands that target every device at once)

If you need any of the above, use the Revel Digital dashboard directly. Everything else — creating, updating, querying, and sending individual device commands — works through the assistant.

Getting an AI API key

You only need one. Pick whichever your team already uses, or sign up for either:

The Slack integration itself is free. Your AI provider charges for the messages you send through their API; for typical Slack usage, this works out to a few dollars per user per month.

Detailed install walkthrough

If the quickstart didn't quite work, or you want to know what's happening at each step:

1. Install the app to Slack

Click the Add to Slack button at the top of this page. Slack will:

• Ask you to choose a workspace (if you have access to multiple)
• Show the permissions the bot needs: read messages it's @mentioned in, post replies, run the /reveldigital slash command
• Ask you to approve

After approval, Slack confirms the install and bounces you back. The bot now exists in your workspace but isn't yet linked to your AI account or your Revel Digital account.

2. Link your AI provider and Revel Digital account

In any channel or DM in Slack, run:

/reveldigital link

The bot replies privately (only you can see it) with a one-time link to a setup page. Open it. You'll see two sections:

AI provider — choose Anthropic or OpenAI from the dropdown, paste your API key, click Save key. The key is encrypted before it's stored and is used only to relay your requests to the AI provider.

Revel Digital account — click Connect Revel Digital. You'll be sent to sign in with your Revel Digital credentials, then redirected back automatically.

Both steps are required. To verify everything connected, run:

/reveldigital status

You should see green check marks next to both AI provider and Revel Digital.

3. Add the bot to a channel

The bot only responds in channels where it's been added. To invite it:

• In any channel, type /invite @Revel Digital Assistant and press Enter, or
• Click the channel name at the top of Slack → Integrations tab → Add apps → choose Revel Digital Assistant

You only need to do this once per channel.

4. Mention it

@Revel Digital Assistant what device groups exist?

The bot replies in a thread. Continue the conversation by mentioning the bot in replies to that thread — it remembers context within each thread.

To start a fresh conversation, mention the bot in a new thread (i.e., in the main channel without replying to an existing thread).

Slash command reference

Privacy and security

• Credentials are encrypted at rest. Your Slack workspace token, your AI provider API key, and your Revel Digital access token are all encrypted using AES-GCM before being stored.
• You bring your own AI account. Inference cost goes to your Anthropic or OpenAI account, not ours. We never see or have access to your AI account.
• The bot only sees @mentions. Slack only delivers it the messages where it's been explicitly mentioned — it can't read your other channel content.
• Conversation history is per-thread and bounded. Recent messages within a thread are kept so the bot can answer follow-ups; older messages slide off automatically. You can wipe a thread's history any time with /reveldigital reset, or wipe all credentials with /reveldigital unlink.
• Tokens rotate automatically. Slack and Revel Digital both issue refresh tokens; the integration rotates them in the background so you don't have to re-link.

For full details, see our privacy policy.

Tips for getting good answers

• Be specific. "How many devices?" → "How many devices in the East Coast group are currently online?"
• Use threads for related questions. The bot remembers context within a thread, so you don't have to repeat yourself when asking follow-ups.
• Start a new thread when switching topics. Mixing unrelated subjects in one thread can confuse the bot.
• For destructive actions, the bot will usually summarize first. Asking it to delete a playlist or wipe a datatable will typically generate a summary so you can confirm or cancel before anything happens.

Troubleshooting

"You haven't linked your accounts yet"
Run /reveldigital link and complete both steps on the setup page.

The bot doesn't respond when I @mention it
Make sure it's been added to the channel: /invite @Revel Digital Assistant. The bot only sees mentions in channels it's a member of.

anthropic 401: invalid x-api-key or openai 401: Incorrect API key provided
Your AI API key is invalid, expired, or revoked. Run /reveldigital unlink, then /reveldigital link and paste a fresh key.

"Revel Digital not linked" after I just linked it
The Revel access token may have failed to save. Run /reveldigital link and click Connect Revel Digital again. If it keeps failing, contact support.

The bot's reply ends mid-sentence
Long answers that involve many database lookups occasionally need to pause and resume — you'll see the partial reply followed by "…continuing…" and then the rest. If a single answer is genuinely too long to finish, try breaking your request into smaller asks.

"unauthorized app" reply to slash commands
Your workspace may have a stale install. Re-install via the Add to Slack button at the top of this page.

Need help?

If something isn't working, please contact our support team at support@reveldigital.com with:

• Your Slack workspace name
• The exact command or message that didn't work
• Approximate time of the issue (so we can find it in our logs)