Skip to content

Basic integration for Slack notifications for Matlab.

Notifications You must be signed in to change notification settings

DylanMuir/SlackMatlab

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

README

This repository contains Matlab functions to send notifications to a Slack channel or user, via the Slack Incoming Webhooks API.

Usage

SendSlackNotification is used to send a notification to a URL provided by Slack, for a configured Incoming Webhooks integration. See the documentation for this function for information on options.

MakeSlackAttachments can be used to generate Slack message attachments, which can then be sent as notifications using SendSlackNotification. See the documentation for this function for more information.

Set up

  1. Configure an Incoming Webhooks integration for your team, from your team's services page.
  2. Copy the Webhook URL once the service is configured, and store it in a Matlab string.
  3. Clone the SlackMatlab repository, and add the root directory to the Matlab path using pathtool.
  4. Call SendSlackNotification, passing the Webhook URL as an argument.

Example

% - Create a message attachment to send with a notification
%   (optional; several message attachments can be sent with a single notification)
sA = MakeSlackAttachment('New open task [urgent]: <link.to.website>', 'Text of the notification message', ...
      'Text that will be displayed before the message', '#0000ff', ...
      {'Field 1 title', 'This is a field that will be shown in a table'}, ...
      {'Field 2 title', 'This is another field that will be shown in a table'});

% - Send the notification, with the attached message
SendSlackNotification('https://hooks.slack.com/services/this/is/your/webhook/url', ...
   'I sent this notification from matlab, on behalf of @username.', '#target-channel', ...
   'Name to post under', 'http://www.icon.com/url/to/icon/image.png', [], sA);

Emojis

A list of Emojis supported by Slack is available from http://www.emoji-cheat-sheet.com.

Acknowledgements

Contains code from URLREAD2 and JSONLAB.

Releases

No releases published

Packages

No packages published