> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# HubSpot

> Подключите HubSpot к YCloud для синхронизации контактных данных, управления переписками в WhatsApp и отправки шаблонных сообщений из рабочих процессов.

Подключите HubSpot к YCloud, чтобы вести переписки в WhatsApp прямо рядом с контактами вашей CRM. Настройте интеграцию один раз, а затем выберите функции, необходимые вашей команде.

## Возможности интеграции

* Синхронизация выбранных данных контактов из YCloud в HubSpot.
* Синхронизация изменений ответственных за контакты между YCloud и HubSpot.
* Просмотр выбранных данных контакта HubSpot во входящих сообщениях (Inbox) YCloud.
* Открытие YCloud Inbox из карточки контакта в HubSpot для просмотра и ведения переписок в WhatsApp.
* Сохранение подходящих личных переписок WhatsApp на таймлайне контакта в HubSpot.
* Отправка шаблонов WhatsApp через рабочие процессы HubSpot.

Эта интеграция доступна на тарифах YCloud Pro и Enterprise. Со стороны HubSpot отдельный платный план для самой интеграции не требуется. Однако в вашем аккаунте HubSpot должны быть права и функции, необходимые для выполнения нужных действий.

## Подключение HubSpot

1. В YCloud перейдите в раздел **Интеграции** и выберите **HubSpot**.
2. Пройдите авторизацию HubSpot, чтобы подключить свой аккаунт.
3. Вернитесь в YCloud и проверьте обновленный статус подключения HubSpot.

После подключения настройте параметры для вашего рабочего процесса: сопоставление полей контактов, сопоставление ответственных и данные контакта HubSpot, отображаемые в YCloud Inbox. Проверьте эти настройки перед отправкой сообщений или включением синхронизации таймлайна.

<Frame caption="Select Install on the HubSpot card to begin connecting your account.">
  <img src="https://mintcdn.com/lchnan/gXEJIQXV2JH2VUQJ/product-assets/english-help-2026-09-22/hubspot-install-annotated.svg?fit=max&auto=format&n=gXEJIQXV2JH2VUQJ&q=85&s=9322bd8661d7f321ce6ca990ab44bdcf" alt="Раздел интеграций YCloud с выделенной кнопкой установки HubSpot." width="3024" height="1656" data-path="product-assets/english-help-2026-09-22/hubspot-install-annotated.svg" />
</Frame>

