Instagram Direct

Личные сообщения Instagram попадают в общую ленту диалогов, а отвечать на них можно из системы. Подключается через то же приложение Meta, что и WhatsApp.

Правила Instagram

• Писать первыми нельзя: только отвечать, причём в течение 24 часов после сообщения человека. Позже отправка закрыта, и система сообщит об этом вместо поля ввода.
• Исходящие фото и файлы система не отправляет: только текст и ссылки.
• Длинные ответы система делит на несколько сообщений сама.
• Аккаунт должен быть профессиональным (бизнес или автор).

Шаг 1. Разрешения приложения

В приложении Meta откройте Сценарии использования → «Управление сообщениями и контентом в Instagram» → «Настройка API с входом через Instagram». В шаге 1 должны быть добавлены разрешения:

• instagram_business_basic;
• instagram_business_manage_comments;
• instagram_business_manage_messages.

Шаг 2. Тестировщик и маркер

1. Пока приложение в разработке, аккаунту Instagram нужна роль: в приложении Meta на вкладке «Роли» назначьте аккаунту роль тестировщика Instagram. Приглашение нужно принять в самом Instagram, в настройках в разделе «Приложения и сайты».

2. В шаге 2 «Сгенерируйте маркеры доступа» нажмите «Добавить аккаунт».

   

3. Нажмите «Сгенерировать маркер», подтвердите доступ в Instagram и скопируйте маркер. Он понадобится в системе.

4. Убедитесь, что у аккаунта включена «Подписка на Webhooks» (тумблер «Вкл.»).

Шаг 3. Вебхук

В шаге 3 «Настройте Webhooks» впишите URL обратного вызова и Подтверждение маркера из вашей системы (см. «Куда вставить») и нажмите «Подтвердить и сохранить». Затем подпишитесь на поле messages.

Шаг 4 («Настройте вход в Instagram от имени компании») нужен только тем, кто делает кнопку «Войти через Instagram» для своих клиентов. Для подключения собственного аккаунта его пропустите.

Пока приложение не опубликовано, вебхуки не приходят

Meta присылает только тестовые события. Опубликуйте приложение: см. Приложение Meta.

Сообщения от клиентов и проверка Meta

Пока у приложения нет расширенного доступа, писать вам могут только аккаунты, у которых есть роль в приложении. Чтобы сообщения приходили от любых клиентов, приложение должно пройти проверку Meta (App Review) на разрешение instagram_business_manage_messages. Это отдельная заявка со скринкастом; начните её заранее, рассмотрение занимает время.

Куда вставить в системе

Откройте Интеграции → Instagram:

1. Впишите секрет приложения Instagram (и при необходимости Meta): Приложение Meta.
2. Подключите аккаунт: вставьте маркер из Шага 2. Система сама определит, чей он, вписывать ник не нужно.
3. Скопируйте со страницы адрес вебхука и токен подтверждения в Meta (Шаг 3).

Маркер Instagram действует 60 дней: система продлевает его сама.

Проверка

Напишите в Direct аккаунта с другого аккаунта, у которого есть роль в приложении. Диалог появится в ленте с пометкой Instagram. Если ничего не приходит, проверьте: приложение опубликовано, включена подписка на messages, у аккаунта включена «Подписка на Webhooks». Сообщение может оказаться в «Запросах», если аккаунты не подписаны друг на друга.