The BoldDesk Slack integration may encounter errors when its authorization expires, required permissions are missing, a configured channel becomes unavailable, or Slack temporarily rejects a request.

This article explains how to troubleshoot authorization, permission, workspace, channel, message-content, and temporary service errors associated with the BoldDesk Slack integration. For installation and notification configuration instructions, learn more on How to Install and Configure the Slack Integration in BoldDesk for a Single Workspace.

Prerequisites

Before troubleshooting, ensure that:

• The Slack integration is installed in the correct workspace.
• The connected Slack workspace is active.
• The BoldDesk app is authorized in Slack.
• The required Slack permissions were approved.
• The BoldDesk app is added to the applicable Slack channel.
• The configured channel still exists and is active.
• The agent has access to the applicable BoldDesk ticket.
• The integration is active under Admin → Marketplace → My Apps.

Resolve Authorization Errors

Reauthorize Slack when BoldDesk displays errors such as:

• Invalid authentication token
• Authentication token required
• Authentication token expired
• Authentication token revoked
• User is not authorized through Slack
• Slack Bot session has expired
• Client ID and token do not match
• Invalid client secret
• Access to the workspace is not permitted
• Slack app setup is incomplete

These errors indicate that BoldDesk can no longer authenticate with the connected Slack workspace.

To reauthorize Slack:

1. Go to Admin → Marketplace → My Apps.
2. Open Slack.
3. Select Re-Authentication.
4. Sign in to the correct Slack workspace.
5. Review the requested permissions.
6. Approve the authorization request.
7. Return to BoldDesk.
8. Retry the failed operation.

If the authorization error continues:

• Confirm that the correct Slack workspace was selected.
• Confirm that the authorizing Slack account remains active.
• Check whether the BoldDesk app was removed from Slack.
• Confirm that an administrator has not revoked the app’s permissions.
• Reinstall the integration only when reauthorization cannot restore access.

Resolve Missing Scope or Permission Errors

The following errors indicate that the Slack app or token does not have permission to complete the operation:

• Scope missing for request
• Request not authorized
• Access denied
• No permission
• Not allowed
• Missing scope

Verify that:

1. The BoldDesk Slack app is installed in the correct workspace.
2. The requested Slack permissions were approved.
3. The app is permitted by the workspace or organization administrator.
4. The app has permission to access the target channel.
5. The app is authorized to post messages or perform the required operation.
6. The agent has permission to perform the corresponding action in BoldDesk.

After the required permissions are granted, reauthorize the integration and retry the operation.

Resolve Channel Errors

1. Channel Not Found or Invalid Channel
   This error can occur when the channel has been deleted, renamed, removed from the BoldDesk notification configuration, is no longer available in the connected workspace, or has an invalid channel identifier. To resolve the error:

   1. Sign in to the connected Slack workspace.
   2. Confirm that the channel exists.
   3. Confirm that the channel belongs to the connected workspace.
   4. Open the BoldDesk Slack notification configuration.
   5. Select an active channel.
   6. Save the configuration.
   7. Retry the notification.

2. BoldDesk App Is Not in the Channel
   The BoldDesk app must be added to a channel before the integration can access or post messages in that channel. To resolve the error:

   1. Open the target channel in Slack.
   2. Add the BoldDesk app to the channel.
   3. Confirm that the app appears among the channel integrations or members.
   4. Retry the operation in BoldDesk.

   For complete instructions, learn more on How to Install and Configure the Slack Integration in BoldDesk for a Single Workspace.

3. Channel Is Archived
   An archived Slack channel cannot accept new messages. Use one of the following options:

   • Unarchive the Slack channel.
   • Configure BoldDesk to use another active channel.

4. Channel Is Read-Only or Restricted
   The selected channel may restrict message posting or file uploads. Ask the Slack administrator to verify:

   • Channel posting permissions
   • Application posting permissions
   • File-upload restrictions
   • Workspace application policies
   • Slack Enterprise Grid restrictions

   If the restrictions cannot be changed, select another channel that permits the required operation.

5. Cannot Post a Thread Reply
   The channel, original message, or thread may not support the requested threaded reply. To resolve the error:

   1. Confirm that the original Slack message still exists.
   2. Confirm that the BoldDesk app can access the original message.
   3. Confirm that threaded replies are permitted in the target channel.
   4. Retry the reply.
   5. If threaded replies remain unavailable, post the message at the channel level or use another active channel.

Resolve Workspace Errors

1. Invalid Team or Team ID Required
   This error indicates that the configured Slack workspace is missing or invalid. Verify that:

   • The selected Slack workspace exists.
   • The BoldDesk app is installed in that workspace.
   • The integration is connected to the intended workspace.
   • The authorizing account can access the workspace.
   • The workspace was not removed from a Slack Enterprise Grid organization.

   Reauthorize the integration after confirming the workspace.

