Интеграции

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

GET /v1.3/integrations

После успешного выполнения возвращается массив объектов, описывающих интеграции.

id integer Идентификатор интеграции
type string Тип подключенной интеграции
login string Логин в мессенджере или название аккаунта в социальной сети
avatar string Аватар аккаунта в мессенджере или социальной сети
externalId string Идентификатор подключенного аккаунта в мессенджере или социальной сети
status string Статус подключенной интеграции

Возможные типы интеграций:

  • 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"
    },
    {
        "id": 13,
        "type": "vk_personal",
        "login": "User Test",
        "avatar": "https://pp.userapi.com/jfMWGs8.jpg",
        "externalId": "14327180",
        "status": "auth failure"
    }
]

Получить список сопоставлений идентификаторов пользователей 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
}