HubSpot
Взаимодействие с HubSpot CRM или запуск рабочих процессов из событий HubSpot
HubSpot — это комплексная CRM-платформа, предоставляющая полный набор инструментов для маркетинга, продаж и обслуживания клиентов, помогающая бизнесам расти. Благодаря мощным возможностям автоматизации и обширному API, HubSpot обслуживает компании всех размеров в различных отраслях.
С интеграцией HubSpot в AACFlow вы можете:
- Управлять контактами: Просматривать, получать, создавать, обновлять и искать контакты в вашей CRM
- Управлять компаниями: Просматривать, получать, создавать, обновлять и искать записи о компаниях
- Отслеживать сделки: Просматривать сделки в вашей воронке продаж
- Получать доступ к пользователям: Извлекать информацию о пользователях из вашей учетной записи HubSpot
В AACFlow интеграция с HubSpot позволяет вашим агентам взаимодействовать с данными вашей CRM в рамках автоматизированных рабочих процессов. Агенты могут квалифицировать лиды, обогащать записи контактов, отслеживать сделки и синхронизировать данные по всему вашему технологическому стеку — обеспечивая интеллектуальную автоматизацию продаж и маркетинга.
Интегрируйте HubSpot в ваш рабочий процесс. Управляйте контактами, компаниями, сделками, тикетами и другими объектами CRM с помощью мощных возможностей автоматизации. Может использоваться в режиме триггера для запуска рабочих процессов при создании, удалении или обновлении контактов.
Получить всех пользователей из учетной записи HubSpot
| Параметр | Тип | Обязательный | Описание |
|---|
limit | string | Нет | Количество результатов для возврата (по умолчанию: 100, максимум: 100) |
after | string | Нет | Курсор пагинации для следующей страницы результатов (из предыдущего ответа) |
| Параметр | Тип | Описание |
|---|
users | array | Массив объектов пользователей HubSpot |
↳ id | string | ID пользователя |
↳ email | string | Адрес электронной почты пользователя |
↳ roleId | string | ID роли пользователя |
↳ primaryTeamId | string | ID основной команды |
↳ secondaryTeamIds | array | ID дополнительных команд |
↳ superAdmin | boolean | Является ли пользователь супер-администратором |
paging | object | Информация о пагинации для получения дополнительных результатов |
↳ after | string | Курсор для следующей страницы результатов |
↳ link | string | Ссылка на следующую страницу |
totalItems | number | Общее количество возвращенных пользователей |
success | boolean | Статус успешности операции |
Получить все контакты из учетной записи HubSpot с поддержкой пагинации
| Параметр | Тип | Обязательный | Описание |
|---|
limit | string | Нет | Максимальное количество результатов на страницу (макс. 100, по умолчанию 100) |
after | string | Нет | Курсор пагинации для следующей страницы результатов (из предыдущего ответа) |
properties | string | Нет | Список имен свойств HubSpot, разделенных запятыми, для возврата (например, "email,firstname,lastname,phone") |
associations | string | Нет | Список типов объектов, разделенных запятыми, для получения связанных ID (например, "companies,deals") |
| Параметр | Тип | Описание |
|---|
contacts | array | Массив записей контактов HubSpot |
↳ email | string | Адрес электронной почты контакта |
↳ firstname | string | Имя контакта |
↳ lastname | string | Фамилия контакта |
↳ phone | string | Номер телефона контакта |
↳ mobilephone | string | Номер мобильного телефона контакта |
↳ company | string | Название связанной компании |
↳ website | string | URL веб-сайта контакта |
↳ jobtitle | string | Должность контакта |
↳ lifecyclestage | string | Этап жизненного цикла (подписчик, лид, маркетингово-квалифицированный лид, продажно-квалифицированный лид, возможность, клиент) |
↳ hubspot_owner_id | string | ID владельца HubSpot |
↳ hs_object_id | string | ID объекта HubSpot (тот же, что и ID записи) |
↳ createdate | string | Дата создания контакта (ISO 8601) |
↳ lastmodifieddate | string | Дата последнего изменения (ISO 8601) |
↳ address | string | Улица и дом |
↳ city | string | Город |
↳ state | string | Штат/Регион |
↳ zip | string | Почтовый/ZIP-код |
↳ country | string | Страна |
↳ fax | string | Номер факса |
↳ hs_timezone | string | Часовой пояс контакта |
paging | object | Информация о пагинации для получения дополнительных результатов |
↳ after | string | Курсор для следующей страницы результатов |
↳ link | string | Ссылка на следующую страницу |
metadata | object | Метаданные ответа |
↳ totalReturned | number | Количество записей, возвращенных в этом ответе |
↳ hasMore | boolean | Доступны ли дополнительные записи |
success | boolean | Статус успешности операции |
Получить один контакт по ID или email из HubSpot
| Параметр | Тип | Обязательный | Описание |
|---|
contactId | string | Да | ID контакта HubSpot (числовая строка) или адрес электронной почты для получения |
idProperty | string | Нет | Свойство, используемое в качестве уникального идентификатора (например, "email"). Если не указано, используется ID записи |
properties | string | Нет | Список имен свойств HubSpot, разделенных запятыми, для возврата (например, "email,firstname,lastname,phone") |
associations | string | Нет | Список типов объектов, разделенных запятыми, для получения связанных ID (например, "companies,deals") |
| Параметр | Тип | Описание |
|---|
contact | object | Запись контакта HubSpot |
↳ email | string | Адрес электронной почты контакта |
↳ firstname | string | Имя контакта |
↳ lastname | string | Фамилия контакта |
↳ phone | string | Номер телефона контакта |
↳ mobilephone | string | Номер мобильного телефона контакта |
↳ company | string | Название связанной компании |
↳ website | string | URL веб-сайта контакта |
↳ jobtitle | string | Должность контакта |
↳ lifecyclestage | string | Этап жизненного цикла (подписчик, лид, маркетингово-квалифицированный лид, продажно-квалифицированный лид, возможность, клиент) |
↳ hubspot_owner_id | string | ID владельца HubSpot |
↳ hs_object_id | string | ID объекта HubSpot (тот же, что и ID записи) |
↳ createdate | string | Дата создания контакта (ISO 8601) |
↳ lastmodifieddate | string | Дата последнего изменения (ISO 8601) |
↳ address | string | Улица и дом |
↳ city | string | Город |
↳ state | string | Штат/Регион |
↳ zip | string | Почтовый/ZIP-код |
↳ country | string | Страна |
↳ fax | string | Номер факса |
↳ hs_timezone | string | Часовой пояс контакта |
contactId | string | Полученный ID контакта |
success | boolean | Статус успешности операции |
Создать новый контакт в HubSpot. Требуется хотя бы одно из: email, firstname или lastname
| Параметр | Тип | Обязательный | Описание |
|---|
properties | object | Да | Свойства контакта в виде объекта JSON. Должно включать хотя бы одно из: email, firstname или lastname (например, {"email": "john@example.com", "firstname": "John", "lastname": "Doe"}) |
associations | array | Нет | Массив ассоциаций для создания с контактом в формате JSON. Каждый объект должен иметь "to.id" (ID компании/сделки) и массив "types" с "associationCategory" и "associationTypeId" |
| Параметр | Тип | Описание |
|---|
contact | object | Запись контакта HubSpot |
↳ email | string | Адрес электронной почты контакта |
↳ firstname | string | Имя контакта |
↳ lastname | string | Фамилия контакта |
↳ phone | string | Номер телефона контакта |
↳ mobilephone | string | Номер мобильного телефона контакта |
↳ company | string | Название связанной компании |
↳ website | string | URL веб-сайта контакта |
↳ jobtitle | string | Должность контакта |
↳ lifecyclestage | string | Этап жизненного цикла (подписчик, лид, маркетингово-квалифицированный лид, продажно-квалифицированный лид, возможность, клиент) |
↳ hubspot_owner_id | string | ID владельца HubSpot |
↳ hs_object_id | string | ID объекта HubSpot (тот же, что и ID записи) |
↳ createdate | string | Дата создания контакта (ISO 8601) |
↳ lastmodifieddate | string | Дата последнего изменения (ISO 8601) |
↳ address | string | Улица и дом |
↳ city | string | Город |
↳ state | string | Штат/Регион |
↳ zip | string | Почтовый/ZIP-код |
↳ country | string | Страна |
↳ fax | string | Номер факса |
↳ hs_timezone | string | Часовой пояс контакта |
contactId | string | Созданный ID контакта |
success | boolean | Статус успешности операции |
Обновить существующий контакт в HubSpot по ID или email
| Параметр | Тип | Обязательный | Описание |
|---|
contactId | string | Да | ID контакта HubSpot (числовая строка) или email контакта для обновления |
idProperty | string | Нет | Свойство, используемое в качестве уникального идентификатора (например, "email"). Если не указано, используется ID записи |
properties | object | Да | Свойства контакта для обновления в виде объекта JSON (например, {"firstname": "John", "phone": "+1234567890"}) |
| Параметр | Тип | Описание |
|---|
contact | object | Запись контакта HubSpot |
↳ email | string | Адрес электронной почты контакта |
↳ firstname | string | Имя контакта |
↳ lastname | string | Фамилия контакта |
↳ phone | string | Номер телефона контакта |
↳ mobilephone | string | Номер мобильного телефона контакта |
↳ company | string | Название связанной компании |
↳ website | string | URL веб-сайта контакта |
↳ jobtitle | string | Должность контакта |
↳ lifecyclestage | string | Этап жизненного цикла (подписчик, лид, маркетингово-квалифицированный лид, продажно-квалифицированный лид, возможность, клиент) |
↳ hubspot_owner_id | string | ID владельца HubSpot |
↳ hs_object_id | string | ID объекта HubSpot (тот же, что и ID записи) |
↳ createdate | string | Дата создания контакта (ISO 8601) |
↳ lastmodifieddate | string | Дата последнего изменения (ISO 8601) |
↳ address | string | Улица и дом |
↳ city | string | Город |
↳ state | string | Штат/Регион |
↳ zip | string | Почтовый/ZIP-код |
↳ country | string | Страна |
↳ fax | string | Номер факса |
↳ hs_timezone | string | Часовой пояс контакта |
contactId | string | Обновленный ID контакта |
success | boolean | Статус успешности операции |
Искать контакты в HubSpot с использованием фильтров, сортировки и запросов
| Параметр | Тип | Обязательный | Описание |
|---|
filterGroups | array | Нет | Массив групп фильтров в формате JSON. Каждая группа содержит массив "filters" с объектами, имеющими "propertyName", "operator" (например, "EQ", "CONTAINS_TOKEN", "GT") и "value" |
sorts | array | Нет | Массив объектов сортировки в формате JSON с "propertyName" и "direction" ("ASCENDING" или "DESCENDING") |
query | string | Нет | Строка поискового запроса для сопоставления с именем контакта, email и другими текстовыми полями |
properties | array | Нет | Массив имен свойств HubSpot для возврата (например, ["email", "firstname", "lastname", "phone"]) |
limit | number | Нет | Максимальное количество результатов для возврата (макс. 100) |
after | string | Нет | Курсор пагинации для следующей страницы (из предыдущего ответа) |
| Параметр | Тип | Описание |
|---|
contacts | array | Массив записей контактов HubSpot |
↳ email | string | Адрес электронной почты контакта |
↳ firstname | string | Имя контакта |
↳ lastname | string | Фамилия контакта |
↳ phone | string | Номер телефона контакта |
↳ mobilephone | string | Номер мобильного телефона контакта |
↳ company | string | Название связанной компании |
↳ website | string | URL веб-сайта контакта |
↳ jobtitle | string | Должность контакта |
↳ lifecyclestage | string | Этап жизненного цикла (подписчик, лид, маркетингово-квалифицированный лид, продажно-квалифицированный лид, возможность, клиент) |
↳ hubspot_owner_id | string | ID владельца HubSpot |
↳ hs_object_id | string | ID объекта HubSpot (тот же, что и ID записи) |
↳ createdate | string | Дата создания контакта (ISO 8601) |
↳ lastmodifieddate | string | Дата последнего изменения (ISO 8601) |
↳ address | string | Улица и дом |
↳ city | string | Город |
↳ state | string | Штат/Регион |
↳ zip | string | Почтовый/ZIP-код |
↳ country | string | Страна |
↳ fax | string | Номер факса |
↳ hs_timezone | string | Часовой пояс контакта |
paging | object | Информация о пагинации для получения дополнительных результатов |
↳ after | string | Курсор для следующей страницы результатов |
↳ link | string | Ссылка на следующую страницу |
metadata | object | Метаданные ответа |
↳ totalReturned | number | Количество записей, возвращенных в этом ответе |
↳ hasMore | boolean | Доступны ли дополнительные записи |
total | number | Общее количество соответствующих контактов |
success | boolean | Статус успешности операции |
Получить все компании из учетной записи HubSpot с поддержкой пагинации
| Параметр | Тип | Обязательный | Описание |
|---|
limit | string | Нет | Максимальное количество результатов на страницу (макс. 100, по умолчанию 100) |
after | string | Нет | Курсор пагинации для следующей страницы результатов (из предыдущего ответа) |
properties | string | Нет | Список имен свойств HubSpot, разделенных запятыми, для возврата (например, "name,domain,industry") |
associations | string | Нет | Список типов объектов, разделенных запятыми, для получения связанных ID (например, "contacts,deals") |
| Параметр | Тип | Описание |
|---|
companies | array | Массив записей компаний HubSpot |
↳ name | string | Название компании |
↳ domain | string | Домен веб-сайта компании (уникальный идентификатор) |
↳ description | string | Описание компании |
↳ industry | string | Тип отрасли (например, Авиалинии/Авиация) |
↳ phone | string | Номер телефона компании |
↳ city | string | Город |
↳ state | string | Штат/Регион |
↳ zip | string | Почтовый/ZIP-код |
↳ country | string | Страна |
↳ address | string | Улица и дом |
↳ numberofemployees | string | Общее количество сотрудников |
↳ annualrevenue | string | Оценка годового дохода |
↳ lifecyclestage | string | Этап жизненного цикла |
↳ hubspot_owner_id | string | ID владельца HubSpot |
↳ hs_object_id | string | ID объекта HubSpot (тот же, что и ID записи) |
↳ hs_createdate | string | Дата создания компании (ISO 8601) |
↳ hs_lastmodifieddate | string | Дата последнего изменения (ISO 8601) |
↳ hs_additional_domains | string | Дополнительные домены (разделенные точкой с запятой) |
↳ num_associated_contacts | string | Количество связанных контактов (автоматически обновляется) |
↳ num_associated_deals | string | Количество связанных сделок (автоматически обновляется) |
↳ website | string | URL веб-сайта компании |
paging | object | Информация о пагинации для получения дополнительных результатов |
↳ after | string | Курсор для следующей страницы результатов |
↳ link | string | Ссылка на следующую страницу |
metadata | object | Метаданные ответа |
↳ totalReturned | number | Количество записей, возвращенных в этом ответе |
↳ hasMore | boolean | Доступны ли дополнительные записи |
success | boolean | Статус успешности операции |
Получить одну компанию по ID или домену из HubSpot
| Параметр | Тип | Обязательный | Описание |
|---|
companyId | string | Да | ID компании HubSpot (числовая строка) или домен для получения |
idProperty | string | Нет | Свойство, используемое в качестве уникального идентификатора (например, "domain"). Если не указано, используется ID записи |
properties | string | Нет | Список имен свойств HubSpot, разделенных запятыми, для возврата (например, "name,domain,industry") |
associations | string | Нет | Список типов объектов, разделенных запятыми, для получения связанных ID (например, "contacts,deals") |
| Параметр | Тип | Описание |
|---|
company | object | Запись компании HubSpot |
↳ name | string | Название компании |
↳ domain | string | Домен веб-сайта компании (уникальный идентификатор) |
↳ description | string | Описание компании |
↳ industry | string | Тип отрасли (например, Авиалинии/Авиация) |
↳ phone | string | Номер телефона компании |
↳ city | string | Город |
↳ state | string | Штат/Регион |
↳ zip | string | Почтовый/ZIP-код |
↳ country | string | Страна |
↳ address | string | Улица и дом |
↳ numberofemployees | string | Общее количество сотрудников |
↳ annualrevenue | string | Оценка годового дохода |
↳ lifecyclestage | string | Этап жизненного цикла |
↳ hubspot_owner_id | string | ID владельца HubSpot |
↳ hs_object_id | string | ID объекта HubSpot (тот же, что и ID записи) |
↳ hs_createdate | string | Дата создания компании (ISO 8601) |
↳ hs_lastmodifieddate | string | Дата последнего изменения (ISO 8601) |
↳ hs_additional_domains | string | Дополнительные домены (разделенные точкой с запятой) |
↳ num_associated_contacts | string | Количество связанных контактов (автоматически обновляется) |
↳ num_associated_deals | string | Количество связанных сделок (автоматически обновляется) |
↳ website | string | URL веб-сайта компании |
companyId | string | Полученный ID компании |
success | boolean | Статус успешности операции |
Создать новую компанию в HubSpot
| Параметр | Тип | Обязательный | Описание |
|---|
properties | object | Да | Свойства компании в виде объекта JSON (например, {"name": "Acme Inc", "domain": "acme.com", "industry": "Technology"}) |
associations | array | Нет | Массив ассоциаций для создания с компанией в формате JSON (каждая с "to.id" и "types", содержащими "associationCategory" и "associationTypeId") |
| Параметр | Тип | Описание |
|---|
company | object | Запись компании HubSpot |
↳ name | string | Название компании |
↳ domain | string | Домен веб-сайта компании (уникальный идентификатор) |
↳ description | string | Описание компании |
↳ industry | string | Тип отрасли (например, Авиалинии/Авиация) |
↳ phone | string | Номер телефона компании |
↳ city | string | Город |
↳ state | string | Штат/Регион |
↳ zip | string | Почтовый/ZIP-код |
↳ country | string | Страна |
↳ address | string | Улица и дом |
↳ numberofemployees | string | Общее количество сотрудников |
↳ annualrevenue | string | Оценка годового дохода |
↳ lifecyclestage | string | Этап жизненного цикла |
↳ hubspot_owner_id | string | ID владельца HubSpot |
↳ hs_object_id | string | ID объекта HubSpot (тот же, что и ID записи) |
↳ hs_createdate | string | Дата создания компании (ISO 8601) |
↳ hs_lastmodifieddate | string | Дата последнего изменения (ISO 8601) |
↳ hs_additional_domains | string | Дополнительные домены (разделенные точкой с запятой) |
