The role of the Tai user should be the same as the one you would give to your customer to log into Tai.
Part 1: Share Your Tai Portal URL and Login Credentials
Owlery needs three things from your Tai account to establish the connection:1
Gather Tai credentials
Collect the following from your Tai account:
- Tai portal URL: the web address you use to log into Tai. It always takes the form
yourcompany.taicloud.net. - Tai portal username and password: any login for your customer will do.
- API key: the API key associated with that Shipper Customer account in Tai.
2
Send credentials securely
Share the login credentials and the API key using a secure method (e.g. a password manager share link, encrypted message, or your organization’s preferred secure channel). The portal URL isn’t sensitive, so you can send it alongside — just make sure we get all three.Email support@owlery.ai to coordinate handoff if you’re unsure how to share them.
3
Wait for confirmation
The Owlery team will configure the connection on their end and let you know when it’s ready. At that point, they’ll run a test tender and load to verify everything works.
Part 2: Set Up Webhooks in Tai
Webhooks let Tai push real-time updates to Owlery whenever something changes on a load. You’ll need to configure three endpoints in Tai for each shipper.1
Request a webhook API token from Owlery
Email support@owlery.ai and let them know which shipper you need a webhook token for. Owlery will generate a token specific to that shipper and send it back to you.
2
Add the webhook endpoints in Tai
In your Tai portal, navigate to the webhook configuration for the shipper and add the following three endpoints. Use the API token from Step 1 to authenticate each one.Status updatesLoad detailsLocation trackingInvoices
3
Verify the connection
Once the webhooks are saved, coordinate with the Owlery team to run a test tender and load. This confirms that status, detail, and location events are flowing correctly.
Reefer Loads
Tai has no field for temperature requirements. Owlery won’t send a reefer tender into Tai without its temperature, so by default reefer tenders come to you in the Owlery carrier portal instead of through the API.1
Open the tender in Owlery
Log in to Owlery and open the tender from Quotes & Tenders.
2
Build the load in Tai
Create the load in Tai by hand, using the details on the tender, including the temperature.
3
Accept with the Tai load number
Enter the Tai load number in the Load Number field and accept the tender. This is how Owlery matches Tai’s webhook updates to the load. See Accept a Tender for the full steps.
Send the Temperature as a Shipment Reference
To skip building reefer loads by hand, Owlery can send reefer tenders into Tai like any other tender. The temperature comes through as a shipment reference with the reference typeDesired Temperature. Email support@owlery.ai to turn this on for your account.