WatsyAppНовые Direct и текстовый ответ
Сообщения появляются в выбранном Instagram-канале кабинета. Ответ текстом доступен в течение 24 часов после последнего входящего сообщения клиента.
INSTAGRAM DIRECT · API-ГАЙД
Как работает API сообщений Instagram.
Профиль, официальный вход, webhook и текстовый ответ: разберём путь сообщения и границы текущего подключения WatsyApp.
ГРАНИЦЫ ДОКУМЕНТАЦИИ
API Meta и возможности WatsyApp
Медиа, комментарии и старая история
Комментарии, голосовые, отправка медиа и импорт старых диалогов не поддерживаются. Текстовый обмен с Битрикс24 проверен отдельно: возможности и подключение. Вложение может отображаться уведомлением без загрузки содержимого.
Возможности самой платформы Meta шире первой версии WatsyApp. Наличие метода в документации Meta не означает, что он доступен в нашем кабинете или CRM-мосте.
АРХИТЕКТУРА
Четыре части подключения
1. Авторизация профиля
Владелец Business- или Creator-профиля проходит Instagram Login и разрешает доступ к сообщениям. Этот способ не требует привязанной Facebook Page.
2. Разрешения
Текущая реализация использует instagram_business_basic и instagram_business_manage_messages. Доступ к комментариям не запрашивается.
3. Приём webhook
Meta отправляет событие нового сообщения. На стороне получателя проверяются подпись, привязка профиля и идентификатор сообщения для защиты от повторной обработки.
4. Отправка ответа
Текст передаётся в API Meta от имени подключённого профессионального профиля. Нужны действующий доступ и допустимое окно диалога.
ДЛЯ РАЗРАБОТЧИКА
Что нужно проверить
в собственном приложении
Подготовьте приложение и профессиональный профиль
Сверьте актуальные требования Instagram Login, уровень разрешений и доступ для сторонних профилей. Публикация приложения и App Review — разные проверки.
Пройдите официальный OAuth
Запрашивайте только нужные разрешения, проверяйте привязку подтверждения к владельцу и подключаемому каналу. Храните секреты на сервере. Не помещайте токены в публичный HTML, скриншоты и логи.
Настройте подписку на сообщения
Верификация callback и подписка конкретного профессионального профиля решают разные задачи. Тестовый вызов из Dashboard не заменяет реальное сообщение Direct.
Проверьте входящее и ответ
Сверьте профиль, идентификатор диалога и новое входящее. Подтвердите, что повтор webhook не создаёт второй экземпляр сообщения и что ответ действительно получен клиентом.
Не используйте служебные URL WatsyApp как свой webhook
OAuth callback и webhook нашего сервиса обслуживают его собственное приложение Meta. Они не являются публичными точками приёма событий для сторонних интеграций. Для подключения к кабинету используйте пошаговую инструкцию.
ФОРМА ЗАПРОСА
Текстовый ответ через API Meta
Ниже — схема серверного запроса к Meta с заглушками, а не запрос к WatsyApp. Актуальную версию Graph API и контракт отправки проверьте в официальной документации своего приложения.
POST https://graph.instagram.com/GRAPH_API_VERSION/IG_USER_ID/messages
Authorization: Bearer INSTAGRAM_ACCESS_TOKEN
Content-Type: application/json
{
"recipient": { "id": "RECIPIENT_SCOPED_ID" },
"message": { "text": "Ответ на сообщение клиента" }
}Все идентификаторы и токен заменены заглушками. Получатель — участник допустимого диалога, а не произвольный username или телефон. Пример на странице ничего не отправляет.
ОГРАНИЧЕНИЯ
Ответ после сообщения клиента
В WatsyApp — 24 часа
Первая версия позволяет отвечать текстом в течение 24 часов после последнего входящего сообщения клиента. Новый исходящий ответ сам по себе не продлевает это окно.
Гайд не обещает написать первым, сделать рассылку или обойти ограничения платформы.
CRM — отдельная часть системы
Для Битрикс24 проверены новое входящее в Открытой линии и ответ оператора обратно в Instagram. Нужна отдельная привязка Instagram-канала. Для 2wix проверен текстовый обмен на собственных профилях. Поддержка amoCRM пока не заявлена.
Работающий WhatsApp-мост не означает, что тот же маршрут поддерживает Instagram.
ОФИЦИАЛЬНЫЕ ИСТОЧНИКИ
Сверяйтесь с текущим контрактом Meta
- Meta: Instagram API with Instagram Login ↗
- Meta: Messaging API ↗
- Официальная коллекция Meta в Postman ↗
Условия и доступы могут изменяться. Для клиентского запуска отдельно подтвердите, что приложение может работать с профилями, у которых нет тестовой роли.
ВОПРОСЫ И ОТВЕТЫ
Что проверить заранее
Это документация публичного Instagram API WatsyApp?
Нет. Страница объясняет официальный API Meta и текущую реализацию подключения в WatsyApp. Публичный контракт Instagram API WatsyApp для сторонних разработчиков не заявлен. WhatsApp-методы нельзя автоматически применять к Instagram.
Можно ли написать клиенту первым?
Для описанного сценария клиент сначала должен написать профессиональному профилю. В WatsyApp текстовый ответ разрешён в течение 24 часов после последнего входящего. Массовые рассылки и обход этого окна не входят в возможности сервиса.
Достаточно ли успешного теста webhook в Meta?
Нет. Тест callback подтверждает только отдельную техническую часть. Нужны реальное новое входящее, появление сообщения в нужном канале и ответ, видимый отправителю в Instagram.
Какие разрешения используются?
Текущее подключение WatsyApp запрашивает instagram_business_basic и instagram_business_manage_messages. Разрешение на комментарии не запрашивается. Требования для клиентских аккаунтов и уровни доступа сверяйте с актуальной документацией и настройками своего приложения Meta.
Есть ли готовая передача Direct в Битрикс24, amoCRM или 2wix?
Для Битрикс24 реальный текстовый обмен проверен на собственных разрешённых профилях и тестовом облачном портале. Условия подключения и ограничения. Для 2wix подтверждён текстовый обмен на собственных профилях. Поддержка amoCRM пока не заявлена.
Нужна помощь с диалогами?
Если новое сообщение не появилось, откройте диагностику Instagram Direct. Как переключать самостоятельные каналы — в обзоре WhatsApp и Instagram в одном кабинете.
ПУТЕВОДИТЕЛЬ ПО СЕРВИСУ
Другие разделы WatsyApp
Выберите задачу: работа с диалогами, подключение номера или интеграция с вашей системой.
INSTAGRAM И CRM
Direct в Открытых линиях Битрикс24
Новое текстовое сообщение и ответ оператора проверены в обе стороны. Посмотреть условия и настройку интеграции Instagram с Битрикс24 ↗
Instagram Direct в CRM 2wix
Реальное входящее и ответ проверены для трёх собственных профилей одновременно. Инструкция подключения Instagram к 2wix и ограничения ↗