Настройка WhatsApp-канала

Для кого

Администраторы TehProf Support, которые подключают один или несколько номеров WhatsApp для обращений клиентов.

Что понадобится

  • права администратора;
  • отдельный номер и телефон с WhatsApp для QR-подключения либо реквизиты выбранного официального/шлюзового варианта;
  • для собственного движка — его HTTPS-адрес, instance и API key.

WhatsApp — платное дополнение. Актуальная стоимость и срок теста показываются в карточке интеграции; правила также описаны в лицензировании каналов.

Выбор варианта

Откройте Настройки → Чаты → Линии и подключения и добавьте линию WhatsApp. В зависимости от доступного подключения сервис предложит один из вариантов:

  • WhatsApp на нашем движке — платформа создаёт и обслуживает соединение, вы связываете номер по QR;
  • WhatsApp на вашем движке — для существующего совместимого сервера;
  • WhatsApp Cloud API — официальный облачный вариант;
  • WhatsApp через Диалоги — шлюз Bitrix24.

Эти варианты не являются одной общей формой. Выберите тот, чьими реквизитами и возможностями вы реально располагаете.

Управляемый QR-движок

  • Откройте карточку WhatsApp на нашем движке и нажмите Подключить.
  • Укажите понятное название линии.
  • Дождитесь готовности приёмника. Код подключения показывается только после этого.
  • На телефоне откройте WhatsApp → Связанные устройства → Привязать устройство.
  • Отсканируйте QR-код и дождитесь состояния «Подключено».

Создавать instance вручную, передавать API key администратору платформы или настраивать webhook для этого варианта не нужно.

Собственный движок

  • На своём сервере заранее создайте WhatsApp-instance.
  • Откройте карточку WhatsApp на вашем движке.
  • Укажите URL сервера, имя/ID instance и API key. Секрет сохраняется защищённо и не показывается целиком после записи.
  • Сохраните линию и отсканируйте QR-код.
  • Убедитесь, что карточка показывает подключённое состояние и успешный входящий приём.

Webhook и события подключения платформа настраивает через сохранённые реквизиты. Если ваш сервер не позволяет сделать это автоматически, исправьте конфигурацию на стороне собственного движка; не подменяйте URL линии чужим общим webhook.

Настройка линии

После подключения откройте карточку конкретного номера:

  • задайте название и правила маршрутизации;
  • отдельно включите входящий и исходящий потоки;
  • при необходимости настройте группы и их привязки (только для движка, который поддерживает группы);
  • учитывайте показанную матрицу возможностей для медиа, прочтения, редактирования и удаления.

Проверка

  • С другого номера отправьте обычный текст — должна появиться новая заявка или сообщение в существующей.
  • Ответьте из заявки — сообщение должно прийти в тот же чат WhatsApp.
  • Отправьте изображение или документ в обе стороны.
  • Если используете несколько линий, повторите проверку для каждой: маршрутизация и выключатели принадлежат конкретной линии.

Если не работает

  • Нет QR-кода: дождитесь готовности приёмника или перезапустите подключение.
  • Входящие не приходят: проверьте подключение и входящий поток нужной линии; для собственного движка — доступность сервера/webhook.
  • Ответы не уходят: проверьте исходящий поток, активную подписку и фактическое состояние сессии.
  • Нет редактирования/групп/прочтения: эта возможность может не поддерживаться выбранным движком; ориентируйтесь на карточку линии.

Ответственное использование звонков

Правила устанавливает WhatsApp, а не мы — злоупотребление звонками может стоить номера.

Что это значит на деле:

  • звонок уместен, когда человек ждёт вашего звонка или сам о нём попросил;
  • если человек не берёт трубку, повторный дозвон подряд лучше отложить;
  • только что подключённому номеру нужно время: начинайте с переписки, а не с обзвона.

Пределы и признаки опасного рисунка задаёт сама площадка и они меняются; служба показывает

предупреждение прямо в звонке только тогда, когда рисунок действительно похож на опасный.

Обычный звонок по делу ничего не показывает.

Связанные статьи

Нужна поддержка, которая так и работает?

TehProf Support собирает обращения из WhatsApp, Telegram, почты и виджета в одну очередь, считает сроки по SLA и показывает, где служба проседает.