<Frame caption="HubSpot account authorization completed.">
  ![Подтверждение от YCloud об успешной авторизации аккаунта HubSpot.](https://helpdocs.ycloud.com/help-center/~gitbook/image?url=https%3A%2F%2F3466127247-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FSIAnjLP6KQY5rvyuaq5K%252Fuploads%252F46j40CgyjUEXYPytsjhK%252Fimage.png%3Falt%3Dmedia%26token%3D8c87b55c-6cf9-4f19-9950-94c3ea19c15f\&width=768\&dpr=3\&quality=100\&sign=86aa1a41\&sv=2)
</Frame>

## Синхронизация контактов и ответственных

Используйте сопоставление полей контактов, чтобы выбрать, какие данные контактов YCloud синхронизирует с HubSpot. Система поддерживает неизменную связку между **Contact ID** и `ycloud_contact_id`; это сопоставление нельзя изменить или удалить.

<Frame caption="Choose the contact fields to sync from YCloud to HubSpot.">
  <img src="https://mintcdn.com/lchnan/UKK7skidHuzhIWsx/product-assets/english-help-2026-09-30/hubspot-contact-field-mapping.png?fit=max&auto=format&n=UKK7skidHuzhIWsx&q=85&s=e25d115936d06a9537f015dbdebd75ff" alt="Настройка HubSpot в YCloud с сопоставлением полей Contact ID и номера телефона." width="2766" height="1704" data-path="product-assets/english-help-2026-09-30/hubspot-contact-field-mapping.png" />
</Frame>

Контакты без номера телефона поддерживаются при наличии действительного идентификатора отправки WhatsApp. Если номер телефона указан, используется он. Если номер телефона добавляется позже, YCloud обновляет соответствующий контакт в HubSpot, не создавая новый.

<Frame caption="Map YCloud users to their corresponding HubSpot owners.">
  <img src="https://mintcdn.com/lchnan/UKK7skidHuzhIWsx/product-assets/english-help-2026-09-30/hubspot-owner-mapping.png?fit=max&auto=format&n=UKK7skidHuzhIWsx&q=85&s=ef57938e9c0e494f0f644081c11f67d2" alt="Настройка HubSpot в YCloud с сопоставлением пользователей YCloud и ответственных в HubSpot." width="1598" height="984" data-path="product-assets/english-help-2026-09-30/hubspot-owner-mapping.png" />
</Frame>

Ответственные за контакт могут синхронизироваться в обоих направлениях. Изменение ответственного в HubSpot обновляет ответственного за контакт в YCloud. Чтобы передавать изменения ответственного из YCloud в HubSpot, настройте сопоставление пользователей между двумя системами. YCloud должен определить одного действительного ответственного и сопоставить его с HubSpot. Если это невозможно, поле ответственного пропускается, а остальные сопоставленные данные продолжают синхронизироваться. Удаление ответственного за контакт в YCloud сбрасывает соответствующего ответственного в HubSpot.

<Frame caption="Choose the HubSpot properties to display in YCloud Inbox.">
  <img src="https://mintcdn.com/lchnan/UKK7skidHuzhIWsx/product-assets/english-help-2026-09-30/hubspot-inbox-properties.png?fit=max&auto=format&n=UKK7skidHuzhIWsx&q=85&s=ebcd3598c977bcb5b1dbd84faee6b841" alt="Настройка HubSpot в YCloud с выбранными свойствами HubSpot и предварительным просмотром Inbox." width="2766" height="1704" data-path="product-assets/english-help-2026-09-30/hubspot-inbox-properties.png" />
</Frame>

Ответственность за контакт и назначение диалогов в Inbox работают независимо. Смена ответственного в HubSpot обновляет ответственного за контакт в YCloud, однако распределение диалогов в YCloud Inbox определяется правилами маршрутизации для бизнес-номера.

## Просмотр данных HubSpot в YCloud Inbox

Вы можете настроить показ данных контакта из HubSpot в блоке сведений о контакте в YCloud Inbox. Это предоставит операторам контекст из HubSpot во время работы в YCloud без необходимости превращать каждое свойство HubSpot в поле YCloud.

Это отличается от открытия YCloud Inbox внутри интерфейса HubSpot: в данном случае вы работаете в YCloud и просматриваете сведения из HubSpot рядом с контактом.

## Чат внутри HubSpot

<Frame>
  <img src="https://mintcdn.com/lchnan/RfSYb7ZcxYbORFyj/images/hubspot-entrance-inbox.png?fit=max&auto=format&n=RfSYb7ZcxYbORFyj&q=85&s=e3909cc00d8ff43f14b6830d23c72550" alt="Страница контакта в HubSpot с кнопкой входа в YCloud Inbox." width="2878" height="1624" data-path="images/hubspot-entrance-inbox.png" />
</Frame>

Из карточки контакта в HubSpot можно открыть встроенный YCloud Inbox для просмотра и ведения переписок WhatsApp с этим контактом без перехода в отдельный интерфейс YCloud. Для контактов без номера телефона эта возможность также доступна при наличии действительного идентификатора отправки WhatsApp.

Встроенный Inbox не поддерживает совершение и прием звонков. Распределение диалогов по-прежнему подчиняется правилам маршрутизации для бизнес-номера; смена ответственного за контакт в HubSpot не гарантирует передачу текущей переписки этому сотруднику.

## Синхронизация переписок с таймлайном

<Frame caption="Turn on HubSpot Timeline Activity to sync WhatsApp messages to HubSpot.">
  <img src="https://mintcdn.com/lchnan/UKK7skidHuzhIWsx/product-assets/english-help-2026-09-30/hubspot-timeline-activity.png?fit=max&auto=format&n=UKK7skidHuzhIWsx&q=85&s=5ee3da73c5af8d7b69ee9ce368291984" alt="Страница сведений HubSpot в YCloud с выделенной настройкой HubSpot Timeline Activity." width="1597" height="985" data-path="product-assets/english-help-2026-09-30/hubspot-timeline-activity.png" />
</Frame>

Включите опцию **HubSpot Timeline Activity** , чтобы сохранять подходящие личные сообщения WhatsApp на таймлайне соответствующего контакта в HubSpot. Для интеграции требуется активная авторизация HubSpot и сопоставленный контакт HubSpot.

<Frame>
  <img src="https://mintcdn.com/lchnan/RfSYb7ZcxYbORFyj/images/hubspot-contact-timeline-2.png?fit=max&auto=format&n=RfSYb7ZcxYbORFyj&q=85&s=7bf3761c4610e04185a08b30eea6feee" alt="История переписки WhatsApp на таймлайне контакта в HubSpot." width="1584" height="993" data-path="images/hubspot-contact-timeline-2.png" />
</Frame>

Синхронизация таймлайна начинается с сообщений, отправленных или полученных после последнего включения функции. Сообщения, созданные до включения или в период отключения, задним числом не добавляются. Групповые чаты, записи звонков, Flows, ответы на Flow, системные сообщения и сообщения SMPP не синхронизируются.

Синхронизированные сообщения привязываются к одному контакту HubSpot и одному бизнес-номеру WhatsApp. Текст отображается как читаемый контент диалога. Медиафайлы и сложные типы сообщений отображаются в виде текста или плейсхолдеров типа контента; YCloud не загружает медиафайлы и не воссоздает полный интерфейс WhatsApp внутри HubSpot.

Если запись не появляется, убедитесь, что параметр Timeline Activity был включен до создания сообщения, авторизация HubSpot активна, контакт сопоставлен, а само сообщение входит в поддерживаемый диапазон.

## Отправка шаблонов из рабочих процессов

1. Добавьте действие шаблона YCloud WhatsApp в рабочий процесс HubSpot.
2. Настройте рабочий номер отправителя, получателя, утвержденный шаблон, язык и обязательные переменные шаблона.
3. Используйте тестовый контакт, к которому у вас есть доступ, чтобы проверить сообщение перед активацией рабочего процесса для клиентов.

Для контакта без номера телефона по-прежнему требуется действительный идентификатор отправки WhatsApp. Если вы не можете найти действие YCloud или сообщение не отправляется, проверьте подключение HubSpot, свои разрешения и включенные функции в HubSpot, номер отправителя и статус шаблона.

<Frame caption="Configure the YCloud WhatsApp template action in a HubSpot workflow.">
  <img src="https://mintcdn.com/lchnan/zF5bhBnzwSZkZsSr/product-assets/remote-3ce7786162-img-v3-02vl-ac7c3e56-de78-415f-a57b-.jpg?fit=max&auto=format&n=zF5bhBnzwSZkZsSr&q=85&s=f6a3b8f42c214c3cc0c7b99f357dcbd0" alt="Редактор рабочих процессов HubSpot с действием шаблона YCloud WhatsApp и настройками отправителя, получателя, шаблона и языка." width="2994" height="1496" data-path="product-assets/remote-3ce7786162-img-v3-02vl-ac7c3e56-de78-415f-a57b-.jpg" />
</Frame>

## Часто задаваемые вопросы

<Accordion title="Какие тарифные планы YCloud поддерживают интеграцию с HubSpot?">
  Интеграция с HubSpot доступна на тарифах YCloud Pro и Enterprise.
</Accordion>

<Accordion title="Почему не синхронизируется владелец контакта?">
  Для изменений, внесенных в YCloud, проверьте, что у контакта назначен один действительный владелец и что этот владелец сопоставлен с владельцем в HubSpot. Если хотя бы одно из условий не выполнено, YCloud пропускает поле владельца, при этом остальные сопоставленные данные контакта продолжают синхронизироваться. Эта синхронизация не заполняет историю предыдущих назначений владельцев и не разрешает конфликты при одновременном редактировании владельца в обеих системах.
</Accordion>

<Accordion title="Переназначает ли смена владельца в HubSpot диалог в YCloud Inbox?">
  Не обязательно. Изменения владельца синхронизируются с владельцем контакта в YCloud. Назначение диалогов в Inbox происходит в соответствии с правилами распределения для конкретного рабочего номера.
</Accordion>

<Accordion title="Почему сообщение WhatsApp отсутствует на таймлайне HubSpot?">
  Убедитесь, что параметр Timeline Activity уже был включен на момент создания сообщения, авторизация HubSpot активна, контакт сопоставлен, а само сообщение является поддерживаемым индивидуальным (one-to-one) сообщением.
</Accordion>

<Accordion title="Что произойдет при отключении HubSpot?">
  При отключении удаляются авторизация HubSpot, сопоставления владельцев, настройки отображения контактов и сопоставления полей контактов, сохраненные в YCloud. После повторного подключения вам потребуется проверить и настроить эти параметры заново.
</Accordion>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.