Slack App Creation
Go to the Slack API Apps page. Click "Create New App" → "From scratch". Enter your app name (e.g., Logsign-Bot) and select your desired Workspace. Once the app is created, navigate to the "OAuth & Permissions" section.
Configure OAuth Scopes
Under the Bot Token Scopes section, add the following permissions:
- chat:write → Send messages as LogsignResponse
- files:write → Upload, edit, and delete files as LogsignResponse
- channels:read → View basic information about public channels in a workspace
- groups:read → View basic information about private channels that LogsignResponse has been added to
- im:read → View basic information about direct messages that LogsignResponse has been added to
- mpim:read → View basic information about group direct messages that LogsignResponse has been added to
Install to Workspace
Scroll down to the bottom of the "OAuth & Permissions" page. Click "Install to Workspace" or "Reinstall to Workspace". Grant permissions by clicking "Allow". Copy the generated bot token (starts with xoxb-) and keep it safe.
Invite the Bot to Channels
- Your bot must be a member of the channels where it will send messages or upload files.
- Go to the target Slack channel (e.g., #alerts). In the message input, type: /invite @LogsignResponse
- Press Enter to add the bot to the channel.
NOT: If the bot is not invited to the channel, sending messages or uploading files will fail, and the integration will not work.
Get the Channel ID
Logsign needs the numeric Channel ID, not the channel's display name. In Slack, open the channel, click the channel name at the top to open its details panel, and scroll to the bottom: the Channel ID is shown there (it starts with C, for example C0123ABCDEF). This is the channel messages and files will be sent to; the integration is scoped to a single channel per device.
Configure the Integration in Logsign USO
In Logsign USO, go to Settings > Responses, search for Slack, click Configure then +Device, and fill in:
| Field | Description |
|---|---|
| Device Name | Free-text label identifying this Slack device in Logsign. |
| Api Key | The bot token copied above (starts with xoxb-). |
| Channel Id | The Channel ID from the previous step. Messages and files sent through this device always go to this one channel; add a second device if you need to post to a different channel. |
Click Create to save the device.
Available Methods
- send_message — sends a text message to the configured channel. Argument: text (required).
- send_file — uploads a file to the configured channel. Argument: file_path (required).
Both methods post only to the Channel ID configured on the device; there is no per-call channel override.