Rocket.Chat is the best Slack altenative.
If company also has issue management like JIRA and source code repository management system like BitBucket, you can also sending message to Rocket.Chat automatically to easy notify update information about your work progress.
You can see the integration guide from Rocket.Chat documentation.
Rocket.Chat Documentation
How to send JIRA notification to Rocket.Chat
1. Create new Bot user
In Rocket.Chat go to "Administration" -> "Users" and create new bot user(Select user role to Bots). We will use this user as a sender of JIRA notification. Just make a user like 'jira' and activite it.
2. Create new integration
- In Rocket.Chat go to "Administration" -> "Integrations" and create "New Integration".
- Click "Incoming WebHook"
- Select each option like bellow
- Enabled : True
- Name (Optional) : JIRA Notification
- Post to Channel : /Input channel which WekHook will be posted/
- Post as : /Input username you already created by step 1/
- Script Enabled : True
- Input Script like this gist
/*jshint esnext:true*/
const DESC_MAX_LENGTH = 140;
const JIRA_LOGO = 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAACRElEQVRYhbWXsUscQRTGf4iIyHHIISIWIsHisMgfkNIiBJFwiKQIkipVqpA/wEZEggSxEkmZwiKI5A84REKKkIMQrINYBQmHBDmEHJdNMW+42dk3d3O76wcDu2/e973vZvfN7EF+PAfaMjYL6AzFJFBRYh0gkdEBpryciuQVwjPgFugCu068CvQcAz1g2pnfEc6taOTGL6dIAjxw5nad+FsnvuhxrosYuPbElrz5Rc8Ucu9yfhcxsAncYZZ4fwTeO+HcUcILWgFqOXg1si9vFBrAXB7iEMySfYQZzGCeWxdoAq+Bh8BYjoJjwn0jWrYrqsOIbdIvUQLseTmPgHXgiYx1ibnYU3RuYpyfKMQ/mNWx+KzkfHHmZ4Tj55zGGNhQiAlw5OQ8VeYbzvxRQCNqUxoHLgMCa07eRyd+4sTXAtwrYCLGAJje1URugLrkVIHvMuyLVZccjfsitrhFMyD0k36bTtA/cOZkTuOckaOTFtA7IgEuSG9ONeBHILctWrnwGNO/mvA3zAk4LddaThfTpoXwKiBuVyL0yxPhloLtAUVCY7us4hb7IxQ/KLu4xWFE8cP7Kg6mld4PKH5BvoNrZBMfBphohKnFMAusyvU48ClgoA3M34eBUynwUu6ngK8BE1Gn3ihYccR79Jd5nuyXsx0rZRo498Q7mK8dMDudZuC8rOLLgQI7Ts5xIGe5DANbinCP9AfmEul/SnZslWHgTBFuKnna8a3lpRCzadSVWMiAj6GPIMbAX+/+H9BS8loyN4ibwX9j/jIXDkk+pgAAAABJRU5ErkJggg==';
function stripDesc(str) {
if (str)
return str.length > DESC_MAX_LENGTH ? str.slice(0, DESC_MAX_LENGTH - 3) + '...' : str;
else
return '';
}
function prepareAttachment({issue, user}, text) {
let issueType = issue.fields.issuetype;
let res = {
author_name: user.displayName
, author_icon: user.avatarUrls['24x24']
, thumb_url: issueType.iconUrl
};
if (text) {
text = text.replace(/\{\{(user|issue)\.([^a-z_0-9]+)\}\}/g, (m, type, key) => (type==='user' ? user : issue)[key]);
res.text = text;
}
return res;
}
class Script {
process_incoming_request({request}) {
const data = request.content;
try {
if (!data.issue || (data.user && data.user.name === 'gitlab')) {
return;
}
let issue = data.issue;
let baseJiraUrl = issue.self.replace(/\/rest\/.*$/, '');
let user = data.user;
let assignedTo = (issue.fields.assigned && issue.fields.assigned.name !== user.name) ? `, assigned to ${issue.fields.assigned.name}` : '';
let issueSummary = `[${issue.key}](${baseJiraUrl}/browse/${issue.key}) ${issue.fields.summary} _(${issue.fields.priority.name.replace(/^\s*\d*\.\s*/, '')}${assignedTo})_`;
let message = {
icon_url: (issue.fields.project && issue.fields.project.avatarUrls && issue.fields.project.avatarUrls['48x48']) || JIRA_LOGO
, attachments: []
};
if (data.webhookEvent === 'jira:issue_created') {
message.attachments.push(prepareAttachment(data, `*Created* ${issueSummary}:\n${stripDesc(issue.fields.description)}`));
} else if (data.webhookEvent === 'jira:issue_deleted') {
message.attachments.push(prepareAttachment(data, `*Deleted* ${issueSummary}`));
} else if (data.webhookEvent === 'jira:issue_updated') {
if (data.changelog && data.changelog.items) { // field update
let logs = [];
data.changelog.items.forEach((change) => {
if (!change.field.match('status|resolution|comment|priority') ) {
return;
}
if (change.field==='description') {
logs.push(`Changed *description* to:\n${stripDesc(change.toString)}`);
} else {
logs.push(`*${change.field}* changed from ${change.fromString} to *${change.toString}*`);
}
});
logs.length && message.attachments.push(prepareAttachment(data, `*Updated* ${issueSummary}:\n - ${logs.join('\n - ')}`));
}
if (data.comment) { // comment update
let comment = data.comment;
let action = comment.created !== comment.updated ? 'Updated comment' : 'Commented';
message.attachments.push(prepareAttachment(data, `*${action}* on ${issueSummary}:\n${stripDesc(comment.body)}`));
}
}
if (message.text || message.attachments.length) {
return {content:message};
}
} catch(e) {
console.log('jiraevent error', e);
return {
error: {
success: false,
message: `${e.message || e} ${JSON.stringify(data)}`
}
};
}
}
}Press Save Changes button and copy Webhook URL.
3. Create a WebHook on JIRA
Go to JIRA as administrator and goto "System" -> "WebHooks" and click "Create a WebHook". Input like this:
- Name : Name of webhook
- Status : Enabled
- URL : Paste webhook url you copied from step 5.
- Event : Check events which you want to send notification message
All done. Your JIRA notifications will be sent to Rocket.Chat.
How to send BitBucket notification to Rocket.Chat
1. Create new Bot User
Just like the step 1 of JIRA integration, create a new bot user like 'bitbucket'.
2. Create new integration
Same as step 2 of JIRA integration, but use this script to Script section.
- When using BitBucket Cloud : Click to see
- When using BitBucket Server : Click to see
Press Save Changes button and copy `Webhook URL'.
3. Create a WebHook on BitBucket
BitBucket doesn't have WebHook function basically, But they provide it as add-on.
Got to BitBucket as administrator and goto "Administration" -> "Find new add-ons". Search Bitbucket Web Post Hooks Plugin and install it.
BitBucket have to setting hook per repository. Click repository and go to "Settings" -> "Hooks" and click "Post-Receive WebHooks".
Paste WebHook URL you copied by step 2.
All done. BitBucket notifications will be sent to Rocket.Chat.