# Custom app

## Общая информация

#### Интеграция позволяет подключить:

* собственный (либо гибкий сторонний) онлайн-чат
* чат в мобильном приложении
* любой сторонний мессенджер (если нет в разделе "Приложения") 
* чат-ботов в мессенджерах по типу "Мессенджер - чат-бот - Blinger.io", 

для того чтобы обрабатывать обращения клиентов в Blinger.io, Zendesk, Intercom, Kayako или SalesForce. 

## Подключить Custom app?

### Шаг 1. Открыть вкладку «Приложения» и нажать кнопку «Добавить»

![](https://3288995818-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LB1W87r5cFc0hgB5qdy%2F-Llpe99u5FiBf_oc410Z%2F-LlqAvctzb5OCngjsdci%2Fimage.png?alt=media\&token=b4095bfb-4510-4a53-a27e-c3b5a6583011)

### Шаг 2. **Выбрать канал Custom app и нажать** «Добавить **Custom app**»

![](https://3288995818-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LB1W87r5cFc0hgB5qdy%2F-Lm981Kn8OJ7FyAaHu19%2F-Lm9roVGkKfvYEJMBiQM%2Fimage.png?alt=media\&token=481628f1-e94a-4ae0-8d79-45ce3ddaff75)

### Шаг 3. Настроить добавление канала

| Поле                | Тип     | Описание                                 |
| ------------------- | ------- | ---------------------------------------- |
| **Name**\*          | varchar | Имя приложения                           |
| **Custom App Id\*** | varchar | Уникальный Id приложения                 |
| **Webhook URL\***   | varchar | URL для отправки сообщения из Blinger.io |

### Шаг 4. Настроить получение и отправку сообщений от end-user

{% hint style="info" %}
Сообщения приходят в **json-формате**
{% endhint %}

#### Получение сообщений от end-user

| **Поле**                  | **Тип** | **Описание**                                                                                                                                                    |
| ------------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **token\***               | varchar | <p>Авторизационный токен.</p><p>Передается в заголовке Authorization: Bearer</p><p>TOKEN</p><p>Генерируется при добавлении приложения из интерфейса Blinger</p> |
| **custom\_channel\_id\*** | varchar | Уникальное поле. Задается при добавлении приложения из интерфейса Blinger                                                                                       |
| **client\_id\***          | varchar | Id конечного пользователя                                                                                                                                       |
| **client\_name**          | varchar | ФИО конечного пользователя                                                                                                                                      |
| **client\_phone**         | varchar | Телефон конечного пользователя                                                                                                                                  |
| **info**                  | json    | Дополнительная информация о конечном пользователе                                                                                                               |
| **type\***                | varchar | <p>Тип сообщения:</p><ul><li>text</li><li>image</li><li>file</li></ul>                                                                                          |
| **data\***                | text    | Текст сообщения или ссылка на файл                                                                                                                              |
| **echo**                  | boolean | Эхо-сообщение, т.е. сообщение подтянутое из другого сервиса                                                                                                     |
| **echo\_outgoing**        | boolean | Исходящее эхо-сообщение                                                                                                                                         |

####

#### Отправка сообщений end-user

| **Поле**                | **Тип** | **Описание**                                                                                          |
| ----------------------- | ------- | ----------------------------------------------------------------------------------------------------- |
| **token**               | varchar | <p>Передается в заголовке Authorization: Bearer</p><p>TOKEN</p>                                       |
| **custom\_channel\_id** | varchar | <p>Уникальный custom\_channel\_id.</p><p>Задается при добавлении приложения из интерфейса Blinger</p> |
| **client\_id**          | varchar | Id конечного пользователя                                                                             |
| **type**                | varchar | <p>Тип сообщения:</p><ul><li>text</li><li>image</li><li>file</li></ul>                                |
| **data**                | text    | Текст сообщения или ссылка на файл                                                                    |

### **Шаг 5. Настроить webhooks**

Вебхуки для входящих и исходящих сообщений можно посмотреть на странице настроек приложения.

Пример:

![](https://3288995818-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LB1W87r5cFc0hgB5qdy%2F-LayMdAozVVCqfVxbzK9%2F-LayY9rwYgT8OAdOYFvE%2Fimage.png?alt=media\&token=531f0fbe-12ac-4778-80c8-6cfd21cbb0f3)

{% hint style="success" %}

### **Интеграция завершена!**

{% endhint %}