lex-slack

Comprehensive Slack integration for LegionIO. Covers the Slack Web API (messaging, conversations, users, reactions, files, pins, bookmarks, reminders, usergroups, views, search), incoming webhooks, Block Kit builder, and a configurable message polling actor.

Installation

gem install lex-slack

Or add to your Gemfile:

gem 'lex-slack'

Standalone Client

Use Legion::Extensions::Slack::Client outside the full LegionIO framework. The client stores credentials and injects them into every API call automatically.

require 'legion/extensions/slack'

client = Legion::Extensions::Slack::Client.new(token: 'xoxb-...')

# Messaging
client.post_message(channel: '#general', text: 'Hello from Legion!')
client.post_message(channel: '#alerts', text: 'fallback', blocks: [
  client.header(text: 'Incident Alert'),
  client.section(text: client.mrkdwn('*web-prod-03* is unreachable')),
  client.divider,
  client.actions(elements: [
    client.button(text: 'Acknowledge', action_id: 'ack', style: 'primary'),
    client.button(text: 'Escalate', action_id: 'esc', style: 'danger')
  ])
])

# Conversations
channels = client.list_conversations
history = client.conversation_history(channel: 'C123ABC')

# Users
users = client.list_users
user = client.lookup_by_email(email: 'jane.doe@example.com')

# Reactions
client.add_reaction(channel: 'C123', timestamp: '1234.5678', name: 'thumbsup')

# Files (two-step upload)
client.upload_file(filename: 'report.csv', content: csv_data, channel: '#reports')

# Webhooks (no token needed)
webhook_client = Legion::Extensions::Slack::Client.new(webhook: '/services/T.../B.../...')
webhook_client.send_webhook(message: 'Quick alert!')

Runners

Chat

Method	Key Parameters	Description
`post_message`	`channel:, text:, blocks:, thread_ts:`	Post a message (supports Block Kit)
`send_webhook`	`message:, webhook:`	Post via incoming webhook
`update_message`	`channel:, ts:, text:, blocks:`	Update an existing message
`delete_message`	`channel:, ts:`	Delete a message
`schedule_message`	`channel:, text:, post_at:`	Schedule a future message
`delete_scheduled`	`channel:, scheduled_message_id:`	Cancel a scheduled message

Conversations

Method	Key Parameters	Description
`list_conversations`	`types:, cursor:, limit:`	List channels
`conversation_info`	`channel:`	Get channel details
`conversation_history`	`channel:, oldest:, latest:`	Fetch message history
`conversation_replies`	`channel:, ts:`	Fetch thread replies
`conversation_members`	`channel:`	List channel members
`join_conversation`	`channel:`	Join a channel
`leave_conversation`	`channel:`	Leave a channel
`invite_to_conversation`	`channel:, users:`	Invite users to a channel
`open_conversation`	`users:`	Open or resume a DM
`create_conversation`	`name:, is_private:`	Create a channel
`archive_conversation`	`channel:`	Archive a channel
`set_conversation_topic`	`channel:, topic:`	Set the channel topic

Users

Method	Key Parameters	Description
`list_users`	`cursor:, limit:`	List workspace users
`user_info`	`user:`	Get user details
`lookup_by_email`	`email:`	Find user by email
`get_presence`	`user:`	Get presence status
`set_presence`	`presence:`	Set bot presence (`auto`/`away`)

Reactions

Method	Key Parameters	Description
`add_reaction`	`channel:, timestamp:, name:`	Add a reaction
`remove_reaction`	`channel:, timestamp:, name:`	Remove a reaction
`get_reactions`	`channel:, timestamp:`	Get reactions on a message
`list_reactions`	`user:, cursor:`	List reactions by a user

Files

Method	Key Parameters	Description
`upload_file`	`filename:, content:, channel:`	Upload via two-step external flow
`list_files`	`channel:, user:, types:`	List files
`file_info`	`file:`	Get file details
`delete_file`	`file:`	Delete a file
`share_file`	`file:`	Create a public URL for a file

Pins

Method	Key Parameters	Description
`add_pin`	`channel:, timestamp:`	Pin a message
`remove_pin`	`channel:, timestamp:`	Unpin a message
`list_pins`	`channel:`	List pinned items

Bookmarks

Method	Key Parameters	Description
`add_bookmark`	`channel:, title:, type:, link:`	Add a bookmark
`edit_bookmark`	`channel:, bookmark_id:`	Edit a bookmark
`remove_bookmark`	`channel:, bookmark_id:`	Remove a bookmark
`list_bookmarks`	`channel:`	List bookmarks

Reminders

Method	Key Parameters	Description
`add_reminder`	`text:, time:, user:`	Create a reminder
`complete_reminder`	`reminder:`	Mark complete
`delete_reminder`	`reminder:`	Delete a reminder
`reminder_info`	`reminder:`	Get reminder details
`list_reminders`		List all reminders

Usergroups

Method	Key Parameters	Description
`list_usergroups`	`include_users:, include_disabled:`	List usergroups
`create_usergroup`	`name:, handle:`	Create a usergroup
`update_usergroup`	`usergroup:, name:`	Update a usergroup
`disable_usergroup`	`usergroup:`	Disable a usergroup
`enable_usergroup`	`usergroup:`	Re-enable a usergroup
`list_usergroup_users`	`usergroup:`	List members
`update_usergroup_users`	`usergroup:, users:`	Set members

Views

Method	Key Parameters	Description
`open_view`	`trigger_id:, view:`	Open a modal
`push_view`	`trigger_id:, view:`	Push a view onto the stack
`update_view`	`view_id:, view:`	Update an existing view
`publish_view`	`user_id:, view:`	Publish an App Home tab

Search

Method	Key Parameters	Description
`search_messages`	`query:, sort:, count:`	Search messages (requires user token)
`search_files`	`query:, sort:, count:`	Search files (requires user token)

Blocks (Builder)

Pure Ruby helpers for constructing Block Kit payloads. No HTTP calls.

Method	Description
`mrkdwn(text)`	Markdown text object
`plain_text(text)`	Plain text object
`option(text:, value:)`	Select menu option
`section(text:, accessory:, fields:)`	Section block
`divider`	Divider block
`header(text:)`	Header block
`context(elements:)`	Context block
`actions(elements:)`	Actions block
`image(image_url:, alt_text:)`	Image block
`input(label:, element:)`	Input block
`file_block(external_id:)`	File block
`button(text:, action_id:)`	Button element
`overflow_menu(action_id:, options:)`	Overflow menu
`static_select(action_id:, placeholder:, options:)`	Static select
`multi_static_select(action_id:, placeholder:, options:)`	Multi-select
`datepicker(action_id:)`	Date picker

Message Poller Actor

A configurable polling actor that watches channels for new messages. Disabled by default.

Configure via Legion::Settings:

{
  "lex-slack": {
    "token": "xoxb-...",
    "poller": {
      "enabled": true,
      "interval": 30,
      "channels": ["C123ABC", "C456DEF"],
      "limit": 50
    }
  }
}

The poller uses an in-memory high-water mark per channel to avoid reprocessing messages. New messages are published to Legion transport if available.

Requirements

Ruby >= 3.4
faraday >= 2.0

License

MIT

lex-slack

Runtime

lex-slack

Installation

Standalone Client

Runners

Chat

Conversations

Users

Reactions

Files

Pins

Bookmarks

Reminders

Usergroups

Views

Search

Blocks (Builder)

Message Poller Actor

Requirements

License