AISARAISAR

Быстрый старт

Подключитесь к AISAR API за пять минут: создайте токен и выполните первый запрос.

AISAR API — это REST-интерфейс вашей рабочей области AISAR: диалоги, контакты, каналы, сделки, воронки, рассылки и шаблоны сообщений. Через него внешние системы (CRM, AI-ассистенты, ваши бэкенды) могут читать данные компании и отправлять сообщения от имени подключённых каналов, а через вебхуки — получать события в реальном времени.

API доступен на тарифе Business (фича api). На более младших тарифах запросы с API-токеном будут отклонены с ошибкой 403 «Feature not available on your plan».

Базовый URL

Все запросы REST API выполняются на:

text
https://api.aisar.app/v1

Шаг 1 — создайте API-токен

В кабинете компании перейдите в Настройки → Системы → API и создайте новый токен. При создании AISAR автоматически заводит служебный сервисный аккаунт, привязанный к вашей компании, и выпускает для него Bearer-токен — он показывается один раз, сразу скопируйте его.

Токен даёт доступ ко всей рабочей области компании (сервисный аккаунт получает роль администратора). Храните его как пароль и не встраивайте в клиентский код.

Шаг 2 — первый запрос

Проверьте токен запросом к GET /v1/me — он возвращает профиль сервисного аккаунта и текущую компанию:

Запрос
curl https://api.aisar.app/v1/me \
  -H "Authorization: Bearer YOUR_API_TOKEN"
Ответ
{
  "data": {
    "id": 123,
    "name": "API token",
    "email": "api-01hz...@service.aisar.app",
    "current_company_id": 45,
    "roles": ["admin"]
  }
}

Дальше можно получить список диалогов компании:

Список диалогов
curl https://api.aisar.app/v1/conversations \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Шаг 3 — куда дальше

  • Раздел «Аутентификация» — заголовок Bearer-токена, управление токенами, лимиты запросов и обработка ошибок 401/429.
  • Справочник REST — все группы эндпоинтов: диалоги, сообщения, контакты, каналы, шаблоны, сделки, воронки, рассылки и другие.
  • Раздел «Вебхуки» — как подписаться на события и проверить подпись доставки.
  • Сценарий «Отправка сообщений из вашей системы» — пошаговый пример интеграции: найти контакт, выбрать канал, отправить текст или шаблон.
  • Раздел «MCP-серверы» — как подключить AI-агента к вашей рабочей области AISAR тем же API-токеном.