Исходная обновляемая документация в Confluence
Интеграция с hubspot CRM реализована как нативная интеграция. Ее можно подключить в старом личном кабинете в разделе Аккаунт- Интеграции. Подробнее о самой интеграции можно прочитать здесь. Однако, эта интеграция не позволяет передавать дополнительные поля в CRM систему. Рассмотрим ниже, как можно передать дополнительные поля (например, передачу меток таких как UTM source, UTM media, UTM term, etc), используя возможности нового marketplace. Текущая реализация marketplace не имеет пользовательской обертки и предназначена для внутреннего использования. Интеграция настраивается для каждого клиента индивидуально, что позволяет реализовать гибкую интеграцию с учетом кейсов конкретного клиента. Для подключения нового маркетплейса необходимо иметь компоненты для работы с Data API и Call API.
Подключение Marketplace клиенту описано в следующем разделе.
Сперва необходимо ввести учетные данные для входа в Hubspot CRM, которые затем будут использоваться в интеграции для обмена данными с CRM-системой клиента.
Реквизиты добавляются в интерфейсе "Credentials". Подробнее про добавление и редактирование учетных данных можно узнать здесь.
На форме добавления реквизитов выбираем type "OAuth2 API" и заполняем следующие данные:
Name - название учетных данных;
Client ID - идентификатор клиента. Тут используются наш id разработчика, его можно найти здесь.
Client secret - пароль клиента. Тут используются наш id разработчика, его можно найти здесь.
Scope - это разделенный пробелами набор областей, к которым потребуется доступ. Например:
oauth tickets [crm.objects.contacts.read](https://docs.uiscom.ru/pages/crm.objects.contacts.read) [crm.objects.contacts.write](https://docs.uiscom.ru/pages/crm.objects.contacts.write) [crm.objects.companies.write](https://docs.uiscom.ru/pages/crm.objects.companies.write) [crm.objects.companies.read](https://docs.uiscom.ru/pages/crm.objects.companies.read) [crm.objects.deals.read](https://docs.uiscom.ru/pages/crm.objects.deals.read) [crm.objects.deals.write](https://docs.uiscom.ru/pages/crm.objects.deals.write) [crm.objects.owners.read](https://docs.uiscom.ru/pages/crm.objects.owners.read%C2%A0)
Authorisation URL - адрес авторизации, для Hubspot CRM это https://app.hubspot.com/oauth/authorize
Token URL - адрес токена, для Hubspot CRM это https://api.hubapi.com/oauth/v1/token
Token auth method - метод аутентификации токена. Выбираем client_secret_post.
Token placement - размещение токена. Выбираем header.
Token prefix - префикс токена. Оставляем Bearer.