Токены доступа
Как создать токен API, выбрать права и отключить доступ интеграции
Токен — это ключ, с которым внешняя система обращается к А5Клиент API. Для каждой интеграции удобно создавать отдельный токен: так проще понять, где он используется, и отключить только нужное подключение.
Как создать токен
Укажите название
Откройте «А5Клиент API» в боковом меню. В блоке «Создание токена» заполните «Название токена», например «Интеграция с CRM».
Выберите права
«Чтение (read)» включено всегда: интеграция сможет получать доступные через API данные.
«Запись (write)» разрешает действия, например отправку сообщений и изменение вебхуков. Эта галочка изначально стоит. Снимите её, если интеграции нужно только читать данные.
Создайте и сохраните токен
Нажмите «Создать токен». На странице появится полный токен — скопируйте его целиком и сохраните в настройках интеграции.
Токен показывается один раз
После ухода со страницы полный токен нельзя будет посмотреть повторно. Если Вы его не сохранили, создайте новый, а ненужный отзовите. Храните токен как пароль и не публикуйте его в документах или скриншотах.
Как проверить использование
В блоке «Активные токены» показаны название, права, дата создания и «Последнее использование». Прочерк вместо даты использования означает, что оно ещё не зафиксировано.
Под названием указаны права messenger:read и, если разрешена запись, messenger:write. В столбце «Начало токена» виден только его идентификатор с многоточием — для подключения этого недостаточно.
Как отозвать или заменить токен
Найдите токен по названию, нажмите «Отозвать» и подтвердите действие. Интеграция больше не сможет обращаться к API с этим токеном.
Если нужно поменять права или заменить токен, сначала создайте новый и укажите его в интеграции. После проверки подключения отзовите старый. Если токен попал к посторонним, отзовите его сразу.
Если подключение не работает
Проверьте, что доступ к API включён, токен скопирован целиком и не отозван. Если чтение работает, а отправка сообщений — нет, проверьте право «Запись (write)».