Simply send messages to your Mattermost team using incoming webhooks.
- Login to your Mattermost team site and go to Account Settings -> Integrations
- Next to Incoming Webhooks click Edit
- Select the channel or private group to receive webhook payloads, then click Add to create the webhook
- The API key is the last part of the URL (eg: u2x8rkfugj8zbqby9pw3huqnyc)
matterhook is very simple and efficient to use:
from matterhook import Webhook
# mandatory parameters are url and your webhook API key
mwh = Webhook('https://mattermost.MYCOMPANY.com', 'API_KEY')
# send a message to the API_KEY's channel
mwh.send('coconut webhook message')
from matterhook import Webhook
# mandatory parameters are url and your webhook API key
mwh = Webhook('https://mattermost.MYCOMPANY.com', 'API_KEY')
# personalized bot name and icon
mwh.username = 'cocobot'
mwh.icon_url = 'http://3.bp.blogspot.com/-bEcLJDp_u7o/UJKPRGazv6I/AAAAAAAABGY/75z_6bbegao/s1600/coconut-oil-alzheimers-study.jpg'
# send a message to the specified channel
mwh.send('coconut is da thruth', channel='special_channel')
# override the username for this message
mwh.send('secret message', channel='special_channel', username='secret_user')
# for convenience, you can also do this...
mwh['incredible_channel'] = 'incredible message'
# ...and even this
mwh['incredible_channel'] = {'text': 'incredible message', username='incredible user'}