Docs / Chat
Slack
Install the Pangea Slack app, link channels, and keep agent work going in a Slack thread.
Install the Pangea Slack app to work with your team's agents from Slack. You mention the bot with a task, and the agent replies in a thread that stays tied to the same session.
Install the app
- As a team Administrator, open Connectors, find Slack and click Add, then click Install Slack App.
- Slack opens in your browser. Pick the workspace and approve the app.
- You return to the Mac app by yourself. The Pangea bot then sends you a DM in Slack to choose which channels to use.
You do not need to copy any workspace or channel IDs.
What the app can do in Slack
The app asks for these bot scopes:
| Scope | Why |
|---|---|
app_mentions:read |
See when someone mentions the bot |
assistant:write |
Show the agent's progress as a Slack agent |
channels:history, groups:history, im:history |
Read messages in linked channels, private channels and DMs |
channels:read, groups:read |
List channels so you can link them |
chat:write |
Reply in threads |
commands |
Run the /pangea command |
files:read, files:write |
Read files you post and attach files the agent produces |
im:write |
Send you DMs, such as the channel picker |
reactions:write |
React to your message while it works and when it is done |
users:read, users:read.email |
Match Slack members to Pangea members by email |
Link channels
Use the channel picker in your DM with the bot. You can also open the Slack connection in Pangea and click Link a new channel:
- Invite the bot to the channel with
/invite @Pangea. - Mention the bot in the channel.
- Click Link this channel in its reply.
Member identity
Each message needs a Pangea member behind it, with access to the team and the connectors in use. Pangea matches Slack members to Pangea members by email. Administrators can also map accounts by hand under Slack accounts. An unlinked channel or an unknown member never gets access to the team's accounts.
Work in a thread
Mention the bot with a clear, bounded task. Replies in that Slack thread continue the same session. The transcript is also available in Pangea, subject to session access. It is not visible to everyone on the team by default. Keep sensitive connector data out of broad channels.
To continue a recent Pangea conversation from Slack, run /pangea pickup.
Use Slack for investigation, code and incident follow-up. Significant cloud changes can show a plan review card in Slack. Other action prompts follow Auto Mode and Full Access. Check the mode before you ask for production changes.
Watches and delivery
An agent can wire a provider alert to a Pangea trigger and a Slack incident thread. Choose the exact channel or DM, then check the provider's webhook, event scope and a test delivery. A trigger in Pangea does not prove that the provider will deliver incidents. See Triggers.
Reinstall or remove
Use Reinstall Slack App on the Slack connection when it needs new scopes. Existing channel and account links are kept. To disconnect, review your mappings, disconnect the workspace in Pangea, and remove the app from your Slack workspace.