​

💬 Slack (team feature)

​

What you need

• Slack Bot Token (starts with xoxb-)
• Permission to create or manage Slack apps in your workspace
• Access to Integrations → Slack in the left nav

​

Create a Slack bot token

1. Visit api.slack.com/apps and click Create New App → From scratch.
2. Name the app (e.g., “Nota Bot”) and pick the workspace.
3. In OAuth & Permissions, under Bot Token Scopes, add at least:
   • chat:write (post messages as the bot)
   • chat:write.public if you need to post in channels the bot isn’t invited to yet
   • files:write if you plan to upload attachments
4. Click Install to Workspace and approve the permissions.
5. Copy the Bot User OAuth Token (starts with xoxb-). Store it securely.

​

Add the token in Nota

1. Open Integrations in the left nav and select the Slack card.
2. Paste the Bot User OAuth Token (xoxb-...) into the token field.
3. Save. Nota will use this token immediately—no environment variable or redeploy needed.

✅ Keep the bot in only the channels it needs. If permissions change, reinstall to refresh the token.

​

Getting started with incoming webhooks

​

Create a webhook URL

1. Visit api.slack.com/apps and click Create New App → From scratch.
2. Name the app (e.g., “Nota Webhook”) and pick the workspace.
3. Open Incoming Webhooks and toggle Activate Incoming Webhooks on.
4. Click Add New Webhook to Workspace, choose a channel, and approve.
5. Copy the Webhook URL (starts with https://hooks.slack.com/services/).

​

Add the webhook in Nota

1. Open Integrations in the left nav and select the Slack card.
2. Paste the Webhook URL into the incoming webhook field.
3. Save. Nota will start posting to the selected channel.

✅ Webhooks are channel-specific. Create a new webhook URL for the channel you want to target.