Провайдеры сообщений

Настройки → Коммуникации → Провайдеры сообщений — место для подключения LeadHub к двусторонним каналам обмена сообщениями. После настройки с лидами можно связываться прямо из их карточки, а входящие сообщения из этих каналов поступают в Диалоги.

Поддерживаемые каналы:

Канал	Направление	Провайдер
WhatsApp	Отправка и получение	Meta Cloud API (WhatsApp Business)
SMS	Отправка и получение	Twilio Programmable Messaging
Telegram	Отправка и получение	Telegram Bot API
Viber	Отправка и получение	Viber Business Messages
Голосовые звонки (Click-to-Call)	Исходящие + запись	Twilio Programmable Voice

---

WhatsApp Business (Meta Cloud API)

Предварительные требования

• Бизнес-аккаунт Meta на business.facebook.com
• Бизнес-аккаунт WhatsApp с подтверждённым номером телефона
• Номер должен быть зарегистрирован в WhatsApp Cloud API (не в обычном приложении WhatsApp)

Шаг 1 — Создание приложения Meta

1. Перейдите на developers.facebook.com → Мои приложения → Создать приложение.
2. Выберите Бизнес в качестве типа приложения.
3. Дайте ему имя (например, LeadHub Integration) и нажмите Создать приложение.
4. В разделе Добавить продукты найдите WhatsApp и нажмите Настроить.

Шаг 2 — Получение учётных данных

1. В панели управления продуктом WhatsApp перейдите в Настройка API.
2. Запишите:
   • Phone Number ID (числовой, например 106540352242922)
   • WhatsApp Business Account ID
3. Перейдите в Системные пользователи (в настройках бизнеса) → создайте системного пользователя → сгенерируйте Постоянный токен доступа с разрешением whatsapp_business_messaging.

Шаг 3 — Настройка в LeadHub

1. Перейдите в Настройки → Коммуникации → Провайдеры сообщений.

2. Разверните раздел WhatsApp Business и заполните:

   Поле	Значение
   Включено	Включить переключатель
   Постоянный токен доступа	Из шага 2
   Phone Number ID	Из шага 2
   Отображаемый номер телефона	Ваш номер WhatsApp (например, +7-495-000-0000)

3. Нажмите Сохранить настройки.

4. После сохранения появится URL входящего вебхука вида: https://yourdomain.com/api/messaging/whatsapp/webhook/TENANT_ID/TOKEN

Шаг 4 — Регистрация вебхука в Meta

1. В панели приложения Meta перейдите в WhatsApp → Конфигурация → Вебхуки.
2. Установите URL обратного вызова в URL входящего вебхука из шага 3.
3. Задайте Токен верификации (любая строка, например leadhub_verify).
4. Подпишитесь на поле вебхука messages.

Тест: Отправьте сообщение на ваш номер WhatsApp с телефона. Оно должно появиться как новый Диалог в LeadHub.

---

SMS (Twilio Programmable Messaging)

Шаг 1 — Получение учётных данных Twilio

1. Войдите на console.twilio.com.
2. На Дашборде скопируйте Account SID и Auth Token.
3. В разделе Номера телефонов → Управление → Активные номера запишите ваш номер Twilio.

Шаг 2 — Настройка в LeadHub

1. Перейдите в Настройки → Коммуникации → Провайдеры сообщений.

2. Разверните SMS (Twilio) и заполните:

   Поле	Значение
   Включено	Включить переключатель
   Account SID	AC... из панели Twilio
   Auth Token	Из панели Twilio
   Номер отправителя	Ваш номер Twilio в формате E.164 (например, +14155550199)

3. Нажмите Сохранить настройки.

4. Скопируйте URL входящего вебхука, появившийся после сохранения.

Шаг 3 — Регистрация вебхука в Twilio

1. В Twilio перейдите в Номера телефонов → Управление → Активные номера → нажмите на ваш номер.
2. В разделе Мессенджер → Входящее сообщение задайте URL вебхука LeadHub.
3. Установите метод HTTP POST и сохраните.

Пробные аккаунты: Могут отправлять SMS только на проверенные номера. Для производственной среды перейдите на платный аккаунт.

---

Telegram

Шаг 1 — Создание бота Telegram

