OAuth Setup

NeuroCall Co-Pilot использует OAuth 2.0 для аутентификации API-запросов. Этот протокол обеспечивает безопасный доступ без передачи паролей.

Получение доступа

Создайте приложение

Зарегистрируйте приложение в панели разработчика NeuroCall:

Войдите в ваш аккаунт Co-Pilot
Перейдите в раздел "API & Интеграции"
Нажмите "Создать приложение"
Заполните информацию о приложении
Получите Client ID и Client Secret

Важно

Client Secret показывается только один раз при создании. Сохраните его в надежном месте. При утере потребуется генерация нового секрета.

Настройте redirect URI

Укажите URL, на который пользователь будет перенаправлен после авторизации. Можно указать до 5 URI.

Процесс авторизации

Перенаправьте пользователя

Отправьте пользователя на URL авторизации:

http

GET https://api.neurocall.ai/oauth/authorize?
  response_type=code&
  client_id=YOUR_CLIENT_ID&
  redirect_uri=YOUR_REDIRECT_URI&
  scope=deals,contacts,tasks&
  state=RANDOM_STATE

Обменяйте код на токен

После авторизации пользователь будет перенаправлен на ваш redirect_uri с кодом:

http

POST https://api.neurocall.ai/oauth/token
Content-Type: application/x-www-form-urlencoded

grant_type=authorization_code&
code=AUTH_CODE&
client_id=YOUR_CLIENT_ID&
client_secret=YOUR_CLIENT_SECRET&
redirect_uri=YOUR_REDIRECT_URI

В ответ получите access_token и refresh_token:

json

{
  "access_token": "eyJhbGciOiJIUzI1NiIs...",
  "token_type": "Bearer",
  "expires_in": 3600,
  "refresh_token": "dGhpcyBpcyBhIHJlZnJlc2g...",
  "scope": "deals contacts tasks"
}

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

Передавайте access_token в заголовке Authorization:

http

GET https://api.neurocall.ai/v1/deals
Authorization: Bearer eyJhbGciOiJIUzI1NiIs...

Обновление токена

Access token действителен 1 час. Для обновления используйте refresh_token:

http

POST https://api.neurocall.ai/oauth/token
Content-Type: application/x-www-form-urlencoded

grant_type=refresh_token&
refresh_token=dGhpcyBpcyBhIHJlZnJlc2g...&
client_id=YOUR_CLIENT_ID&
client_secret=YOUR_CLIENT_SECRET

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

Храните refresh_token максимально безопасно. При компрометации отозовите токен через панель управления.

Области доступа (Scopes)

Scope	Описание
`deals`	Доступ к сделкам
`contacts`	Доступ к контактам и компаниям
`tasks`	Доступ к задачам
`scenarios`	Управление сценариями
`agents`	Управление AI-агентами
`analytics`	Доступ к аналитике
`webhooks`	Управление вебхуками