Transifex

  • Documentation
  • Transifex Integrations
  • Slack

Slack

Who can use the Slack Integration?

Any organization with a paid plan has access to the Transifex-Slack Integration.

Overview

This integration allows Slack users to receive notifications and get informed or take action on string issues or comments. All Slack users can also monitor progress based on statistical reports generated within the Slack collaboration tool.

Teams using Slack as a central communication tool in their workflow can now monitor and manage their projects using their preferred Slack communication channel.


Who can install the Slack Integration?

Only Organization Administrators can install Slack Integration in Transifex.

  • Step 1: Manage your Organization's integrations.

    • From your Transifex application, click the link for Organization Settings as seen below:

    slack1.jpg#asset:5670

    • Then select Manage Integrations from the Left Hand Side Menu that appears.


  • Step 2: Install the integration on your Organization.

    To begin click the "Add to Slack" button for the Slack integration as seen below:

    Slack Integration widget

    • This will open up a new tab in your Web Browser called

    1c.jpg#asset:5676 where the installation will continue.

    • Select the Slack Workspace that will be linked to your organization from the drop down list located on the top right hand side.
    • From the Post To drop down list select the Channel you want to receive Transifex notifications.
    • Then click the Authorize button to continue.


    1d.jpg#asset:5677

    • The following will appear to indicate that The Slack integration for your organization is complete:

    Slack Integration authorized


  • Step 3: Install the Transifex App in your Slack Workspace.

    • Follow the instructions as described in the Slack documentation indicated here.
    • Look for the following Application to install in Slack:

    1f.jpg#asset:5680

All notifications are bound to a specific Slack channel, so they are channel-bound, not user-bound.

  • A new resource has been added to a project. 

    • An example of a sample notification can be seen below:

    1j.jpg#asset:5681

    • Clicking on each link in the message will open the resource, user profile, project, or translation editor respectively.

  • A new issue or comment was created by a user about a string in the editor. 

    • For more information on creating and handling issues consult our documentation guide here.
    • An example of a sample notification can be seen below:

    issue-slack.jpg#asset:6288

    • Clicking on each link in the message will open the user profile, the issue in the translation editor, the project and resource respectively.
    • The actual message in the issue or comment is also displayed.
    • The user has the ability to resolve the issue (issue only) or reply to the sender (both comments and issues) directly from Slack.
  • An issue was resolved in the editor. 

    • For more information on resolving issues consult our documentation guide here.
    • An example of a sample notification can be seen below:

    IssueResolvedSlack.jpg#asset:6172

    • Clicking on each link in the message will open the user profile, the issue in the translation editor, the project and resource respectively.
    • The actual message in the issue is also displayed.
  • A project announcement was created. 

    • For more information on announcements consult our documentation guide here.
    • An example of a sample notification can be seen below:

    1k.jpg#asset:5684

    • Clicking on each link in the message will open the user profile, the announcement or the project respectively.

  • A resource language was 100% translated.

    • An example of a sample notification can be seen below:

    1l.jpg#asset:5685

    • Clicking on each link in the message will open the project and resource respectively.

  • A resource language was 100% reviewed or proofread.

    • An example of a sample notification can be seen below:

    slack100perReviewed.jpg#asset:6173

    • Clicking on each link in the message will open the project and resource respectively.
  • A new team discussion has been started or a new reply on an existing discussion was added.

    • For more information on discussions consult our documentation guide here.
    • An example of a sample notification can be seen below:

    discussionsSlack.jpg#asset:6174

    • Clicking on each link in the message will open the user profile, team overview and discussion respectively.
    • The actual message in the discussion is also displayed.

  • A new team member has been added.

    • For more information on teams please consult our documentation guide here.


Slash commands are available to all Slack workspace users that Transifex app was installed to.

  • List of projects in your Transifex organization

    • Syntax: /tx projects
    • Sample Output:

    2b.jpg#asset:5687

    • Clicking on each link in the output will open the associated project.
  • Get a project's localization progress.

    • Syntax: /tx stats <project_name>
    • Example: /tx stats transifex
    • Sample Output:

    2c.jpg#asset:5688

    • Clicking on the language link in the output will open the associated language in the project.

  • Get the localization progress of a specific project's language.

    • Syntax: /tx stats <project><language>
    • Example: /tx stats ensourcelang fr_CA
    • Sample Output:

    4.jpg#asset:5691

    • <language> can be either the language locale or the language name. 
    • Clicking on the language link in the output will open the associated language in the project.
  • Get the translation progress of a specific project resource.

    • Syntax: /tx stats <project> <resource>
    • Example: /tx stats ensourcelang example_key_valuejson
    • Sample Output: 

    2f.jpg#asset:5689

    • Clicking on the language link in the output will open the associated language in the project.
  • Get the translation progress on specific resource/language

    • Syntax: /tx stats <project> <resource> <language>
    • Example: /tx stats ensourcelang example_key_valuejson el_GR
    • Sample Output: 

    3a.jpg#asset:5690

    • Clicking on the language link in the output will open the associated language in the project.


  • Return a list of open issues for a given project and resource. 

    • Syntax: /tx issues <project> <resource> <date_time>
    • Example: /tx issues git
    • Sample Output:

    slack-issues.jpg#asset:6251

    Setting "all" for <resource> you'll get all resourcesIf date_time is specified return list for specific timeframe.

    • Clicking on the user name in the output will open the associated user profile, Clicking the string name will open the string in the Transifex editor, clicking on the resource link opens up the resource.
    • From the output a user can reply to the issue creator or resolve the issue.
  • Return a list of comments for a given project. 

    • Syntax: /tx comments <project> <resource> <date_time>
    • Example: /tx comments blank_project
    • Sample Output:

    Comments-Slash.jpg#asset:6289

    • Similar to issues above, setting "all" for <resource> you'll get comments across all resources. If date_time is specified return list for specified timeframe.
    • Clicking on the user name in the output will open the associated user profile, Clicking the string name will open the string in the Transifex editor, clicking on the resource link opens up the resource.
    • From the output a user can reply to the comment creator.


Configuring Slack Notifications

From your organization settings page go to Manage Integrations and under Slack click on notification settings. This will allow you to configure what updates are received in the Slack channel across all organization projects.

slack-notification-settings.jpg#asset:6252