1. Перед началом
- Аккаунт LetsBot. Можно начать с бесплатного пробного периода (14 дн.) без банковской карты.
- Номер WhatsApp Business, подключённый в LetsBot: сообщения отправляются через официальный WhatsApp Business API.
- Аккаунт HubSpot с правом устанавливать приложения (администратор аккаунта).
- Корректные номера телефонов в международном формате у контактов HubSpot, чтобы приложение могло определить получателя.
2. Установите приложение и подключите HubSpot
Подключение выполняется через OAuth HubSpot. Вам никогда не придётся копировать или вставлять ключ API.
-
1
Войдите в панель LetsBot.
letsbot.net/login
-
2
Откройте раздел «Интеграции» и выберите HubSpot.
-
3
Нажмите кнопку «Подключить HubSpot». Откроется экран авторизации OAuth в HubSpot.
-
4
Выберите аккаунт, который хотите подключить, проверьте разрешения и подтвердите их.
-
5
Вы автоматически вернётесь в панель LetsBot с готовым подключением, а основные триггеры уже будут включены и готовы к настройке.
3. Запрашиваемые разрешения и зачем они нужны
Приложение запрашивает только те разрешения, которые действительно нужны его функциям. Вот полный список:
| Область действия |
Зачем это нужно |
crm.objects.contacts.read |
Чтение свойств контакта (имя, телефон, email), чтобы определить получателя и заполнить переменные сообщения. |
crm.objects.contacts.write |
Создание контакта, когда сообщение WhatsApp приходит с неизвестного номера, и запись ответов как заметок в хронологию контакта. |
crm.objects.deals.read |
Чтение свойств сделки (название, этап, сумма, дата закрытия) и связанного контакта для работы триггеров сделок. |
tickets |
Чтение свойств тикета (тема, содержание) и связанного контакта для работы триггера тикетов. |
Приложение никогда не изменяет ваши сделки и тикеты и никогда не удаляет записи. Оно выполняет только две операции записи: создаёт контакт, когда приходит сообщение с неизвестного номера, и добавляет заметку о переписке в хронологию этого контакта.
4. Выберите событие-триггер
Каждое событие независимо: включайте только то, что нужно, а остальное можно отключить в любой момент. Сообщение никогда не отправляется по событию, которое вы сами не включили.
| Событие |
Тип подписки HubSpot |
Что происходит |
| Контакт создан |
contact.creation |
Отправляет приветственное сообщение сразу после добавления нового контакта в HubSpot. |
| Изменён этап жизненного цикла контакта |
contact.propertyChange |
Отправляет сообщение, когда контакт переходит на новый этап жизненного цикла (например, Marketing Qualified Lead). |
| Сделка создана |
deal.creation |
Пишет контакту, связанному со сделкой, сразу после её создания. |
| Этап сделки изменён |
deal.propertyChange |
Отправляет обновление, когда сделка переходит на другой этап вашей воронки. |
| Тикет создан |
ticket.creation |
Сообщает клиенту в WhatsApp, что его тикет получен и находится в работе. |
5. Напишите сообщение или выберите шаблон
Для каждого события можно написать короткое текстовое сообщение или выбрать расширенный шаблон WhatsApp с кнопками, списками и медиа. Данные HubSpot подставляются в сообщение через эти переменные:
| Переменная |
Значение |
{CONTACT_FIRSTNAME} |
Имя контакта |
{DEAL_NAME} |
Название сделки |
{DEAL_STAGE} |
Этап сделки |
{DEAL_AMOUNT} |
Сумма сделки |
{TICKET_SUBJECT} |
Тема тикета |
{TICKET_CONTENT} |
Содержание тикета |
Сообщения поддерживают арабский и английский. Если язык контакта задан в LetsBot, отправляется соответствующая версия, иначе по умолчанию используется английская.
6. Активируйте и протестируйте
-
1
Включите переключатель рядом с настроенным событием и сохраните.
-
2
В HubSpot создайте реальную запись этого типа — например, новый контакт — со своим номером телефона.
-
3
Сообщение в WhatsApp придёт к вам в течение нескольких секунд. Статус доставки можно отслеживать в журнале сообщений в LetsBot.
7. Ответы записываются обратно в HubSpot
Когда клиент отвечает в WhatsApp, LetsBot записывает ответ как заметку в хронологию контакта в HubSpot, и весь контекст переписки остаётся в карточке клиента. Если ответ пришёл с номера, которого у вас нет, контакт создаётся автоматически и заметка записывается к нему.
8. Устранение неполадок
Сообщение не пришло
- Проверьте, что переключатель события включён и изменения сохранены.
- Проверьте, что у контакта в HubSpot указан корректный номер телефона в международном формате: без него получателя определить нельзя.
- Проверьте, что ваш номер WhatsApp Business подключён и в LetsBot отображается как активный.
Триггеры сделок или тикетов не срабатывают
Триггеры сделок и тикетов работают через связанный контакт, ведь сообщение отправляется человеку, а не записи. Свяжите сделку или тикет с контактом, у которого есть номер телефона, и попробуйте снова.
Подключение прервалось
Так бывает, если приложение удалили в HubSpot или отозвали авторизацию. Подключитесь заново из панели LetsBot, снова нажав «Подключить HubSpot».
9. Отключение и удаление
Отключиться можно в любой момент — кнопкой отключения в панели LetsBot или удалив приложение в настройках подключённых приложений вашего аккаунта HubSpot. Сразу после отключения все автоматические сообщения прекращаются, и у приложения не остаётся доступа к вашим данным.
10. Данные и конфиденциальность
Все данные передаются по зашифрованному соединению, а токены доступа хранятся в зашифрованном виде. LetsBot читает из HubSpot только поля, необходимые для персонализации сообщения и определения получателя, и никогда не передаёт ваши данные третьим лицам.
Нужна помощь с настройкой? Наша ИИ-поддержка отвечает 24/7 на любом языке, а команда специалистов на арабском и английском поможет завершить подключение и отправить первое сообщение.