Skip to main content
POST
/
item-set
cURL
curl -X POST 'https://api.spellit.ai/api/item-set' \
  -H 'API-Access-Key: your_api_key' \
  -H 'Content-Type: application/json' \
  -d '{"name":"Название звонка","project_id":123,"processing_parameters":{"COMPANY":"Название компании","extra_processing_data":{"crm_data":{"call_date":"YYYY-MM-DD","crm_data_2":"600","crm_data_3":123}}}}'
{
  "id": 123,
  "name": "name_a0d142",
  "permitted_types": null,
  "date_creation": null,
  "date_last_update": null,
  "id_project": 123,
  "status": "added",
  "status_project": null,
  "id_base_user": 1,
  "id_item_set_processing_metadata": null,
  "processing_outputs": null
}
Необходим project_id из предыдущего шага.
Запомните id созданного item_set.

Authorizations

​
API-Access-Key
string
header
required

API-ключ для доступа к эндпоинтам

Body

application/json

Структура запроса для создания набора элементов (Item Set), связанного с проектом.

​
name
string
required

Название набора элементов. Используется для идентификации внутри проекта.

​
project_id
integer
required

ID проекта, к которому относится этот Item Set. За ID проекта обращайтесь к команде Spellit.

​
processing_parameters.COMPANY
string

Название компании, от имени которой производится обработка.

​
processing_parameters.extra_processing_data
object

Дополнительные данные, необходимые для бизнес-логики обработки.

​
processing_parameters.extra_processing_data.crm_data
object

crm_data — это набор метаданных из CRM или других источников, который передается вместе с каждым звонком для построения детализированной аналитики. Эти данные позволяют фильтровать отчеты и получать различные срезы аналитики по вашим звонкам.

Как это работает

  1. Настройка проекта — при создании проекта определяется структура полей crm_data
  2. Отправка данных — при каждом создании item-set поля заполняются данными по конкретному звонку
  3. Аналитика — на основе переданных метаданных строятся отчеты и фильтры

Стандартные поля Вот эти поля, как правило, используют наши клиенты:

"crm_data": {
    "call_date": "Дата звонка",
    "crm_data_2": "Длительность (СЕК)",
    "crm_data_3": "ID звонка",
    "crm_data_4": "Телефон",
    "crm_data_5": "Источник",
    "crm_data_6": "Время звонка",
    "crm_data_7": "Тип звонка",
    "crm_data_8": "Номер недели",
    "crm_data_9": "ID контакта",
    "crm_data_10": "ФИО контакта",
    "crm_data_11": "Тип контакта",
    "crm_data_12": "Дата создания сделки",
    "crm_data_13": "ID сделки",
    "crm_data_14": "Название сделки",
    "crm_data_15": "Воронка сделки",
    "crm_data_16": "Бюджет сделки",
    "crm_data_17": "Этап сделки",
    "crm_data_18": "Ссылка на сделку",
    "crm_data_19": "ID менеджера",
    "crm_data_20": "ФИО менеджера",
    "crm_data_21": "резерв_1",
    "crm_data_22": "резерв_2",
    "crm_data_23": "резерв_3",
    "crm_data_24": "резерв_4",
    "crm_data_25": "резерв_5"
  }

⚠️ Важно: Дата звонка всегда должна отправляться с ключом call_date

Кастомизация полей Вы не ограничены стандартным набором полей. SpellitAI поддерживает:

  • Любое количество полей — технических ограничений нет
  • Любые названия полей — используйте удобные для вас ключи
  • Специфичные для бизнеса поля — добавляйте данные, важные именно для вашей аналитики

Резервные поля Если стандартного набора недостаточно, используйте резервные поля (crm_data_21 - crm_data_25) или обратитесь к команде SpellitAI для создания индивидуальной структуры.

Формат данных

Тип данныхФорматПримеры
Числовые значенияБез кавычек1060, 1966074090
Текстовые данныеВ кавычках"CallGear", "Входящий"
ДатыВ кавычках"2025-08-19"
ВремяВ кавычках"08:26:20"
ТелефоныВ кавычках"+79157778899"

Пример

✅ Правильно:

"crm_data": {
    "call_date": "2025-08-19",
    "crm_data_2": 1060,
    "crm_data_3": 1966074090,
    "crm_data_4": "+79157778899",
    "crm_data_5": "CallGear",
    "crm_data_6": "08:26:20"
  }

Начало работы

  1. Определите структуру полей Выберите и утвердите список полей, которые будете отправлять. Это критически важно для корректной работы аналитики.

  2. Отправьте тестовый звонок Передайте первый тестовый звонок с частью полей, чтобы убедиться в правильности интеграции.

  3. Получите поддержку По вопросам интеграции обращайтесь к команде SpellitAI — процесс интеграции простой и не займет много времени!

​
processing_parameters.extra_processing_data.crm_data.call_date
string

Значение из CRM-поля 'Дата звонка'.

​
processing_parameters.extra_processing_data_crm_data.crm_data_2
string

Значение из CRM-поля 'Длительность (СЕК)'.

Response

Успешное создание Item Set

​
id
integer

Используем ID созданного item_set для загрузки в него файла и работой с этим файлом в дальнейшем