Что это
Calls API работает с записями звонков: названием, временем, продолжительностью, статусом и заметкой. Запись можно связать с контактом или другим объектом CRM.
Это не сервис совершения звонков и не модель распознавания речи. Ссылка на запись, расшифровка и сводка могут поступать из другой системы. ИИ-анализ требует отдельного шага и проверки сотрудником.
Ключевые параметры
- Категория: Инструменты разработчика
- Сложность: Для разработчика
- Запуск: Около 30 минут
- Open-source: Нет
- Данные: Не известно
- Чувствительные данные: Только с настройками
Сильные стороны
- Связывает сведения о звонке с историей клиента.
- Позволяет читать выбранные свойства без полной ручной выгрузки.
- Поддерживает создание и изменение записей звонков интеграцией.
Ограничения
- Не совершает звонки и не распознает аудио самостоятельно.
- Заметка, статус и время зависят от качества переданных данных.
- При повторной записи интеграция должна сама предотвращать дубли.
Как использовать
1. Подготовка. В учебном аккаунте найдите одну запись звонка без реальных телефонов и сохраните ее ID. Первый тест должен только читать данные.
2. Настройка. Получите разрешенный токен приложения, проверьте требуемые scopes и сохраните токен как секрет HTTP-клиента. Используйте Authorization: Bearer.
3. Первый результат. Выполните GET https://api.hubapi.com/crm/v3/objects/calls/{callId}?properties=hs_call_title,hs_call_status,hs_call_duration, указав ID учебной записи.
4. Проверка. Сравните название и статус с CRM; длительность передается в миллисекундах. Пустое свойство не заменяйте догадкой. Перед записью добавьте проверку повторов и обработку отказов API.
Доступ и оплата
- Модель оплаты: Не уточнено
- Работа в РФ: Нужно проверять
- VPN: Не известно
- Русский интерфейс: Не известно
- Русский язык: Не известно
Проверьте доступ конкретного аккаунта и лимиты нужного метода. Наличие API не делает платный продукт бесплатным. Секреты храните на сервере, а не в браузерном коде.
Когда не подходит
- Использовать вместо оператора телефонии
- Считать наличие recording URL готовой расшифровкой
- Публиковать записи разговоров без разрешения
Альтернативы
HubSpot CRM API работает с другими объектами CRM. Aircall API и Twilio Voice API относятся к телефонии и имеют другие функции; они не заменяют хранение звонка в HubSpot.