Интеграция с WhatsApp

Подключите вашего агента к WhatsApp Business для общения с клиентами.

Обзор

Интеграция с WhatsApp обеспечивает:

• Возможности бизнес-переписки
• Поддержку мультимедиа
• Автоматические ответы
• Глобальный охват
• Соответствие правилу 24-часового окна обмена сообщениями

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

• Активный AI-агент (созданный в разделе Agents)
• Аккаунт WhatsApp Business (WABA)
• Подтверждённый номер телефона в WhatsApp Business
• Доступ к Meta Developer Portal

Шаги настройки

1. Подключение через Embedded Signup (рекомендуется)

Самый простой способ подключить WhatsApp — через встроенный процесс регистрации Meta:

1. Перейдите в Integrations в боковой панели
2. Откройте карточку WhatsApp Business и нажмите Add WhatsApp
3. Нажмите Connect with Facebook, чтобы открыть всплывающее окно регистрации Meta
4. Войдите с вашей учётной записью Facebook/Meta
5. Выберите или создайте аккаунт WhatsApp Business
6. Выберите номер телефона для подключения
7. Всплывающее окно закроется, и подключение будет установлено

2. Подтверждение номера телефона (при необходимости)

После завершения регистрации через Meta вам может потребоваться подтвердить номер телефона:

1. Выберите способ получения кода подтверждения: SMS или Voice Call
2. Нажмите Send Code
3. Введите полученный 6-значный код
4. Нажмите Verify

Если вы не получили код, нажмите “Didn’t receive the code? Send again” для повторной отправки.

3. Двухэтапная верификация (если включена)

Если в вашем аккаунте WhatsApp Business включена двухэтапная верификация:

1. Введите 6-значный PIN-код при запросе
2. Нажмите Complete Registration

4. Настройка Webhook (при необходимости)

После настройки вам может потребоваться сконфигурировать webhook в Meta Business Suite:

1. Скопируйте URL webhook, предоставленный после подключения
2. В Meta Developer Portal перейдите в WhatsApp → Configuration
3. Добавьте URL webhook
4. Подпишитесь на поле webhook messages

Использование бота

Сообщения клиентов

Когда клиенты пишут на ваш номер WhatsApp:

1. Сообщение поступает через WhatsApp
2. Cuneiform Chat обрабатывает запрос
3. Агент генерирует ответ на основе контента
4. Ответ отправляется обратно клиенту

Поток диалога

Customer → WhatsApp → Cuneiform Chat → Agent → Response → Customer

Возможности

24-часовое окно обмена сообщениями

Правила WhatsApp Business API:

• Вы можете отвечать на сообщения, инициированные клиентом, в течение 24 часов
• По истечении 24 часов окно закрывается до тех пор, пока клиент не напишет снова
• Каждое новое сообщение клиента открывает окно заново

Мультимедиа

Ответы могут включать:

• Текстовые сообщения
• Ссылки
• Форматированный текст

Многоязычность

Ваш агент автоматически определяет язык клиента и отвечает на нём — поддерживается 176 языков, настройка не требуется.

Управление подключёнными номерами

Для каждого подключённого номера WhatsApp отображается:

• Название компании или отображаемый номер телефона
• Статус — Active, Inactive или Error
• Номер телефона
• Последняя активность — временная метка

Доступные действия

Доступ к этим действиям через меню с тремя точками на карточке интеграции.

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

Ошибка подключения

1. Убедитесь, что у вас есть действующий аккаунт WhatsApp Business
2. Проверьте, что ваш номер телефона подтверждён
3. Попробуйте пройти процесс регистрации заново

Не работает подтверждение номера телефона

1. Убедитесь, что у вас есть доступ к номеру телефона для получения SMS/звонка
2. Подождите несколько минут перед запросом нового кода
3. Проверьте, что номер телефона не подключён в другом месте

Ошибка двухэтапной верификации

1. Введите PIN-код, настроенный в WhatsApp Business Manager → Security Center
2. Он отличается от кода подтверждения по SMS
3. Обратитесь к администратору WhatsApp Business, если вы не знаете PIN-код

Сообщения не поступают

1. Убедитесь, что webhook правильно настроен в Meta Business Suite
2. Проверьте, что подписка webhook включает messages
3. Подтвердите, что статус интеграции — “Active”

Ошибки при отправке ответов

1. Проверьте работу вашего агента в Playground
2. Убедитесь, что 24-часовое окно активно (клиент писал недавно)
3. Проверьте статус интеграции в панели администрирования

Безопасность

• Токены доступа зашифрованы и хранятся безопасно
• Сообщения обрабатываются через защищённые соединения

Соответствие требованиям

WhatsApp Business имеет правила использования:

• Отвечайте только на диалоги, инициированные клиентом
• Предоставляйте возможность отказа от рассылки
• Соблюдайте коммерческие и бизнес-политики Meta

Отключение

Чтобы удалить интеграцию с WhatsApp:

1. Перейдите в Integrations в боковой панели
2. Нажмите на меню с тремя точками на интеграции WhatsApp
3. Выберите Disconnect

Это остановит ответы агента. Для полного удаления:

• Удалите webhook в Meta Developer Portal
• При необходимости удалите продукт WhatsApp из вашего приложения Meta

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

В: Как подключить WhatsApp? О: Используйте встроенную регистрацию, нажав “WhatsApp” на вкладке Integrations, затем “Connect with Facebook”. Это автоматически проведёт вас через процесс регистрации Meta.

В: Почему у меня запрашивают код подтверждения? О: WhatsApp требует подтверждения номера телефона для новых подключений. Выберите SMS или Voice Call для получения 6-значного кода, затем введите его для завершения настройки.

В: Что такое PIN-код двухэтапной верификации? О: Если вы включили двухэтапную верификацию в WhatsApp Business Manager, вам потребуется ввести этот 6-значный PIN-код при настройке. Он отличается от кода подтверждения по SMS.

В: Можно ли подключить несколько номеров WhatsApp? О: Да, вы можете подключить несколько номеров WhatsApp Business. Каждый номер может быть подключён к другому (или тому же) AI-агенту.