Интеграция Sipuni
Как подключить телефонию Sipuni для автоматического анализа звонков
Интеграция Sipuni
Sipuni — популярная SIP-телефония для бизнеса. Подключи интеграцию — и звонки будут автоматически анализироваться сразу после завершения.
Как это работает (TL;DR)
Звонок завершается в Sipuni → Webhook отправляет данные → Мы загружаем запись → AI анализирует → Отчет готов
Звонки появляются в системе через 1-2 минуты после завершения.
Что понадобится
- Аккаунт Sipuni с правами администратора
- Включенная запись разговоров
- 10-15 минут на настройку
Пошаговая настройка
Шаг 1: Найди API ключ в Sipuni
- Зайди в личный кабинет Sipuni
- Открой Настройки → API
- Если ключа нет — создай новый
- Скопируй API ключ (длинная строка букв и цифр)
Где искать: Настройки → API → Ключ APIЕсли раздела API нет — проверь права доступа. Нужны права администратора.
Шаг 2: Найди User ID
User ID — это твой идентификатор в Sipuni. Обычно он находится:
- В том же разделе Настройки → API
- Или в Профиль → Информация об аккаунте
User ID — это число (например, 12345). Не путай с email или логином.
Шаг 3: Настрой интеграцию в CallMeAI
- Открой Интеграции
- Найди карточку Sipuni → нажми «Настроить»
- Заполни форму:
| Поле | Что вводить |
|---|---|
| API ключ | Ключ из личного кабинета Sipuni |
| User ID | Твой числовой идентификатор |
| Папка критериев | Выбери, по каким критериям анализировать |
- Нажми «Сохранить»
Шаг 4: Настрой webhook в Sipuni
Теперь нужно сказать Sipuni, куда отправлять данные о звонках.
- В личном кабинете Sipuni открой Настройки → Webhooks
- Создай новый webhook
- Укажи URL:
https://callmeai.ru/api/sipuni/webhook
- Выбери события:
- ✅ Завершение звонка (обязательно)
- Сохрани
Важно: URL должен быть именно такой. Если ты используешь свой домен — замени
callmeai.ru на свой.Шаг 5: Проверь, что всё работает
- Позвони с телефона, подключенного к Sipuni
- Поговори минуту-две (короткие звонки могут не записываться)
- Заверши звонок
- Подожди 2-3 минуты
- Проверь Банк звонков — там должен появиться новый звонок
Если звонок появился — поздравляю, интеграция работает!
Настройка фильтров
После базовой настройки можно добавить фильтры — чтобы не анализировать все подряд.
Доступные фильтры:
| Фильтр | Что делает |
|---|---|
| Минимальная длительность | Отсеивает короткие звонки (например, меньше 2 минут) |
| Максимальная длительность | Отсеивает слишком длинные звонки |
| Направление | Только входящие, только исходящие или все |
| Рабочие часы | Анализировать только в определенное время |
Подробнее: Фильтры интеграций
Что может пойти не так
Звонки не появляются
Прошло 10 минут, но звонка нетПроверь по порядку:
- API ключ правильный? Скопируй заново из Sipuni
- User ID правильный? Это должно быть число, не email
- Webhook настроен? Проверь URL в Sipuni
- Запись включена? Без записи нечего анализировать
- Есть минуты на балансе? Проверь в профиле ::
Webhook возвращает ошибку
Ошибка 401 или 403Проблема с авторизацией. Перепроверь API ключ и User ID — скорее всего, опечатка.
Ошибка 500Проблема на нашей стороне. Подожди 5-10 минут и попробуй снова. Если не помогло — напиши в поддержку.
Ошибка «URL недоступен»Проверь, что URL указан правильно:
https://callmeai.ru/api/sipuni/webhookЗвонки приходят с задержкой
Звонки появляются через 5-10 минутНебольшая задержка — это нормально. Sipuni сначала сохраняет запись, потом отправляет webhook. Если задержка больше 10 минут — проверь настройки.
Дублирование звонков
Один звонок появляется дваждыСкорее всего, настроено два webhook на один URL. Проверь настройки в Sipuni — должен быть только один webhook.
Неправильная длительность
Длительность не совпадает с реальнойSipuni передает длительность записи, а не разговора. Если запись начинается раньше или заканчивается позже — будет расхождение. Это не влияет на анализ.
Частые вопросы
Можно анализировать старые звонки?
Нет, интеграция работает только с новыми звонками. Старые записи загрузи вручную через Загрузку.Как временно отключить интеграцию?
Открой настройки интеграции и нажми переключатель «Отключить». Webhook останется, но звонки не будут анализироваться.Что будет, если сменить API ключ в Sipuni?
Интеграция перестанет работать. Нужно обновить ключ в настройках CallMeAI.Можно подключить несколько аккаунтов Sipuni?
Пока нет. Один аккаунт Sipuni — одна интеграция.Анализируются ли внутренние звонки?
По умолчанию — нет. Sipuni обычно не отправляет webhook для внутренних звонков. Если хочешь их анализировать — проверь настройки webhook в Sipuni.Что дальше?
- Настрой фильтры — чтобы не анализировать все подряд
- Добавь менеджеров — для статистики по каждому
- Посмотри аналитику — тренды и KPI команды