Get Slack Integration by Unit

Endpoint used to get a Slack integration by unit.

Request Example

curl --request GET \
  --url https://converflow.api.prod.toolzz.media/api/v1/slack/integration/unit/{unitId} \
  --header 'Authorization: Bearer TOKEN_HERE'

Response Example

{
  "data": [
    {
      "id": "uuid",
      "botId": "uuid",
      "botToken": "string",
      "signingSecret": "string",
      "teamId": "string",
      "channelIds": [
        "string"
      ],
      "channelsDetail": [],
      "title": "string",
      "scope": "string",
      "isActive": true,
      "replyInDms": true,
      "replyOnMention": true,
      "threadAutoReply": true,
      "welcomeMessage": "string",
      "isTokenMasked": true,
      "unitId": "uuid",
      "createdAt": "timestamp",
      "updatedAt": "timestamp",
      "deletedAt": null,
      "defaultChannelId": null
    }
  ]
}

---

Request description

Access Token

Parameter	Type	Description	Required
Authorization	String	Access token (“Bearer” must be before the token)	Yes

URL Parameters

Parameter	Type	Description	Required
unitId	String	Unit ID	Yes

Response description

Key	Type	Description
data[]	Array	List of objects containing the integration settings.
botId	String	Unique identifier of the integrated agent.
botToken	String	OAuth access token (Bot User OAuth Token) for the Slack API.
channelIds	Array[Str]	List of IDs of the channels where the bot is authorized to act.
channelsDetail	Array	Additional details about the linked channels (metadata).
createdAt	String	Integration creation date and time (ISO/Custom format).
defaultChannelId	Null/Str	Default channel ID for automatic notifications.
deletedAt	Null/Str	Logical deletion date (soft delete), if applicable.
id	UUID	Unique integration identifier in the internal database.
isActive	Boolean	Defines if the integration is active and processing events.
isTokenMasked	Boolean	Indicates if the botToken and signingSecret are masked in the response.
replyInDms	Boolean	If true, the bot is authorized to respond in Direct Messages.
replyOnMention	Boolean	If true, the bot responds only when mentioned (@bot).
scope	String	Bot’s scope of action (e.g., all, specific_channels).
signingSecret	String	Secret key used to validate requests coming from Slack.
teamId	String	Unique Workspace (Team) ID on Slack.
threadAutoReply	Boolean	If true, the bot responds automatically within threads.
title	String	Friendly name given to the integration (e.g., “Slack Integration”).
unitId	UUID	Toolzz AI unit identifier.
updatedAt	String	Date and time of the last parameter update.
welcomeMessage	String	Automatic message sent when a user interacts for the first time.

---

Security

To access this endpoint, it is necessary to send a valid access token through the authorization header (Authorization) of the request. Additionally, the API is protected by other security measures to safeguard user data.

To access your access token, follow these steps:

1. Log in to the ToolzzAI platform
2. Click on “Settings”
3. Click on “Access Token”
4. Copy the access token