Skip to main content

Builder - Integrations

Add, configure, pause, and remove connectors, and manage webhooks, from the Integrations page in the Builder.

The Integrations page in the Builder lists every integration available to your AI Employee and the connectors set up for each one. An integration is a type of channel or external system, such as email, voice, or a calendar. A connector is a configured instance of an integration that your AI Employee actually uses. Use this page to add a connector, change its settings, pause it, and manage its webhooks.

Access the Integrations page

  1. Open the Builder.

  2. Click Integrations in the left sidebar.

The page shows a table with one row per integration and its connectors listed underneath.

Column

Description

Name

The integration's title and Idn. Each connector appears below its integration with its own title and Idn.

Connectors

Number of connectors set up for the integration.

Status

Status of each connector: Running or Stopped.

Each integration row has these icons:

  • Question mark, next to the title: shows a description of the integration.

  • Gear, on the right: opens the integration's own settings. Only integrations that have settings show it.

  • Plus, on the right: adds a connector.

Add a connector

  1. On the integration's row, click the plus icon. The Add Connector dialog opens.

  2. Enter a Title for the connector.

  3. Enter an Idn, a unique name for the connector. Use lowercase letters and underscores, with no spaces.

  4. Fill in the settings for that integration. The fields depend on the integration. For example, API Integration asks for a Channel: text, voice, or technical.

  5. Click Save.

The connector appears under its integration and starts running.

If the integration needs settings of its own before a connector can work, the dialog lists them under Required integration settings. Fill those in first.

For the values a specific integration needs, follow the guide for that integration. For example, see Configure the Telnyx connector.

Change a connector's settings

  1. On the connector's row, click the three-dot menu.

  2. Select Edit Settings.

  3. Change the fields and click Save.

Edit Settings appears only for connectors that have settings.

Rename a connector

  1. Click the edit icon (pencil) next to the connector's title.

  2. Change the Title and click Save.

The connector's Idn cannot be changed.

Pause or run a connector

Only a running connector receives and sends events.

  • To stop a connector, click the three-dot menu on its row and select Pause. Its status changes to Stopped.

  • To start it again, click the three-dot menu and select Run.

Manage webhooks

Connectors of the API Integration can have webhooks.

  1. On the connector's row, click the three-dot menu.

  2. Select Webhooks. A panel opens with two tabs: Outgoing and Incoming.

  3. Click Add Webhook, fill in the fields, and save.

Tab

Purpose

Fields

Outgoing

Sends data from your AI Employee to an external address.

Idn, URL, Description, Commands

Incoming

Lets an external service send data to your AI Employee.

Idn, Description, Events, Allowed IPs

To change or delete a webhook, use the edit and delete icons on that webhook.

Edit an integration's settings

Some integrations have settings that apply to all of their connectors.

  1. On the integration's row, click the gear icon.

  2. Change the fields and save.

Remove a connector

  1. On the connector's row, click the three-dot menu.

  2. Select Remove.

  3. Click Delete connector to confirm.

Warning: Removing a connector deletes it and its settings. Your AI Employee stops receiving and sending events through it.

Related articles

Did this answer your question?