@radzor/slack-bot

Slack bot for sending messages, Block Kit layouts, file uploads, and slash command responses via the Slack Web API. Supports both Bot tokens and incoming webhooks.

Messagingv0.1.0typescriptpythonServerslackbotmessagingchatnotificationsblock-kitwebhookby Radzor

Install

View source on GitHub →

$npx radzor@latest add slack-bot

⚠ Constraints: Requires botToken for API methods (sendMessage, sendBlocks, uploadFile). webhookUrl can replace botToken for simple notifications only. Always verify incoming requests with verifyRequest() using signingSecret.

Inputs

Name	Type	Default	Description
botToken	string	—	Slack Bot OAuth token (xoxb-...). Required for API methods.SLACK_BOT_TOKEN
webhookUrl	string	—	Slack Incoming Webhook URL for simple message delivery.
signingSecret	string	—	Slack app signing secret for verifying incoming event payloads.SLACK_BOT_SIGNING_SECRET

botTokenstring

Slack Bot OAuth token (xoxb-...). Required for API methods.

SLACK_BOT_TOKEN

webhookUrlstring

{ "llm": { "constraints": "Requires botToken for API methods (sendMessage, sendBlocks, uploadFile). webhookUrl can replace botToken for simple notifications only. Always verify incoming requests with verifyRequest() using signingSecret.", "usageExamples": "llm/examples.md", "integrationPrompt": "llm/integration.md" }, "name": "@radzor/slack-bot", "tags": [ "slack", "bot", "messaging", "chat", "notifications", "block-kit", "webhook" ], "events": [ { "name": "onMessageSent", "payload": { "ts": "string", "channel": "string" }, "description": "Fired when a message is successfully sent." }, { "name": "onError", "payload": { "code": "string", "message": "string", "slackError": "string" }, "description": "Fired on Slack API error." } ], "inputs": [ { "name": "botToken", "type": "string", "envVar": "SLACK_BOT_TOKEN", "required": false, "description": "Slack Bot OAuth token (xoxb-...). Required for API methods." }, { "name": "webhookUrl", "type": "string", "required": false, "description": "Slack Incoming Webhook URL for simple message delivery." }, { "name": "signingSecret", "type": "string", "envVar": "SLACK_BOT_SIGNING_SECRET", "required": false, "description": "Slack app signing secret for verifying incoming event payloads." } ], "radzor": "1.0.0", "actions": [ { "name": "sendMessage", "params": [ { "name": "channel", "type": "string", "description": "Channel ID (C...) or @username." }, { "name": "text", "type": "string", "description": "Message text (supports mrkdwn formatting)." }, { "name": "options", "type": "{ threadTs?: string; unfurlLinks?: boolean }", "required": false, "description": "Optional thread_ts for replies, and link unfurl settings." } ], "returns": "Promise<{ ts: string; channel: string }>", "description": "Send a text message to a channel or user." }, { "name": "sendBlocks", "params": [ { "name": "channel", "type": "string", "description": "Channel ID or @username." }, { "name": "blocks", "type": "object[]", "description": "Slack Block Kit block array." }, { "name": "text", "type": "string", "required": false, "description": "Fallback text for notifications." } ], "returns": "Promise<{ ts: string; channel: string }>", "description": "Send a rich Block Kit message." }, { "name": "reply", "params": [ { "name": "channel", "type": "string", "description": "Channel ID of the original message." }, { "name": "threadTs", "type": "string", "description": "Timestamp of the parent message to reply to." }, { "name": "text", "type": "string", "description": "Reply text." } ], "returns": "Promise<{ ts: string; channel: string }>", "description": "Reply in a thread." }, { "name": "uploadFile", "params": [ { "name": "channel", "type": "string", "description": "Channel to share the file in." }, { "name": "content", "type": "Buffer | string", "description": "File content." }, { "name": "filename", "type": "string", "description": "File name with extension." }, { "name": "title", "type": "string", "required": false, "description": "File title displayed in Slack." } ], "returns": "Promise<{ fileId: string; permalink: string }>", "description": "Upload a file and share it in a channel." }, { "name": "verifyRequest", "params": [ { "name": "body", "type": "string", "description": "Raw request body from Slack." }, { "name": "timestamp", "type": "string", "description": "X-Slack-Request-Timestamp header." }, { "name": "signature", "type": "string", "description": "X-Slack-Signature header." } ], "returns": "boolean", "description": "Verify the HMAC signature of an incoming Slack event or slash command." } ], "outputs": [ { "name": "messageResult", "type": "{ ts: string; channel: string; ok: boolean }", "description": "Sent message timestamp and channel ID." } ], "runtime": "server", "version": "0.1.0", "category": "messaging", "languages": [ "typescript", "python" ], "description": "Slack bot for sending messages, Block Kit layouts, file uploads, and slash command responses via the Slack Web API. Supports both Bot tokens and incoming webhooks.", "dependencies": { "packages": {} }, "composability": { "connectsTo": [ { "event": "onError", "description": "Track Slack bot errors", "compatibleWith": [ "@radzor/error-tracker.action.captureMessage.message", "@radzor/log-aggregator.action.error.message" ] }, { "output": "messageResult", "mapField": "channel", "compatibleWith": [ "@radzor/event-tracker.action.track.eventName", "@radzor/log-aggregator.action.info.message" ] } ] } }

@radzor/slack-bot

Install

Inputs

Outputs

Actions

Events

Composability

radzor.manifest.json

Version History