Skip to content

Trint

The Trint modules allow you to monitor and upload files in your Trint account.

Getting Started with Trint

Prerequisites

  • A Trint account

In order to use Trint with Ibexa Connect, it is necessary to have a Trint account. You can create a Trint account at app.trint.com/signup.

Note

The module dialog fields that are displayed in bold (in the Ibexa Connect scenario, not in this documentation article) are mandatory!

Connecting Trint to Ibexa Connect

To connect your Trint account to Ibexa Connect you need to obtain the API Key from your Trint account and insert it in the Create a connection dialog in the Ibexa Connect module.

  1. Log in to your Trint account and open your Dashboard.

  2. Click your profile icon (top-right corner) > Settings > API > Generate new key.

    61f27d2de9343.gif

  3. Copy the API Key to your clipboard.

    61f27d3042175.png

  4. Go to Ibexa Connect and open the Trint module's Create a connection dialog.

    61f27d3130d21.gif

  5. In the Connection name field, enter a name for the connection.

  6. In the API Key field, enter the API key copied in step 3, and click Continue.

The connection has been established.

Triggers

See the Setting Up the Webhooks to add the webhooks in your Trint account.

Watch Transcript Complete/Verified

Triggers when the transcript is complete or verified.

Webhook Name Enter a name for the webhook.

Actions

Upload a File

Uploads a file.

File Data Enter (map) the file data of the file you want to upload.
File Name Enter the name of the file you are uploading.
Langauge Enter the language in which you want to transcribe.
User Enter the username to whom you want to attach the uploaded file.
Metadata Enter the metadata that you want to include in the callback event. For example, the ID of a record in your DB.
Detect Speaker change Select the checkbox to automatically split paragraphs based on the change of speaker.
Folder ID Enter the Folder ID to which you want to upload the file directly.
Workspace ID Enter the Workspace ID to which you want to upload the file.

Make an API Call

Performs an arbitrary authorized API call.

URL

Enter a path relative to https://api.trint.com/. For example: /folders

For the list of available endpoints, refer to the Trint API Documentation.

Method

Select the HTTP method you want to use:

GET

to retrieve information for an entry.

POST

to create a new entry.

PUT

to update/replace an existing entry.

PATCH

to make a partial entry update.

DELETE

to delete an entry.

Headers

Enter the desired request headers. You don't have to add authorization headers; we already did that for you.

Query String

Enter the request query string.

Body

Enter the body content for your API call.

Example of Use - List Folders

The following API call returns all the folders from your Trint account:

URL:

/folders

Method:

GET

61f27d335315f.png

Matches of the search can be found in the module's Output under Bundle > Body.

In our example, 3 folders were returned:

61f27d3451f5c.png

Setting Up the Trint Webhooks

  1. Open the Watch module, establish a connection, click Save and copy the URL address to your clipboard.

    61f27d3553399.gif

  2. Log in to your Trint account.

  3. Click your p*rofile icon* > Settings > API.

  4. In the Callback Settings section, enter the URL address copied in step 1 and select the events for which you want to receive the triggers.

    61f27d3774147.gif

You have successfully added the webhook.