Что это
CRM API позволяет читать и изменять объекты HubSpot, работать с их свойствами и связями. Например, интеграция может получить сведения о контакте перед подготовкой ответа сотруднику.
API не понимает бизнес-задачу как языковая модель и не определяет достоверность ее выводов. Для агента это инструмент доступа к данным. Разделите чтение и запись, проверяйте типы полей и подтверждайте важные изменения.
Ключевые параметры
- Категория: Инструменты разработчика
- Сложность: Для разработчика
- Запуск: Около 30 минут
- Open-source: Нет
- Данные: Не известно
- Чувствительные данные: Только с настройками
Сильные стороны
- Дает программный доступ к CRM без ручного копирования.
- Позволяет запрашивать нужные свойства и связи записей.
- Поддерживает получение списка по страницам для контролируемой синхронизации.
Ограничения
- Права и доступность объектов зависят от аккаунта и приложения.
- Повторная запись может создать дубль без вашей проверки идентификатора.
- Внутренние имена свойств не обязательно совпадают с подписями интерфейса.
Как использовать
1. Подготовка. Создайте вымышленный контакт и сохраните его Record ID. Решите, какие два поля нужны для первого чтения.
2. Настройка. Настройте приложение с crm.objects.contacts.read. Храните токен в секретах, передавайте его как Bearer и не включайте права записи для первого теста.
3. Первый результат. Выполните GET https://api.hubapi.com/crm/v3/objects/contacts/{recordId}?properties=firstname,lastname и получите имя учебного контакта.
4. Проверка. Сверьте ID и свойства с CRM. Для списков учитывайте paging и after. Перед изменением записей отдельно проверьте права, формат свойств, дубли и поведение при отказе API.
Доступ и оплата
- Модель оплаты: Не уточнено
- Работа в РФ: Нужно проверять
- VPN: Не известно
- Русский интерфейс: Не известно
- Русский язык: Не известно
Проверьте доступ конкретного аккаунта и лимиты нужного метода. Наличие API не делает платный продукт бесплатным. Секреты храните на сервере, а не в браузерном коде.
Когда не подходит
- Выдать модели неограниченную запись
- Отправлять всю клиентскую базу в сторонний чат
- Подменять права приложения промптом
Альтернативы
Bitrix24 REST API, amoCRM API и Pipedrive API решают подобные задачи в своих CRM. Они не читают вашу базу HubSpot без миграции или синхронизации.
