> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spellit.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Часто задаваемые вопросы

> Ответы на популярные вопросы о SpellitAI API

<AccordionGroup>
  <Accordion title="1. Сколько времени занимает обработка запросов?">
    Время обработки зависит от типа операции:

    * **Получение ответа API** — быстрое выполнение (обычно в течение нескольких секунд)
    * **Загрузка и обработка звонка** — может занять продолжительное время в зависимости от размера и длительности аудиофайла
  </Accordion>

  <Accordion title="2. Какие HTTP коды может возвращать API?">
    API возвращает стандартные HTTP коды ответов:

    * **200** — успешное выполнение запроса
    * **400** — неверные параметры запроса
    * **401** — ошибка аутентификации
    * **422** – ошибка валидации данных:
      * отсутствие полей required\_fields или crm\_data
      * отсутствие стандартных обязательных полей
      * некорректная структура запроса и прочие расхождения
    * **500** — внутренняя ошибка сервера

    **При получении кода 500** рекомендуется обратиться в службу поддержки команды SpellitAI для диагностики и решения проблемы.
  </Accordion>

  <Accordion title="3. Как быть с дублями?">
    Наша система принимает все данные, которые в неё отправляются, и начинает анализ. Фильтрация данных происходит на стороне клиента. Чтобы избежать повторного анализа одного и того же звонка, необходимо перед отправкой реализовать проверку: был ли этот звонок уже отправлен ранее в данный проект.

    **Важно:** отправка этого же звонка в другой проект является другим анализом, поэтому дублем не является.
  </Accordion>

  <Accordion title="4. Какие фильтры могут быть у звонков перед отправкой?">
    Не все звонки нужно анализировать. Какие фильтры для отбора звонков применять перед их отправкой на анализ — зависит от критериев анализа и является бизнесовой, а не технической задачей.

    Обычно у наших клиентов используются следующие фильтры:

    * **Воронка** — звонки из какой воронки в CRM анализируем
    * **Этапы воронки** — звонки каких этапов анализируем
    * **Тип звонка** — входящий / исходящий / оба
    * **Менеджеры** — по всем менеджерам берём звонки или только по конкретным
    * **Минимальная длительность** — от какой длины звонки берём в анализ

    **Рекомендация:** не рекомендуется брать звонки менее 5 минут для детального анализа (например, по 40 критериям). Как правило, в таких звонках содержится мало полезной информации, и в них просто нечего анализировать по большому количеству критериев.
  </Accordion>

  <Accordion title="5. Что делать, если звонок привязан сразу к нескольким сделкам? Какую crm_data передавать?">
    Для spellit.ai единицей исследования является звонок. Вся отправленная информация должна привязываться к звонку. К какой сделке прикреплён звонок — по той сделке и следует отправлять поля; какой менеджер совершил звонок — по тому и следует отправлять поля и т.д.

    Однако бывает, что один звонок прикреплён сразу к нескольким сделкам. В таком случае рекомендуется реализовывать следующую логику: **отправляем данные той сделки, которая является последней по дате создания по этому контакту**.
  </Accordion>

  <Accordion title="6. Какие существуют сценарии отправки звонков на анализ в рамках интеграции?">
    Существует 2 сценария отправки звонков:

    **Сценарий 1: «Отправка в режиме реального времени» (базовый)**

    Автоматическая отправка по веб-хуку появления звонка. Звонок появился — проверяем, подходит ли он под фильтры бизнеса (минимальная длительность, нужный этап воронки, менеджер и т.д.). Далее вместе с CRM-полями звонок отправляется в spellit.ai.

    **Сценарий 2: «Исторический анализ»**

    Отправка вручную. Указываются даты начала и конца периода анализа. Все звонки, которые были совершены в этот период, подходят под фильтры бизнеса и ещё не были проанализированы в рамках данного проекта, отправляются в spellit.ai на анализ.

    **Важно:** не стоит отправлять звонок сразу после появления в CRM. Необходимо дать время на загрузку файла этого звонка из телефонии в CRM. Поэтому забирайте звонок с задержкой после его появления. В зависимости от CRM, телефонии и длительности звонка, задержка может составлять от 2 минут до 1 часа.
  </Accordion>
</AccordionGroup>