Unity Cloud Diagnostics
Multiplayer

Unity Integrations

Unity Integrations を利用すると、開発ワークフロー内の以下の Unity Services を Unity 以外のツールと接続することができます。

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 は以下の外部ツールをサポートします。

  • 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.
  • Email: Send notifications to your team by Email.
  • JIRA: Create or update JIRA tickets using a JIRA-defined webhook.

Integration limits

Unity Personal limits users to one Integration for all events, but multiple Unity services can use that Integration. Unity Teams, Plus, and Pro users can have up to 100 Integrations. If your Unity Teams, Pro, or Plus subscription expires, Unity keeps all of your current Integrations, but automatically disables them. If this happens, you can still sign into the Unity Services Dashboard and enable a single Integration.

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 bar, select Settings > Integrations.
  4. The integrations dashboard appears. Click the NEW INTEGRATION button.

    Creating a new Integration in the Developer Dashboard.
  5. Select the Integration you want to enable.
  6. Select the event(s) that you want to trigger the Integration, then click the NEXT button.
  7. Configure the Integration options. These options vary depending on the Integration selected, and are described in detail in the sections below.
Configuring a new tool to Integrate.
Configuring a new tool to Integrate.

Webhook Integrations

To configure a webhook Integration, supply the following information:

Webhook configuration settings.
Webhook configuration settings.
Parameter 説明
Display Name A name to identify the Integration in the Integrations list.
Webhook URL Unity からの Webhook POST リクエストを受けとるサーバーエンドポイントの URL
Authentication Secret 受信側アプリケーションのクライアントシークレット
Content Type コンテンツの MIME タイプ。ドロップダウンからデータのコンテンツタイプを選択します。
Disable SSL/TLS Verification Tick this checkbox to disable verification of SSL/TLS security certificates.
Verifying SSL/TLS certificates helps ensure that your data is sent securely to the above Webhook URL. Turning this option on is not recommended, so only do this if you absolutely know what you’re doing.

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 How do I create a server? in the Discord documentation.

Important: You must enable webhooks on the account with which you are integrating.

以下の手順で設定します。

  1. Create a new Discord integration and select its events.
  2. Click the NEXT button. Sign in on the Discord login screen.
  3. The CONNECT TO DISCORD dialog screen appears.

    Configuring a Discord Integration.
  4. From the Select a server drop-down menu, select your Discord server.
  5. From the Select a channel menu, select a channel to post notifications to.
  6. 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.

After creating a new Slack integration and configuring the events that you want to appear, you must authorize Unity to access your Slack server.

Authorizing Unity to connect to your Slack server.
Authorizing Unity to connect to your Slack server.

If you do not have a Slack server, see Create a Slack workspace in the Slack documentation.

以下の手順で設定します。

  1. Slack アカウントにサインインします。
  2. アプリケーションの右端で Slack Workspace を選択します。
  3. From the Post to drop-down menu, select the Slack channel to post notifications to.
  4. Click the Authorize button.

Email Integrations

Email Integrations notify team members when specified events for your Project occur.

  1. Create an email integration from the dashboard to view the events menu.
  2. Select the events for which you want to receive email notifications, then click the NEXT button.

    Note: Cloud Build handles email notification settings separately. You can configure them by clicking the here link at the bottom of the events menu.
  3. Select the team members for whom you’d like notifications to be sent.
  4. Select Send email to new team members if you’d like team members that you add in the future to automatically receive the emails that other team members receive.
Configuring email Integrations.
Configuring email Integrations.

JIRA Integrations

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

  • Cloud Diagnostics: Create a new issue when you receive a report. Unity creates the issue with one of the following labels: unity-user-report, unity-crash-report, or unity-exception-report. You must have permission to create an issue and modify the label column for these Integrations to work.
  • Collaborate: Add a comment to an existing issue when you publish a change in Collaborate.
Configuring a JIRA Integration.
Configuring a JIRA Integration.

To configure a JIRA Integration for Collaborate or Cloud Diagnostics, you must supply the following information:

Parameter 説明
Display Name A name to identify the Integration in the Integrations list.
JIRA Site URL The URL of your JIRA instance.
JIRA Username JIRA インスタンスに更新をポストするアカウントのユーザー ID
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.

After you have entered the information for your JIRA instance, you must supply the following additional information for Cloud Diagnostics:

Parameter 説明
Create Issues In This Project Select the project in which to create the issues.
Mark Incoming Issues 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”.

Managing existing Integrations

To manage existing Integrations:

  1. Sign in to the Unity Services Dashboard.
  2. Select the Project with the Integration you want to edit.
  3. In the left navigation column, select Settings > Integrations.

To edit or delete an existing Integration, click EDIT next to the Integration you want 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.

To enable or disable an existing Integration, click the Status toggle to enable or disable the Integration.

Managing Integrations in the Developer Dashboard.
Managing Integrations in the Developer Dashboard.
Unity Cloud Diagnostics
Multiplayer