2. Workspace or Account Is Inactive
   Reactivate the Slack workspace or connected account before retrying the operation.
   If the connected account cannot be restored, reauthorize the integration using another permitted Slack account.

3. Enterprise Workspace Restriction
   A Slack Enterprise Grid administrator can restrict app installation, workspace access, and API operations.
   Ask the Slack organization administrator to verify that:

   • The BoldDesk app is approved.
   • The app is installed at the correct organization or workspace level.
   • The app can access the required workspace.
   • The required Slack API operations are permitted.
   • The target channels are accessible.

4. Enterprise Migration Is in Progress
   Workspace and channel resources may be temporarily unavailable while a Slack Enterprise Grid migration is in progress.
   Wait until the migration is complete, and then:

   1. Confirm that the workspace and channels remain available.
   2. Review the BoldDesk channel mappings.
   3. Reauthorize the integration when required.
   4. Retry the operation.

Resolve Message Content Errors

Use the following table to identify and correct message-content errors.

Resolve Temporary Slack Service Errors

Temporary service errors can include:

• Service temporarily unavailable
• Request timeout
• Internal error
• Fatal error
• Rate limit exceeded
• Service overloaded
• Gateway error

To resolve a temporary service error:

1. Wait briefly.
2. Retry the operation once.
3. Check the current Slack service status.
4. Confirm that the BoldDesk Agent Portal is available.
5. Reduce the request frequency when the error is caused by rate limiting.
6. Avoid repeatedly retrying the same bulk operation.

Rate Limit Exceeded

Slack can temporarily reject requests when too many operations are submitted within a short period.

When rate limiting occurs:

• Pause the affected operation.
• Wait before retrying.
• Reduce the frequency of bulk updates or notifications.
• Avoid repeatedly posting the same notification.
• Process large operations in smaller batches when possible.

If service errors continue after Slack service availability is restored, collect the failure information and contact BoldDesk Support.

Resolve Deprecated or Unsupported Slack Operations

The following errors can indicate that the integration request uses an unsupported Slack API operation:

• Endpoint deprecated
• Method deprecated
• Unsupported method
• Invalid argument name
• Unsupported argument
• Operation not available

To resolve the error:

1. Confirm that the latest BoldDesk Slack integration is installed.
2. Reauthorize the integration.
3. Retry the operation.
4. Record the complete error and failure time if the issue continues.
5. Contact BoldDesk Support.

Do not manually modify the request unless the workflow uses a custom implementation outside the standard BoldDesk Slack integration.

Review Integration Failure Logs

If the issue continues:

1. Go to Admin → Audit Logs.
2. Open Integration Failure Logs.
3. Filter the logs for the affected period.
4. Locate the Slack failure.
5. Review:
   • Integration
   • Operation
   • Error message
   • Related ticket
   • Failure time
6. Compare the error with the troubleshooting sections in this article.
7. Correct the configuration and retry the operation.

Use the following details to identify the cause:

Collect Information for BoldDesk Support

If the issue cannot be resolved, collect the following information:

Frequently Asked Questions

1. Why Did the Slack Integration Stop Working?
   The integration can stop working when:

   • Its authorization expires or is revoked.
   • The connected account becomes inactive.
   • The app loses a required permission.
   • The configured channel is deleted or archived.
   • The app is removed from the channel.
   • Workspace application policies change.
   • Slack temporarily rejects the request.
     Review the complete error and Integration Failure Logs before changing the integration configuration.

2. Must I Reinstall the Integration After an Authorization Error?
   Not normally. Reauthorize the integration first.
   Reinstall the integration only when reauthorization cannot restore access or the app was completely removed from the workspace.

3. Why Can BoldDesk Post to One Channel but Not Another?
   The BoldDesk app may not have been added to the affected channel, or the channel may have different posting restrictions.
   Confirm that the app is present in the channel and permitted to post messages.

4. Can BoldDesk Post to an Archived Slack Channel?
   No. Unarchive the channel or configure BoldDesk to use another active channel.

5. Why Does Slack Report a Missing Scope?
   The app token does not include a permission required by the attempted action.
   Ask the Slack administrator to approve the required permission, and then reauthorize the integration.

6. What Should I Do After Renaming a Slack Channel?
   Review the BoldDesk notification configuration and confirm that the required channel remains selected. Update the channel mapping when necessary.

7. What Should I Do When Slack Reports a Rate Limit?
   Wait before retrying, reduce the request frequency, and divide large operations into smaller batches.

8. Do Contacts Receive Slack Notifications?
   No. The BoldDesk Slack integration sends internal notifications to supported channels and agents. Contacts receive ticket updates through email or the Customer Portal.

Related Articles

1. How to Install and Configure the Slack Integration in BoldDesk for a Single Workspace
2. Slack Integration Articles in BoldDesk
3. Common Integration Errors and Resolution in BoldDesk