• Documentation
  • Integrations
  • Zapier

Zapier

Note

The Zapier integration is currently available in private beta. If you're interested in trying it out, please contact us. Additionally, please note that Zapier is a freemium service.

Zapier is a tool that lets you connect different apps together and set up “Zaps” to automate tasks. These Zaps, or workflows, are created by connecting triggers (events) in one app with actions (tasks performed) in another. The Transifex app in Zapier supports the following triggers and actions:

  • Triggers: Translation completed, Review completed, Fillup completed, Any of the above (These are the same events supported by our webhooks)
  • Actions: Upload file to Transifex, Download file from Transifex

With these, you can set up workflows (Zaps) like these:

  • Get notified in Slack each time translations for a language are complete
  • Push new source files from Dropbox to Transifex
  • Download translated files to Dropbox when translations are complete

Below, we’ll guide you through the process of setting up the three Zaps above. However, the beauty of Zapier is that it’s flexible. You can use the supported triggers and actions to create similar Zaps connected to other services (e.g. HipChat or Box) or create something totally new.

Get Slack notifications about finished translations

For this Zap, we’ll first set up a trigger based on an event in Transifex (translations are completed). Then we’ll set up an action to take place in Slack (message a channel) whenever that event occurs. You can follow these steps to get notified about other events, or send notifications through another service.

Setting up the Transifex trigger

  • Sign up for a Zapier account if you don't already have one, then log into the Zapier Dashboard and click the Make a Zap! button in the header.

  • You’ll be asked to choose a trigger app. Search for Transifex and select it from the drop down.

    zapier-choose-trigger-app.png#asset:3840

  • Select the event you want to use as a trigger. For this example, we’ll choose Translations completed. Once you've selected a trigger, hit Save + Continue.

  • Click on Connect a New Account to link Zapier to Transifex. In the popup window, put in a Transifex webhook secret. Remember the secret because you’ll need it later. You can also add in your API key if you plan on setting up a Zap for downloading files later. Hit Save + Continue.

  • Copy the target webhook URL. Then head to Transifex (preferably in a new tab), and go to the Settings for the project you want to set up this Zap for. In the submenu, click on Webhooks and then Add webhook.

  • Paste the URL you copied earlier into the URL field. Enter in the secret from earlier, and choose which event this webhook is for. The event you select should be the same as the trigger you selected in Step 2 above. Set the Webhook to Active, then click Save Changes

    zapier-webhook-setup.png#asset:3841

  • Once you’ve set up the webhook in Transifex, head back to Zapier and click Continue.

  • Click Fetch & Continue to make sure the webhook is working. Then hit Continue.

Setting up the Slack action and activating your Zap

Once you've set up the trigger, you can set up the action.

  • Choose an action app. In this case, we’ll search for and select Slack.

  • From the available actions, choose Send Channel Message and hit Save + Continue.

    zapier-choose-action.png#asset:3842

  • Click on Connect a New Account and authorize Slack. Once you’ve done this, hit Save + Continue.

  • Set up and customize the message you want to see in Slack by selecting the Channel the message should appear in, as well as putting in a message text. You can customize the message to say whatever you want, and include variables such as the project name by clicking on the Insert a Field icon on the right side of the text box.

    zapier-slack-message.png#asset:3843

    You can customize other options, such as the Bot name. When you're finished with the customizations, click Continue.

  • Click Create & Test to test the connection. If the test is successful, click Finish.

  • Give your Zap a name, then switch it on!

Sending files from Dropbox to Transifex

For this Zap, we’ll first set up a trigger based on an event in Dropbox (a new file being added). Then we’ll set up an action (uploading the file to Transifex) to take place in Transifex whenever that event occurs. You can follow these steps to send files from other services to Transifex.

Setting up the Dropbox trigger

  • Sign up for a Zapier account if you don't already have one, then log into the Zapier Dashboard and click the Make a Zap! button in the header.

  • You’ll be asked to choose a trigger app. Search for Dropbox and select it from the drop down.

  • Select New File in Directory as the trigger then click Continue.

  • Click on Connect a New Account and authorize Dropbox. Once you’ve done this, hit Save + Continue.

  • Select the Dropbox directory where you'll be adding your source files, then click Continue.

    zapier-dropbox-directory.png#asset:3844

  • Click Fetch & Continue to make sure the webhook is working. If the test is successful, hit Continue.

Setting up the Upload action and activating your Zap

Once you've set up the trigger, you can set up the action.

  • Choose an action app. In this case, we’ll search for and select Transifex.

  • From the available actions, choose Upload files to Transifex, then hit Save + Continue.

  • Click on Connect a New Account to link Zapier to Transifex. In the popup window, put in your API key. You can also put in a Transifex webhook secret if you plan on setting up a Zap for downloading files from Transifex. Remember the secret because you’ll need it later. Hit Save + Continue.

  • On this page, enter the project slug of the project in Transifex you want to upload the source file to. Then set the Name field to File Name and File field to File. For the i18n Type, choose the format of the files you'll be sending from Dropbox to Transifex. Click Continue once you're done with the configuration.

    zapier-file-upload.png#asset:3845

  • Click Create & Continue to make sure everything is working. If the test is successful, hit Finish.

  • Give your Zap a name, then switch it on!

Downloading files from Transifex to Dropbox

For this Zap, we’ll first set up a trigger based on an event in Transifex (translations are completed). Then we’ll set up two actions. One to download the translation files from Transifex, and one to upload those files to Dropbox. You can follow these steps to get notified about other events, or send notifications through another service.

Setting up the Transifex trigger

First, you'll need to set up the trigger. The process for this is the same as the one for the Slack notification slack. Please refer to the instructions there for the step-by-step details.

Setting up the Download action

Before we can upload a file to Dropbox, we need to download it from Transifex first. Here's how to set this up:

  • Choose an action app. In this case, we’ll search for and select Transifex.

  • From the available actions, choose Download file to Transifex, then hit Save + Continue.

  • Connect a New Account to link Zapier to Transifex. In the popup window, put in your API key. You can also put in a Transifex webhook secret if you plan on setting up a Zap for uploading files from Transifex. Remember the secret because you’ll need it later. Hit Save + Continue

  • Using the dropdowns, set the Project field to Project, Resource field to Resource, and Language field to Language. Then click Continue.

    zapier-download-config.png#asset:3846

  • You’ll be brought to the Test screen. You can click Skip test & continue and move on to steps below.

  • Click the + icon in the left panel to add another action step. Search for Dropbox and select it from the drop down. 

  • Select the Upload File action then click Continue.

  • Click on Connect a New Account and authorize Dropbox if you haven’t done so already. Once you’ve done this, hit Save + Continue.

  • On this page, configure the settings as follows using the dropdowns.

    Directory = Use a Custom Value (advanced)
    Custom Value for Directory Path = Target path where the file will be stored
    File = Translated file downloaded from Transifex
    Overwrite = Yes
    Specify File Name = Filename of the file

    Then hit Continue.

    zapier-dropbox-upload.png#asset:3847

  • Again, click Skip test & continue. Then click Continue again.

  • Give your Zap a name, then switch it on!