Skip to main content

Step 2

Creating an Integration Source in Tai​

Note: You must do this with an Admin Tai Account

These instructions setup up an integration source inside of Tai which allows the syncing of load information from Tai -> Chaine.

The steps involve:

  1. Generate an API Key inside of Chaine. See Generating an api key in Chaine

    If you would like to setup a sandbox (or beta) environment, please reach out to your Chaine account manager so they can also set up a sandbox environment for you where you can generate a Sandbox API Key

  2. Go inside of Tai, click LSP and then Integration Sources
tai tms integration sources
  1. Click "Add New Integration Source"
tai tms add new integration source
  1. Create a new integration source with the following details:
    • Source Description: You can type "Chaine - " followed by your company name
    • Source Group: Choose Other
    • Integration Type: Choose Public API Webhooks
    • Owner Organization: Should be automatically selected unless you have multiple organizations
    • User Name: Your username
    • Password: Your password
tai tms create integration source

  1. Click "Save and View Details"

  2. Now we will add the integration "Source Settings". Click "Edit Source"

  3. Fill in the following values for the "Name" and "Value" fields:

    • Authorization - The value for this "Name" is the API Key you generated in Chaine

    • ShipmentCreateUrl 

      https://api.chaineapp.com/apps/events/v1/tai

    • ShipmentDetailUpdateUrl 

      https://api.chaineapp.com/apps/events/v1/tai

    • LSPCarrierCreateUrl

      https://api.chaineapp.com/apps/events/v1/tai/carrier

    • LSPCarrierUpdateUrl

          ```
          https://api.chaineapp.com/apps/events/v1/tai/carrier
          ```

      Here is how it should look

      tai tms integration source settings
  1. Click "Save and View Details"
  2. At the bottom of the page, the Linked Organization needs to be set and will ensure that shipments for that organization are submitted. Select the appropriate org and click "Save"

    If you have multiple orgs that need to map to different workspaces inside of Chaine, please work with your Chaine Implementation Specialist to ensure that the correct orgs are linked to the correct workspaces. They will be able to help you set this up.

tai tms integration source settings

That's it! Once Tai enables the webhook, loads will begin to flow into Chaine.

To learn more, see How Tai integrates with Chaine

Generating an API Key in Chaine​

To generate an API Key in Chaine, you will need to have the "Admin" role. If you do not have this role, please reach out to your Chaine account manager to have them generate an API Key for you.

Steps:

  1. Navigate to the "Settings" page in Chaine. (Click your Avatar at the top right)
  2. Click on 'Apps' on the left-menu
  3. Scroll down to the "Tai" app and click "Enable"
  4. Click "Create Key" to generate an API Key
  5. Click "Reveal key" to show the key, and then simply click-it to copy the key to your clipboard.

That's it! You now have an API Key that you can provide to Tai to enable the integration.