Интеграции¶
Получить список всех интеграций аккаунта¶
GET /v1.3/integrations
После успешного выполнения возвращается массив объектов, описывающих интеграции.
id | integer | Идентификатор интеграции |
type | string | Тип подключенной интеграции |
login | string | Логин в мессенджере или название аккаунта в социальной сети |
avatar | string | Аватар аккаунта в мессенджере или социальной сети |
externalId | string | Идентификатор подключенного аккаунта в мессенджере или социальной сети |
status | string | Статус подключенной интеграции |
identifier | string | Идентификатор социальной сети или мессенджера [*] |
url | string | Ссылка на подключенную интеграцию |
[*] | identifier позволяет соотнести каналы с разными идентификаторами интеграций к одному аккаунту в социальной сети или мессенджере. Например, если подключен один и тот же аккаунт в интеграциях Instagram Директ и Instagram Комментарии, то source.id и saId будут различаться, а identifier - совпадет. Нужен для автоопределения канала в случае ответа в директ из комментариев, когда в системе подклчючено несколько Instagram Директ интеграций. |
Возможные типы интеграций:
- fb_group - группа Facebook
- fb_messenger - мессенджер Facebook
- instagramV2 - Instagram direct
- instagramVOff - комментарии Instagram
- vk_personal - личные сообщения Vkontakte
- vk_group - группа Vkontakte
- telebot - Telegram-бот
- whatsapp - Whatsapp
- whatsapp2 - Whatsapp Enterprise
- widget - виджет «Umnico»
Пример:
GET https://api.umnico.com/v1.3/integrations
Response:
[
{
"id": 75,
"type": "whatsapp",
"login": "79123456789",
"avatar": "https://pps.whatsapp.net/8785475420670656512.jpg",
"externalId": "79123456789",
"status": "active",
"url": "https://wa.me/79123456789"
},
{
"id": 13,
"type": "vk_personal",
"login": "User Test",
"avatar": "https://pp.userapi.com/jfMWGs8.jpg",
"externalId": "14327180",
"status": "auth failure",
"url": "https://vk.com/id14327180"
}
]
Получить список сопоставлений идентификаторов пользователей Umnico и пользователей интеграции¶
Внимание
Работает только для интеграций с AmoCRM и «Мой склад».
GET /v1.3/integrations/<integration-id>/mappings/users
- integration-id - идентификатор интеграции в Umnico
После успешного выполнения возвращается объект, где ключ соответствует идентификатору пользователя внешней системы, а значение соответствует идентификатору пользователя в Umnico.
user-id-in-integration: user-id-in-umnico | integer | Сопоставление идентификаторов пользователей внешней системы и пользователей Umnico |
default | integer | Идентификатор владельца аккаунта в Umnico |
Пример:
GET https://api.umnico.com/v1.3/integrations/7/mappings/users
Response:
{
"3389846": 1,
"3385134": 2,
"default": 1
}