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

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

За несколько минут вы создадите API-ключ, получите список проектов и запустите первый исходящий звонок через публичный REST API MAIA.

Базовый URL API: https://api.maia-ai.com

Шаг 1. Создать API-ключ

  1. Войдите в кабинет dashboard.maia-ai.com.
  2. Откройте раздел API и MCP → вкладка API → Создать ключ.
  3. Выберите права (scopes): read — чтение, write — запуск звонков.
  4. Скопируйте ключ. Он показывается один раз — сохраните его в надёжном месте.

Ключ имеет вид maia_ВАШ_КЛЮЧ и передаётся в каждом запросе одним из двух заголовков:

X-API-Key: maia_ВАШ_КЛЮЧ
Authorization: Bearer maia_ВАШ_КЛЮЧ

Шаг 2. Первый запрос — список проектов

Проверим ключ и получим список ваших проектов (нужен scope read):

curl https://api.maia-ai.com/v1/public/projects \
  -H "X-API-Key: maia_ВАШ_КЛЮЧ"

Пример ответа:

[
  {
    "id": "3f8a1c2e-0b44-4e7a-9d11-7c2e5b6a90ff",
    "name": "Отдел продаж",
    "status": "active"
  }
]

Скопируйте id нужного проекта — он понадобится для запуска звонка.

Шаг 3. Запустить исходящий звонок

Отправьте POST /v1/public/calls с project_id и телефоном получателя (нужен scope write):

curl -X POST https://api.maia-ai.com/v1/public/calls \
  -H "X-API-Key: maia_ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{
    "project_id": "3f8a1c2e-0b44-4e7a-9d11-7c2e5b6a90ff",
    "phone": "+79991234567",
    "task": "Подтвердить запись на завтра в 15:00",
    "vars": { "client_name": "Иван" }
  }'

Поля task и vars необязательны. Перед запуском проверяются владение проектом, активная подписка и баланс (≥ цены минуты).

Пример ответа:

{
  "id": "a1b2c3d4-5e6f-7081-9a2b-3c4d5e6f7081",
  "status": "queued"
}

Шаг 4. Проверить статус звонка

Запросите детали звонка по его id (scope read):

curl https://api.maia-ai.com/v1/public/calls/a1b2c3d4-5e6f-7081-9a2b-3c4d5e6f7081 \
  -H "X-API-Key: maia_ВАШ_КЛЮЧ"

В ответе придут статус, длительность, транскрипт и ссылка на запись (по мере готовности звонка).

Что дальше

ВведениеАутентификация