Долгосрочный токен для публичных виджетов

С виджетами и интеграциями в amoCRM иногда возникают проблемы с авторизацией по API, когда выданные доступы к виджетам и интеграциям пропадают или дублируются.
Это приводит к нарушению работы виджетов и необходимости повторной выдачи доступов, что не всегда можно сделать оперативно. И это вызывает большие неудобства.

В связи с этим мы предлагаем использовать долгосрочный токен для интеграции, что позволит избежать подобных инцидентов и обеспечить стабильную работу виджетов.

Внимание!
Данное решение не распространяется на виджеты: "Интеграция amoCRM и WhatsApp", "BlaBlaChat", "BlaBlaChat: Telegram Personal" и "BlaBlaChat: Telegram (+групповые чаты)" в связи с техническими ограничениями.

Создание долгосрочного токена

Долгосрочный токен можно получить при помощи создания новой внешней интеграции. И этот токен будет использоваться для авторизации в нужной интеграции.

Для того, чтобы создать внешнюю интеграцию и получить долгосрочный токен необходимо:

Перейти в amoМаркет в левом меню.

По клику на троеточие в правом верхнем углу, выбрать пункт контекстного меню "Создать интеграцию".

Нажать кнопку "Создать" напротив варианта "Внешняя интеграция".

Важно!
Внешняя интеграция в отличие от приватной не требует у Вас согласия на установку приватных интеграций и не лишает технической поддержки amoCRM.

Заполнить данные интеграции:

В пункте предоставить доступ выбрать "Все".
В названии необходимо указать название публичного виджета Генезис, к которому хотите выдать долгосрочный токен.
В описании можете написать “Долгосрочный токен для публичного виджета” или указать текст по своему усмотрению.

В наименовании интеграции рекомендуется указывать такое же наименование, что и в исходной интеграции. В дальнейшем это наименование будет использоваться для указания инициатора действий в истории сделки и других сущностей.

Для разных публичных виджетов рекомендуем создавать свою внешнюю интеграцию, чтобы у них были разные названия, по которым можно было бы в истории сущностей видеть инициатора действия.

Предоставляемый доступ влияет на то, к каким данным будет иметь доступ интеграция, некорректный выбор может повлиять на корректную работу интеграции

В созданной интеграции перейти на вкладку "Ключи и доступы" и в пункте "Долгосрочный токен" нажать кнопку "Сгенерировать токен".

Выбрать дату истечения токена и нажать кнопку "Подтвердить".

Важно!
Рекомендуем указывать максимально возможный срок действия токена - это 5 лет от текущей даты.

После этого можно будет скопировать долгосрочный токен из соответствующего пункта на вкладке "Ключи и доступы" в созданной интеграции.

Важно!
После генерации этого токена и копирования больше он доступен не будет, поэтому следует убедиться, что он скопировался. В следующий раз придётся сгенерировать токен заново.

Полученный токен необходимо вставить в выпадающее окно в настройках публичного виджета Генезис, нажав на кнопку "Долгосрочный токен". Если в кнопке появилась иконка с зелёной галочкой, значит токен установлен успешно.

В случае, когда необходимость в долгосрочном токене отпала, его можно удалить, нажав на иконку корзинки. В случае удаления токена, авторизация в интеграции снова будет зависеть от выданных доступов.

В случае, если токен дискредитирован, его можно просто заменить на новый, сгенерировав его заново во внешней интеграции.

После этих действий виджет будет авторизовываться в API через публичную интеграцию, поэтому если выданные доступы пропали или задублировались - это не будет влиять на работу интеграции.

Тех.поддержка Telegram