Unity Cloud Diagnostics
Servicios Multiplayer

Unity Integrations

Unity Integrations allow you to connect the following Unity Services in your development workflow to non-Unity tools:

  • Bug Reports
  • Cloud Build
  • Collaborate

Impurtant: To add an integration, you must be an Owner or Manager on the Project. For information on assigning roles, see the Members & Groups section of Managing your Organization.

Unity Integrations supports the following non-Unity tools:

  • Webhooks: A user-defined callback that allows Unity to send POST requests to an external service.
  • Discord: Send notifications to your team’s Discord channel through a Discord-defined webhook.
  • Slack: Send notifications to your team’s Slack channel through a Slack-defined webhook.
  • JIRA (Bug Reports and Collaborate only):
    • Bug Reports: Create a JIRA ticket for a bug report.
    • Collaborate: Add comments to existing issues in JIRA. For example, you can add a comment to your issues any time you publish changes in Collaborate.

Adding an integration

To add an integration to your workflow:

  1. Sign in to the Unity Services Dashboard.

  2. Select the Project that you want to add an integration to.

  3. In the left navigation column, click Settings, then click Integrations (Beta).

  4. Click the NEW INTEGRATION button.

  5. In the New Integration dialog box:

    1. Select the Unity Service to add an integration for, then click the NEXT button.
    2. Select the event that triggers the action the integration takes, then click the NEXT button.
    3. Select the program to integrate with, then click the NEXT button to configure the integration.

If you select a webhook or JIRA integration, the Configure options step opens. Otherwise, the configurations screen for the selected tool opens.

Webhook integrations

To configure a webhook integration, you must supply the following information:

Parameter Descripción
Display Name A name to identify the integration in the integrations list.
Webhook URL The URL of the server endpoint that receives the webhook POST requests from the Unity service.
Authentication Secret The client secret of your receiving application.
Content Type The MIME type of the content. Select the content type of your data from the drop-down menu.
Disable SSL/TLS Verification Set this option only when necessary.
Verifying SSL/TLS certificates helps ensure that your data is sent securely.

JIRA integration

The Unity JIRA integration allows you to interact with JIRA as follows:

  • Bug Reporting - Create a new issue when you receive a report
  • Collaborate - Add a comment to an existing issue when you publish a change in Collaborate.

To configure a JIRA integration for Collaborate or Bug Reporting, you must supply the following information:

Parameter Descripción
Display Name A name to identify the integration in the integrations list.
JIRA Site URL The URL of you JIRA instance.
JIRA Username The user ID of an account that can post updates to your JIRA instance.
JIRA REST API Token The API token to authenticate Integration requests to your JIRA server. For instructions on how to create a token, see Atlassian’s documentation.

For Bug Reporting, once you have entered the information for your JIRA instance, you must supply the following additional information:

Parameter Descripción
Create Issues In This Project Select the project in which the issues are created.
Mark Incoming Issues As Select the type of issue to log the report as.

When you make changes in Collaborate, update JIRA associated issues by referencing the issue key in your commit message. For example, “I fixed the crashes caused by ISS–42” adds publish details to issue “ISS–42”.

Discord integrations

To configure Discord integrations, Unity calls an app that uses the Discord API to register a webhook to a Discord channel. If you do not have a Discord server, see Discord documentation: How do I create a server?.

To complete the configuration:

  1. Sign in to your Discord account.
  2. From the Select a server drop-down menu select your Discord server.
  3. From the Select a channel menu select a channel to post notifications to.
  4. Click the Authorize button.

Slack integrations

To configure Slack integrations, Unity calls an app that uses the Slack API to register a webhook to a Slack channel.If you do not have a Slack server, see Slack documentation: Create a Slack workspace.

To complete the configuration:

  1. Sign in to your Slack account.
  2. In the right-hand corner of the of the app, select a Slack workspace.
  3. From the Post to drop-down menu, select the Slack channel to post notifications to.
  4. Click the Authorize button.

Discord integrations

To configure Discord integrations, Unity calls an app that uses the Discord API to register a webhook to a Discord channel. If you do not have a Discord server, see Discord documentation: How do I create a server?.

To complete the configuration:

  1. Sign in to your Discord account.

  2. From the Select a server drop-down menu select your Discord server.

  3. From the Select a channel menu select a channel to post notifications to.

  4. Click the Authorize button.

Slack integrations

To configure Slack integrations, Unity calls an app that uses the Slack API to register a webhook to a Slack channel.If you do not have a Slack server, see Slack documentation: Create a Slack workspace.

To complete the configuration:

  1. Sign in to your Slack account.

  2. In the right-hand corner of the of the app, select a Slack workspace.

  3. From the Post to drop-down menu, select the Slack channel to post notifications to.

  4. Click the Authorize button.

Editing an integration

To edit an existing integration:

  1. Sign in to the Unity Services Dashboard.

  2. Select the Project that you want to edit an integration for.

  3. In the left navigation column, click Settings, then click Integrations (Beta).

  4. Click EDIT next to the integration to modify.

The types of edits you can make depend on the integration. For Slack and Discord integrations, you can update the display name or delete the integration.

For webhook and JIRA integrations, you can modify any of the configuration parameters that you supplied when you created them.


Unity Cloud Diagnostics
Servicios Multiplayer