Внешний API

Префикс /api/external. Заголовок Authorization: Bearer ad_test_… или ad_live_…. Ключ выпускается в кабинете администратором компании (вкладка «API и агенты»). Публичное демо ключи не выдаёт.

Чтение

GET /directory/employees|groups|schedules|questions
POST /assistant/chat — диалог ассистента
GET /assistant/jobs/{job_id}

Запись только после confirm

Разбор смешанного текста не меняет справочник. Мутация создаёт заявку, исполнение — отдельный confirm (тот же принцип, что MRTR в MCP).

curl -s https://allo-director.ru/api/external/directory/employees \
  -H "Authorization: Bearer ad_test_…"

curl -s -X POST https://allo-director.ru/api/external/import/parse-mixed \
  -H "Authorization: Bearer ad_test_…" \
  -H "Content-Type: application/json" \
  -d '{"raw_text":"Иванов Иван +79001234567 продажи"}'

curl -s -X POST https://allo-director.ru/api/external/mutations \
  -H "Authorization: Bearer ad_live_…" \
  -H "Content-Type: application/json" \
  -d '{"kind":"create","payload":{"entity_type":"employees","rows":[{"full_name":"Иванов Иван","phone_number":"+79001234567"}]}}'

curl -s -X POST https://allo-director.ru/api/external/mutations/MUTATION_ID/confirm \
  -H "Authorization: Bearer ad_live_…"