> For the complete documentation index, see [llms.txt](https://manual.selarti.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://manual.selarti.com/manual-en/external-integrations/integration-using-the-albato-service.md).

# Integration using the Albato service

[*Albato*](https://albato.ru/?_ga=2.31799486.1218008386.1736919597-1080970657.1736919399) *— one service for all integrations. Allows you to set up integrations in minutes without involving developers.*

You can set up an integration with any external service. Selarti will send a webhook to the external system when the AI agent receives contacts or consent for the target action.

For example, the AI agent has agreed on a video meeting, after which a deal will be automatically created in your CRM system, and a message with all the necessary information will be sent to the managers' chat.

### Setting up integration through the Albato service

1. Register in [**the Albato**](https://albato.ru/) service, go to the «*Connections*» and click «*Add connection*».

<figure><img src="https://content.gitbook.com/content/sBua8zDbkZPvmgjidnwA/blobs/daTrq3QX2AuE9BzAfRev/image.png" alt=""><figcaption></figcaption></figure>

2. Choose the connection type «*Webhook*» and click «*Add connection*». Then click «Next» everywhere.

<figure><img src="https://content.gitbook.com/content/sBua8zDbkZPvmgjidnwA/blobs/wRXtqX1tA2ZEWJ6CtxK6/image.png" alt=""><figcaption></figcaption></figure>

3. When the connection is created, click the «*Catch webhook*». After that you need to click «Wait for webhook».

<figure><img src="https://content.gitbook.com/content/sBua8zDbkZPvmgjidnwA/blobs/539qwE5iieKJUaXWI24D/image.png" alt=""><figcaption></figcaption></figure>

4. Copy the link and go to your Selarti account.

<figure><img src="https://content.gitbook.com/content/sBua8zDbkZPvmgjidnwA/blobs/Nc3J66WF9M2EHhczAygm/image.png" alt=""><figcaption></figcaption></figure>

### Settings in the Selarti account

1. In the left side control panel, go to the «[*Integration*](https://selarti.com/panel?menu=integration)», in the top right click «*Create integration*». Choose the integration type «*Albato*».

<figure><img src="https://271796707-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsBua8zDbkZPvmgjidnwA%2Fuploads%2FUqwMUBZVqoVriQiRuRDk%2Falbato_5.png?alt=media&amp;token=f2211b50-610a-417a-91aa-16c0df94c697" alt=""><figcaption></figcaption></figure>

2. Enter your name, then paste the link copied from the Albato account. Click «*Send test webhook*»*.*

<figure><img src="https://271796707-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsBua8zDbkZPvmgjidnwA%2Fuploads%2FgYZqKRAXQJ8JdZaE1EKg%2Falbato_6.png?alt=media&amp;token=88c57a78-0297-4cc3-b166-0f04e4f73449" alt="" width="464"><figcaption></figcaption></figure>

If you did everything correctly, Albato will display available fields, and the entered link in Selarti will be highlighted green.

<figure><img src="https://content.gitbook.com/content/sBua8zDbkZPvmgjidnwA/blobs/NREAYK16JtCQQlK2q4OO/image.png" alt=""><figcaption></figcaption></figure>

3. Select the required tags and click «*Create integration*»*.*

<figure><img src="https://271796707-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsBua8zDbkZPvmgjidnwA%2Fuploads%2FMX2NOBORFC1QRtjpjJOV%2Falbato_7.png?alt=media&amp;token=80779fb8-b5de-4b71-84e9-eab77b75ccc9" alt="" width="464"><figcaption></figcaption></figure>

### Adding a webhook in the Albato service

1. Go to Albato, in the «My flows» section click «Create new flow»*.* The flow builder will open.

<figure><img src="https://content.gitbook.com/content/sBua8zDbkZPvmgjidnwA/blobs/xrzcs8nRlYOKhtl2V6rh/image.png" alt=""><figcaption></figcaption></figure>

2. Add the webhook created above as a trigger and click «*Add trigger*»*.*

<figure><img src="https://content.gitbook.com/content/sBua8zDbkZPvmgjidnwA/blobs/MHmN7CGGFc8av5iXsySe/image.png" alt=""><figcaption></figcaption></figure>

3. Create an action. There can be many options, Albato supports a large number of actions. More about each setting [**here**](https://blog.albato.ru/category/instrukczii/)**.**

Done!

#### Example of setting up a notification in Telegram

1. After creating the action, choose the necessary settings and click «*Add action*».

<figure><img src="https://content.gitbook.com/content/sBua8zDbkZPvmgjidnwA/blobs/kkUAWk472ypWDsJ09YiX/image.png" alt=""><figcaption></figcaption></figure>

A window with settings will open, make the necessary settings and click «*Save*»*.*

<figure><img src="https://content.gitbook.com/content/sBua8zDbkZPvmgjidnwA/blobs/wIYTIDVYxZXiAWns3OTI/image.png" alt=""><figcaption></figcaption></figure>

After you configure the actions, click the «*Run*»*.*

<figure><img src="https://content.gitbook.com/content/sBua8zDbkZPvmgjidnwA/blobs/lqvhvo5LcQm1AdiL5Goe/image.png" alt=""><figcaption></figcaption></figure>

### Description of webhook fields

<mark style="color:purple;">**`title`**</mark> — dialog title (First Name Last Name/profile name).\ <mark style="color:purple;">**`contacts`**</mark> — interlocutor's contacts. Phone, username.\ <mark style="color:purple;">**`success`**</mark> — the AI agent marked the dialog as successful (yes/no).\ <mark style="color:purple;">**`get_contact`**</mark> — the AI agent obtained additional contacts of the interlocutor (yes/no).\ <mark style="color:purple;">**`close`**</mark> — dialog closed (yes/no).\ <mark style="color:purple;">**`is_bot`**</mark> — dialog identified as a bot (yes/no).\ <mark style="color:purple;">**`share_url`**</mark> — link to view the dialog.\ <mark style="color:purple;">**`company_id`**</mark> — Company ID.\ <mark style="color:purple;">**`task_id`**</mark> — Task ID.\ <mark style="color:purple;">**`thread_id`**</mark> — Dialog ID.\ <mark style="color:purple;">**`dialog`**</mark> — AI dialog with the user as text.

We can add additional fields from the list of standard ones. If you think there are fields that all clients need — write to [support](https://t.me/selarti_support_bot).\
You can add custom fields for yourself using [custom API](/manual-en/main-sections-of-the-service/ai/ai-functions.md).
