1. Home
  2. 6: Nodes Reference Guide
  3. 6.1.2 Product Connector Nodes

Slack Connector Configuration Guide

The Slack Connector in Rayven.io integrates Slack messaging into your workflows, enabling real-time notifications, automated message posting, and message retrieval.

What It Does

  • Sends automated messages to Slack channels or DMs.

  • Retrieves messages, threads, and channel history.

  • Monitors channels for new posts and triggers workflows.

  • Supports both public and private channels.


How to Use

Rayven Workflow Implementation

  1. Create a Slack App

    • Go to Slack API Apps and create a new app.

    • Add scopes based on your use case (e.g., chat:write, conversations:read, groups:history).

    • Install the app to your workspace and copy the OAuth token.

  2. Add Slack Credentials in Rayven

    • Go to Settings → Credentials in Rayven.io.

    • Add your Slack OAuth token and save.

  3. Add a Slack Node to Your Workflow

    • From Input Nodes (retrieving data) or Output Nodes (sending data), select a Slack operation.

  4. Configure the Node

    • Provide required parameters such as Channel ID, Message Text, or Timestamp.

  5. Test & Activate

    • Test the connection to ensure it works as expected, then activate your workflow.


Preconfigured Slack Endpoints

Endpoint Name Description Type API Documentation
Send a Message Post a message to a channel. Output chat.postMessage
Retrieve Message Thread Get all messages in a thread. Input conversations.replies
Monitor Private Channel Messages Detect new posts in a private channel. Input groups.history
Monitor Public Channel Messages Detect new posts in a public channel. Input conversations.history
 

Note: You will need valid Slack OAuth tokens with the correct scopes for these endpoints.


Adding Custom Endpoints

If your needed operation is missing:

  1. Use the HTTP Request Node

    • Select Slack as the credential type.

    • Provide:

      • API endpoint URL (see Slack Web API Docs)

      • HTTP method (GET, POST, etc.)

      • Headers and payload as required.

  2. Request a New Endpoint from Rayven Support

    • Share the Slack API method name and required parameters.

    • Most requests are added within 72 hours.


Authentication

Method Notes
OAuth2 (Bot Token) Recommended; provides secure, scoped access.
User Token For actions requiring a user’s permissions.
 

See Slack Authentication Guide for details.


 Best Practices

  • Use scoped OAuth tokens to limit access.

  • Store credentials securely in Rayven’s Credential Manager.

  • Test with a dedicated Slack test channel before production.

  • Avoid excessive API calls to prevent rate limiting (Rate Limits Docs).


Use Cases

  • Send workflow alerts to operations channels.

  • Retrieve message threads for audit and tracking.

  • Monitor private or public channels for trigger events.

  • Integrate incident management workflows with Slack notifications.


FAQ (Chatbot Q&A Layer)

Q: What Slack actions can I automate with this connector?
A: Sending messages, retrieving threads, and monitoring channels for new posts.

Q: Can I use Slack APIs not listed here?
A: Yes. Use the HTTP Request Node with the desired Slack API method.

Q: What authentication is supported?
A: OAuth2 with bot tokens is recommended; user tokens can be used if necessary.

Q: Do I need different scopes for different operations?
A: Yes. For example, chat:write for sending messages, conversations:read for reading channel history.

Q: Can I send messages to private channels?
A: Yes, if your app has been invited to the channel and has the correct scopes.