Skip to main content
POST
cURL
Необходим 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. Аналитика — на основе переданных метаданных строятся отчеты и фильтры

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

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

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

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

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

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

Пример

Правильно:

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

  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 для загрузки в него файла и работой с этим файлом в дальнейшем