API и токен доступа

Для обращений к API Kulpunai нужен персональный токен доступа.

Где найти токен

1. Нажмите на аватар в боковой панели.
2. Выберите Настройки профиля.
3. Найдите раздел с токеном доступа.
4. Скопируйте значение.

Использование

Токен передаётся в заголовке api_access_token:

curl -H "api_access_token: ВАШ_ТОКЕН" https://online.kulpunai.com/api/v1/accounts/1/conversations

Идентификатор аккаунта виден в адресной строке панели управления.

Что можно делать через API

• Получать и создавать диалоги;
• Отправлять сообщения;
• Управлять контактами;
• Читать отчётные данные.

Канал API

Для собственных интеграций удобно создать источник типа API: сообщения в него отправляются запросами, а операторы отвечают в общем интерфейсе. Источник создаётся в Настройки → Источники → Добавить источник.

Безопасность

• Токен даёт полный доступ к вашему аккаунту — обращайтесь с ним как с паролем.
• Не размещайте токен в коде сайта и в публичных репозиториях: он должен использоваться только на сервере.
• Храните токен в переменных окружения.
• При подозрении на утечку пересоздайте токен и обновите его во всех интеграциях — старый перестанет работать сразу.