Zapier Integration¶

Enable Zapier on your Mattermost Instance¶

The first time you set up Zapier on your Mattermost instance you will be required to enable an OAuth 2.0 application which can be used by everyone on your server. Your System Admin must execute these steps.

Register Zapier as an OAuth 2.0 Application¶

1. Go to Main Menu > Integrations
2. Click OAuth 2.0 Applications, then click Add OAuth 2.0 Application and enter the following fields:

1. Is Trusted: No
2. Display Name: Zapier
3. Description: Application for Zapier integrations
4. Homepage: https://zapier.com/
5. Icon URL: http://bit.ly/2bxrzv0
6. Callback URLs: https://zapier.com/dashboard/auth/oauth/return/MattermostDevAPI/

3. Click Save to create the application. You will be provided with a Client ID and Client Secret. Save these values, or share them with your team to connect Zapier in the steps below.

Create a Zap¶

1. Sign up for a free Zapier account or login if you already have one.
2. On your Zapier dashboard click Make a Zap!.
3. Trigger App: Events in this app will trigger new messages in Mattermost.

1. Select a Trigger App that will trigger new messages in Mattermost. If the app you’re looking to connect isn’t supported on Zapier, consider firing in-app events to a Gmail account and then connecting Gmail to Mattermost using Zapier.
2. Select the Trigger Event. New messages in Mattermost will fire depending on these selected events in conjunction with any filters you apply.
3. Connect the Trigger Account. Connect the account from which you’d like to trigger events and Test it to ensure Zapier can connect successfully.

4. Filtering (Optional): Exclude certain events from triggering new messages. Learn more about using Zapier custom filtering.

1. Add a filter by clicking the small + icon before the Action step.
2. Zapier supports AND and OR filters. Use the dropdown selectors to choose what events will allow the trigger to send a Mattermost message.

5. Mattermost Action: Connect your Mattermost Account and then specify posting details.

1. Select the Action App. Search for “Mattermost”.
2. Select the Action Event. Select Post a Message. The Mattermost team plans to expand the actions available here.
3. Connect the Action Account. Click Connect a New Account and enter the following fields:

1. Mattermost URL: This is the URL you use to access your Mattermost site. Do not include a slash at the end of the URL and do not append a team to the end of the server URL. For example, https://pre-release.mattermost.com/core is the entire URL to the Contributors team on our pre-release server. The Mattermost URL entered here would be https://pre-release.mattermost.com.
2. Client ID/Secret: If Zapier has been enabled as an OAuth application as per the steps above, then these values can be found by navigating to one of your Mattermost teams, then Main Menu > Integrations > OAuth 2.0 Applications. Click Show Secret next to the Zapier app, then obtain the Client ID and Client Secret.
3. Login to Mattermost. After completing the above fields you will be prompted to login to your Mattermost account if you are not logged in already. If you’re having trouble connecting then please read our troubleshooting guide.
4. You’ll then be prompted to allow Zapier to access your Mattermost account. Click Allow.

4. Message Post Details: Specify the formatting of the messages and the team/channel where messages will post.

1. Team: Choose the team where new messages will post. The dropdown should contain all teams you have access to on Mattermost.
2. Channel: Choose the channel where new messages will post. The dropdown will contain all Public Channels and Private Groups that you belong to. Zapier cannot post into Direct Message channels.
3. Message Text: Enter the message text that will post to Mattermost. This text can be formatted using Markdown and include the dynamic fields offered by your selected trigger app. Read our message formatting tips below.

4. Username: This is the username that Zapier will post as. Zapier integrations will always appear with a BOT tag next to the username. In order for bots to override the username of the authorized user, your System Admin must set Enable integrations to override usernames to True.
5. Icon URL: This is the profile picture of the bot that Zapier will post as. In order for bots to override the profile picture of the authorized user, your System Admin must set Enable integrations to override profile picture icons to True.

5. Test the Zap: You may want to test your zap formatting in a Private Group before posting in a channel that is visible to your entire team.

Examples¶

The Mattermost team has over 50 zaps integrated on our Pre-Release Contributors team used for internal communication and interacting with contributors. The Community Heartbeat channel integrates all our community services in one accessible location. These zaps are formatted in two ways depending on the service:

GitHub Issues and Comments, UserVoice Suggestions and Comments, GitLab MM Issues, GitLab Omnibus MM Issues:

#### [Title of issue]

#[searchable-hashtag] in [external service](link to service) by [author](link to author profile) on [time-stamp](link to specific issue or comment)

[Body of issue or comment]

Forum Posts, Jira Comments, Hacker News Mentions, Tweets:

> [forum post, media mention, or tweet]

#[searchable-hashtag] in [external service](link to service) by [author](link to author profile) on [time-stamp](link to specific forum post, media mention or tweet)

Cannot connect a Mattermost account¶

1. “Token named access_token was not found in oauth response!”

1. Possible Solution: Try removing any trailing /‘s on the end of your Mattermost URL.

• Correct: https://pre-release.mattermost.com
• Incorrect: https://pre-release.mattermost.com/

2. “[Server URL] returned (404)”

1. Possible Solution: The Mattermost URL cannot have a team appended to the end of the server URL.

• Correct: https://pre-release.mattermost.com
• Incorrect: https://pre-release.mattermost.com/core

3. “[Server URL] returned (500) Internal Server Error”

1. Possible Solution: The Client Secret might be incorrect. Verify this value in Main Menu > Integrations > OAuth 2.0 Applications, or check with your System Admin.

4. “Mattermost needs your help: We couldn’t find the requested app”

1. Possible Solution: The Client ID might be incorrect. Verify this value in Main Menu > Integrations > OAuth 2.0 Applications, or check with your System Admin.

Post Error¶

1. “We hit an error creating a post message.”

1. Possible Solution: Ensure your Message Text is less than 4000 characters, since that is the maximum character limit for any single message in Mattermost.

Deauthorize the Zapier App¶

1. If you’d like to deauthorize Zapier so it can no longer post through your connected account, go to Account Settings > Security > OAuth 2.0 Applications, then click Deauthorize on the Zapier app.