API-токены

API-токен открывает программный доступ к вашему кабинету APX Chat. С его помощью внешние сервисы и ваши скрипты могут работать с данными платформы через API — например, получать диалоги, создавать сделки или управлять клиентами.

Где найти

Откройте Управление → API токены. Здесь можно создать новый токен, посмотреть существующие и отозвать те, что больше не нужны.

Как создать токен

  1. Откройте раздел

    Перейдите в Управление → API токены и нажмите «Создать токен».

  2. Назовите токен

    Дайте понятное название — например, «Интеграция с сайтом» или «Синхронизация заказов». Так вы поймёте, где он используется.

  3. Выберите права (scope)

    Ограничьте токен только теми правами, которые реально нужны интеграции.

  4. Скопируйте и сохраните

    Скопируйте токен сразу после создания и сохраните в надёжном месте — повторно полное значение может не показываться.

Права доступа (scope)

Scope определяет, что разрешено делать с токеном. Принцип тот же, что и с правами сотрудников: выдавайте минимально необходимый набор. Если интеграции нужно только читать диалоги — не давайте ей право на изменение данных.

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

Подробное техническое описание методов API и работы с токенами доступно в документации для разработчиков: /docs/api-tokens.

Отзыв токена

Если токен больше не нужен или скомпрометирован, удалите его в том же разделе. После отзыва запросы с этим токеном перестают работать сразу.