Slack
Messages and threads from the Slack channels you choose. Claro Historia only reads. It never posts.
What Claro Historia reads
- Messages and threads in the channels you link
- Channel names and member display names
Access is read-only. Claro Historia does not create, change or delete anything in Slack.
Permissions requested
- View messages in public channels (
channels:history) and basic information about them (channels:read). - Join public channels (
channels:join), so it can read the ones you link. - View messages in private channels the app has been added to (
groups:history,groups:read). - View people in the workspace (
users:read), to show who said what.
Before you start
- Slack may require a workspace owner or admin to approve installing the app. If you do not manage your Slack workspace, ask the person who does.
- Claro Historia reads nothing until you link a channel to a project.
- Direct messages are never synced into projects. Each person can optionally let the AI use their own recent DMs, see Personal accounts.
Add Claro Historia to Slack (workspace admin)
- Open Workspace Settings → Sources.
- Under Communication, find Slack and click Add to Slack.
- On Slack’s page, check that the right Slack workspace is selected (use the menu at the top right to switch), review the permissions and click Allow.
- You return to Claro Historia and the card shows Connected.

Link Slack channels to a project
- In Slack, open the channel and its details. The Channel ID (it starts with C or G) is at the bottom of the About panel.
- Private channels: first add the Claro Historia app to the channel (for example, type
/invite @Claro Historia, using the app name shown in your workspace). Without that, the channel cannot be read. - Open the project, go to Project Settings → Slack, enter the Channel ID and a display name, and add it.
- The same channel can be linked to more than one project. Messages sync with the next run, or click Sync in Project Settings → Sync.

Good to know
- How far back messages go depends on your Slack plan’s message history.
Anything synced into a project can be seen by every member of your workspace, because every member can open every project. That includes people who cannot open the original file or message in the source tool. Only link sources you are comfortable sharing with your whole workspace.
Disconnect
- For a project: click Remove next to a channel in Project Settings → Slack.
- For the workspace: in Workspace Settings → Sources, click Disconnect on the Slack card. You can also remove the app in Slack under Apps.
Disconnecting stops syncing and removes Claro Historia’s access immediately. To have content that was already synced removed as well, email support@clarohistoria.com. See Data and security for how long data is kept.
Problems?
See Troubleshooting or email support@clarohistoria.com.