Integrations configuration settings¶

Review and manage the following integration configuration options in the System Console by selecting the Product menu, selecting System Console, and then selecting Integrations:

Integrations management
Bot Accounts
GIF
CORS

Tip

System admins managing a self-hosted Mattermost deployment can edit the config.json file as described in the following tables. Each configuration value below includes a JSON path to access the value programmatically in the config.json file using a JSON-aware tool. For example, the EnableIncomingWebhooks value is under ServiceSettings.

If using a tool such as jq, you’d enter: cat config/config.json | jq '.ServiceSettings.EnableIncomingWebhooks'
When working with the config.json file manually, look for an object such as ServiceSettings, then within that object, find the key EnableIncomingWebhooks.

Integrations management¶

Available on all plans

Cloud and self-hosted deployments

Access the following configuration settings in the System Console by going to Integrations > Integration Management.

Note

Disabling this configuration setting in larger deployments may improve server performance in the following areas:

Reduced Network Traffic: Outgoing webhooks generate network requests to external services. Disabling them reduces the amount of traffic and resource usage related to those requests.
Decreased Load on Server: Handling webhook events and managing connections to external services uses server resources. By disabling outgoing webhooks, the server workload is reduced, allowing it to allocate more resources to other important tasks.
Improved Response Time: When outgoing webhooks are enabled, the server waits for the external services to return responses, potentially slowing down the performance if the external services are slow or unresponsive. Disabling them removes this dependency, leading to faster response times for user requests.
Lower Memory Usage: Webhooks need memory to process and store data about the requests and responses. Disabling them can free up memory which can be used to improve overall server performance.
Simplified Error Handling: Managing errors and retries for outgoing webhook failures can add complexity and overhead. Disabling outgoing webhooks can simplify error handling and reduce the processing overhead associated with it.
However, outgoing webhooks are often essential for integrating Mattermost with other services and workflows. It’s important to balance performance improvements with the needs of your organization and users.

Note

Cloud admins can’t modify this configuration setting.

Bot accounts¶

Available on all plans

Cloud and self-hosted deployments

Access the following configuration settings in the System Console by going to Integrations > Bot Accounts.

GIF¶

Available on all plans

Cloud and self-hosted deployments

Access the following configuration settings in the System Console by going to Integrations > GIF.

Important

Link previews must be enabled in order to display GIF link previews. Mattermost deployments restricted to access behind a firewall must open port 443 (for all request types) for this feature to work.

CORS¶

Available on all plans

self-hosted deployments

Access the following configuration settings in the System Console by going to Integrations > CORS.

Embedding¶

Available on all plans

self-hosted deployments

Access the following configuration settings in the System Console by going to Integrations > Embedding.

Note

Embedding Mattermost via an iFrame can provide seamless integration for collaboration into an organization’s existing tools and workflows. However, you must ensure that correct configurations are in place to allow communication between the iframe and the parent domain without violating security.