Skip to main content
Время обработки зависит от типа операции:
  • Получение ответа API — быстрое выполнение (обычно в течение нескольких секунд)
  • Загрузка и обработка звонка — может занять продолжительное время в зависимости от размера и длительности аудиофайла
API возвращает стандартные HTTP коды ответов:
  • 200 — успешное выполнение запроса
  • 400 — неверные параметры запроса
  • 401 — ошибка аутентификации
  • 422 — ошибка валидации данных
  • 500 — внутренняя ошибка сервера
При получении кода 500 рекомендуется обратиться в службу поддержки команды SpellitAI для диагностики и решения проблемы.
Наша система принимает все данные, которые в неё отправляются, и начинает анализ. Фильтрация данных происходит на стороне клиента. Чтобы избежать повторного анализа одного и того же звонка, необходимо перед отправкой реализовать проверку: был ли этот звонок уже отправлен ранее в данный проект.Важно: отправка этого же звонка в другой проект является другим анализом, поэтому дублем не является.
Не все звонки нужно анализировать. Какие фильтры для отбора звонков применять перед их отправкой на анализ — зависит от критериев анализа и является бизнесовой, а не технической задачей.Обычно у наших клиентов используются следующие фильтры:
  • Воронка — звонки из какой воронки в CRM анализируем
  • Этапы воронки — звонки каких этапов анализируем
  • Тип звонка — входящий / исходящий / оба
  • Менеджеры — по всем менеджерам берём звонки или только по конкретным
  • Минимальная длительность — от какой длины звонки берём в анализ
Рекомендация: не рекомендуется брать звонки менее 5 минут для детального анализа (например, по 40 критериям). Как правило, в таких звонках содержится мало полезной информации, и в них просто нечего анализировать по большому количеству критериев.
Для spellit.ai единицей исследования является звонок. Вся отправленная информация должна привязываться к звонку. К какой сделке прикреплён звонок — по той сделке и следует отправлять поля; какой менеджер совершил звонок — по тому и следует отправлять поля и т.д.Однако бывает, что один звонок прикреплён сразу к нескольким сделкам. В таком случае рекомендуется реализовывать следующую логику: отправляем данные той сделки, которая является последней по дате создания по этому контакту.
Существует 2 сценария отправки звонков:Сценарий 1: «Отправка в режиме реального времени» (базовый)Автоматическая отправка по веб-хуку появления звонка. Звонок появился — проверяем, подходит ли он под фильтры бизнеса (минимальная длительность, нужный этап воронки, менеджер и т.д.). Далее вместе с CRM-полями звонок отправляется в spellit.ai.Сценарий 2: «Исторический анализ»Отправка вручную. Указываются даты начала и конца периода анализа. Все звонки, которые были совершены в этот период, подходят под фильтры бизнеса и ещё не были проанализированы в рамках данного проекта, отправляются в spellit.ai на анализ.Важно: не стоит отправлять звонок сразу после появления в CRM. Необходимо дать время на загрузку файла этого звонка из телефонии в CRM. Поэтому забирайте звонок с задержкой после его появления. В зависимости от CRM, телефонии и длительности звонка, задержка может составлять от 2 минут до 1 часа.