Troubleshooting issues in POSTing Slack messages
It some cases it is possible that you are not able to see the preview of the release notes in Slack's block kit builder or you face some errors after a release notes execution in ARN which causes no release note updates on Slack. Please check below information for possible reasons for the failure of release notes publishing in Slack.
Possible errors and related details
Error message | Reason | Solution/Troubleshooting steps |
|---|---|---|
Webhook not found. Click here for troubleshooting steps. | User who created webhook has been deleted/disabled. | If the Slack user who created the Slack app and the webhook in Slack is deleted/disabled the release notes will not get published. In this case please check your Slack users and make sure the active user has done the required setup mentioned in https://amoeboids.atlassian.net/wiki/spaces/ARN/pages/304807972/Actions#Slack. |
Webhook not found. Click here for troubleshooting steps. | Slack webhook deleted/disabled | In this case, user could be active but the webhook is deleted or disabled. In this case also, you will see the same error message and you need to create new webhook as explained in https://amoeboids.atlassian.net/wiki/spaces/ARN/pages/304807972/Actions#Slack. |
Unable to post a message to Slack. Click here for troubleshooting steps. | Number of blocks is more than 50 | If you have added more that 50 blocks in the Slack template then this exceeds the limit of blocks in a Slack template. Please remove the extra blocks and add only 50 in one template. The 50 block limit included all the blocks like Header, Section, Context, Devider& JQL section (JQL section is a collection of blocks. In this case JQL all the blocks in JQL will be counted) |
Unable to post a message to Slack. Click here for troubleshooting steps. | Number of characters' limit exceeded in the one or more blocks in the Slack template | As you can use Different blocks to design the Slack template, there is character limit set for each of the block (except devider as it does not have any attribute). If the limit is exceeded in one of more blocks from the template, you will get an error message. Cross check all the blocks and make necessary changes and save the template. Please check below table that mentioned the character limit for all types of blocks. |
Character limits for different blocks
Below tables dectates the character limit for each of the blocks. As mentioned in the above table, JQL section is a collection/or group of blocks which includes Title, Description and Message and these are treated as blocks.
Block name | Character limit |
|---|---|
Header | 150 |
Section | 3000 |
Context | No limit |
Divider | NA |
JQL section title | 150 |
Description (Within JQL section) | 3000 |
Message (Within JQL section’s Section tab and Layout tab) | 3000 |
Error messages in preview in block kit
While you are testing the Slack template preview in Slack block kit builder, you may receive errors related to character limits same as mentioned in above table. If you receive these errors please check and correct the template with respect to the character limits.