Интеграции

Получить список всех интеграций аккаунта

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
}