1. Откройте Telegram и напишите @BotFather.
2. Отправьте /newbot и следуйте инструкциям (имя и имя пользователя).
3. BotFather выдаст вам Токен бота (формат: 123456:ABCdef...).
4. Также запомните Имя пользователя бота (например, @your_leadhub_bot).

Шаг 2 — Настройка в LeadHub

1. Перейдите в Настройки → Коммуникации → Провайдеры сообщений.

2. Разверните Telegram и заполните:

   Поле	Значение
   Включено	Включить переключатель
   Токен бота	От BotFather
   Имя пользователя бота	Например, @your_leadhub_bot

3. Нажмите Сохранить настройки.

4. Скопируйте появившийся URL входящего вебхука.

LeadHub автоматически регистрирует вебхук в Telegram через Telegram Bot API — вручную вставлять URL в Telegram не нужно.

---

Viber Business Messages

⚠️ Viber Business Messages требует одобренного сервисного аккаунта Viber (аккаунт ISV/бизнеса). Обычные личные аккаунты Viber не могут отправлять бизнес-сообщения.

Шаг 1 — Получение токена Viber Auth Token

1. Свяжитесь с партнёрской программой Viber и получите сервисный аккаунт.
2. Войдите на портал партнёров Viber и найдите ваш Auth Token.
3. Запишите Имя отправителя (название вашего бренда, до 28 символов).

Шаг 2 — Настройка в LeadHub

1. Перейдите в Настройки → Коммуникации → Провайдеры сообщений.

2. Разверните Viber и заполните:

   Поле	Значение
   Включено	Включить переключатель
   Auth Token	С партнёрского портала Viber
   Имя отправителя	Название вашего бренда

3. Нажмите Сохранить настройки.

4. Скопируйте URL входящего вебхука и зарегистрируйте его в панели управления вашего сервисного аккаунта Viber.

---

Голосовые звонки / Click-to-Call (Twilio Voice)

Twilio Voice обеспечивает звонки одним кликом прямо из карточки лида. Звонки фиксируются в Истории звонков и могут быть записаны и автоматически расшифрованы.

Предварительное условие: Сначала должен быть настроен SMS (Twilio) — Voice использует те же Account SID и Auth Token.

Шаг 1 — Настройка в LeadHub

1. Перейдите в Настройки → Коммуникации → Провайдеры сообщений.

2. Разверните Voice (Twilio Voice) и заполните:

   Поле	Значение
   Включено	Включить переключатель
   Номер вызывающего абонента Voice	Ваш голосовой номер Twilio в формате E.164
   Записывать звонки	Включить для записи обеих сторон
   Авто-транскрипция + AI-резюме	Включить для создания текстовой расшифровки и резюме (требуется API-ключ OpenAI)

3. Нажмите Сохранить настройки.

4. Появятся три URL — TwiML URL, Status URL и Recording URL. Скопируйте все три.

Шаг 2 — Регистрация вебхуков в Twilio

1. В Twilio перейдите на ваш голосовой номер → раздел Voice.
2. В поле Входящий звонок → Вебхук вставьте ваш TwiML URL.
3. В поле Изменение статуса звонка вставьте ваш Status URL.
4. В разделе Записи установите вебхук на ваш Recording URL.

---

Отправка тестовых сообщений

После сохранения любого канала нажмите Отправить тестовое сообщение (вверху справа на странице):

1. Выберите Канал (WhatsApp, SMS, Telegram или Viber).
2. Введите Номер телефона или Chat ID для отправки (ваш собственный для тестирования).
3. Введите текст тестового сообщения.
4. Нажмите Отправить — реальное сообщение доставляется этому контакту.

---

Устранение неполадок

Проблема	Решение
«Сохраните настройки для генерации URL входящего вебхука»	Вы ещё не сохранили — заполните учётные данные и нажмите «Сохранить»
Верификация вебхука WhatsApp не работает	Убедитесь, что Токен верификации в Meta совпадает с использованным при настройке
Сообщения Telegram не поступают	LeadHub автоматически регистрирует вебхук — проверьте правильность токена бота
Тест SMS не проходит	Убедитесь в правильности Auth Token и активности вашего номера Twilio
Голосовые звонки не подключаются	Убедитесь, что TwiML и Status URL зарегистрированы в Twilio
Токены отображаются маскированными (••••••••••••)	Это намеренно — существующие секреты маскируются для безопасности. Оставьте без изменений для сохранения хранящегося секрета.