Инструкция · CRM
Подключение HubSpot
Sendalto читает контакты и компании из HubSpot по сервисному ключу. Ваши записи о согласии остаются главными, а отписка в HubSpot только добавляет ограничение.
Сверено с Sendalto
1. Создайте сервисный ключ в HubSpot
- В HubSpot откройте Development, затем в левом меню Keys → Service keys и нажмите Create service key. Создавать ключи могут суперадминистраторы и пользователи с правом Developer tools access.
- Введите название, нажмите Add new scope, отметьте
crm.objects.contacts.readиcrm.objects.companies.readи нажмите Update. - Только если будете передавать контакты обратно в HubSpot с заметкой: добавьте
crm.objects.contacts.write, а чтобы назначать владельца в HubSpot —crm.objects.owners.read. Эти права HubSpot указывает для заметок и владельцев; проверка подключения в Sendalto проверяет только два права на чтение. - Нажмите Create и подтвердите. Откройте ключ, нажмите Show, затем Copy.
Уже подключились по токену private app? Он продолжает работать: HubSpot сообщает, что существующие приложения этого типа пока не затронуты. Убирается только создание новых — с 28 сентября 2026 года для аккаунтов HubSpot, созданных с этой даты, и с 26 октября 2026 года для остальных (журнал изменений HubSpot).
2. Подключите его в Sendalto
- Откройте «Настройки → Интеграции» и нажмите «Настроить» у HubSpot.
- Вставьте ключ в поле токена. Не включайте «CRM владеет именем…», если поля профиля в Sendalto должны оставаться главными; передачу обратно включайте, только если добавили права на запись.
- Сохраните и нажмите «Проверить подключение»: Sendalto прочитает один контакт и одну компанию, чтобы убедиться, что оба права на чтение работают.
- Нажимайте «Синхронизировать CRM», когда нужны свежие данные. Синхронизация запускается вручную, по расписанию она не идёт.
Что синхронизируется
| HubSpot | Sendalto |
|---|---|
email контакта | По нему находится контакт. Синхронизация его не меняет: если адрес в HubSpot изменился, запись пропускается как конфликт. |
firstname, lastname, company, country | Поля профиля. Значения, уже записанные в Sendalto, остаются, если не включено владение CRM. |
lifecyclestage, hs_lead_status | Статус в CRM; по умолчанию им владеет HubSpot. |
| Основная компания контакта | Связь контакта с компанией. |
name, domain, country, lifecyclestage компании | Компании; находятся по ID в HubSpot, затем по домену. |
hs_email_optout | См. отписки ниже. |
- Архивные и пропавшие записи HubSpot ничего не удаляют в Sendalto.
- Новые для Sendalto контакты приходят с основанием «неизвестно»: маркетинговые письма им не уходят, пока согласие не задокументировано.
- Каждый изменённый контакт создаёт событие
crm.contact.changed, а изменённая компания — событиеcrm.company.changedдля каждого связанного контакта. Их могут использовать сценарии и вебхуки.
Отписки
Если hs_email_optout равно true, Sendalto добавляет адрес в список «не писать» для всех писем, отмечает активный контакт как отписавшийся и отменяет его письма в очереди. Следующая синхронизация это ограничение не снимает: HubSpot может добавлять отписки, но не отменять их. Согласие, статус и исключения хранятся в Sendalto.
Необязательно: передача контакта обратно в HubSpot
Если передача обратно включена, владелец или администратор может передать синхронизированный контакт в HubSpot из «Настройки → Интеграции»: Sendalto проверит, что адрес контакта в HubSpot не изменился, при желании назначит указанного владельца в HubSpot и добавит к контакту вашу заметку. Автоматически ничего не записывается.