Лагерь «На волне ИИ» · Методичка
Бот в Instagram
на кодовое слово
Человек пишет слово под постом — бот отвечает в ветке и присылает материал в личные. Идите сверху вниз: около часа, если не сворачивать. У нас первый раз ушло три с половиной, потому что дважды свернули — оба тупика записаны.
К Instagram ведут два пути, и они не равны. Выбор делается в самом начале, и если выбрать не тот, всё остальное будет собрано зря: бот будет работать, а тексты комментариев к нему просто не придут.
Вход через Instagram
Тексты комментариев не приходят никогда
Страница Facebook не нужна
Доступ живёт 60 дней
Вход через Facebook — идём этим
Тексты комментариев приходят
Нужна страница Facebook
Доступ бессрочный
На первом пути запрос комментариев возвращает пустоту, хотя под постом их видно тридцать. Это не ошибка настройки и не нехватка прав. Проверять приложение у Meta при этом не нужно — ни подтверждения бизнеса, ни видеозаписей экрана: всё работает в режиме разработки.
1
Переключите аккаунт Instagram на профессиональный
Business или Creator — подойдёт любой из двух.
Instagram → Настройки → Аккаунт → Переключиться на профессиональный
Готово, когда: в настройках появился раздел «Для профессионалов»
2
Создайте страницу Facebook
Наполнять её не нужно, она техническая — нужна только для связи.
Готово, когда: страница создана, название любое
3
Свяжите страницу с аккаунтом Instagram
Это
ключевое условие: без связи дальше можно не идти.
Instagram → Настройки → Для профессионалов → там должна быть указана ваша страница
Готово, когда: в разделе для профессионалов видно название вашей страницы Facebook
Готово, когда: приложение появилось в списке ваших
5
Добавьте сценарий использования
Он называется «Управление сообщениями и контентом в Instagram».
6
Откройте настройку входа через Facebook
Именно через Facebook, не через Instagram — это та самая развилка из начала. Дальше нажмите обе кнопки добавления разрешений: одна для контента, вторая для сообщений.
Готово, когда: обе кнопки нажаты, разрешения добавились
7
Проверьте список разрешений
Должны быть эти девять. Двойники со словом
business в середине названия относятся к другому пути и здесь не работают.
pages_show_list — видеть свои страницы
business_management — без него список страниц придёт пустым
instagram_basic — базовые данные аккаунта
instagram_manage_comments — ради этого всё и делается
instagram_manage_messages — личные сообщения
instagram_manage_insights — статистика
instagram_content_publish — публикация постов
pages_read_engagement — чтение активности страницы
instagram_branded_content_ads_brand — рекламный контент
Готово, когда: все девять на месте, без двойников
Идентификатор приложения и секрет. Это
не то число, которое показано на странице Instagram — там другое, и на нём легко ошибиться.
Настройки приложения → Основное
Готово, когда: оба числа сохранены в менеджере паролей
9
Откройте инструмент проверки запросов
Отдельная страница, не кабинет приложения. Называется Graph API Explorer.
10
Сверху справа выберите своё приложение
Поле «Приложение Meta». По умолчанию там стоит чужое служебное — если не переключить, доступ выдадут не от вашего приложения.
Готово, когда: в поле видно название вашего приложения
11
Добавьте все девять разрешений
Поле «Добавить разрешение», выпадающий список. Добавлять нужно до того, как нажмёте кнопку создания: иначе Meta про них не спросит, и доступ придёт урезанным.
Готово, когда: все девять в списке добавленных
12
Переключите тип на страницу
Поле «Пользователь или Страница». По умолчанию стоит маркер пользователя — нужно выбрать «Получить маркер доступа к Странице». Это разные вещи, и с пользовательским ничего работать не будет.
13
Нажмите создание и отметьте свою страницу
Кнопка Generate Access Token, дальше вход в Facebook. На экране выбора страниц поставьте галочку напротив своей страницы — этот шаг легко проскочить, нажав «Далее», и тогда всё придётся начинать заново.
Готово, когда: после входа в поле «Пользователь или Страница» появилась ваша страница
14
Выберите страницу в списке
Строка доступа сверху сменится. Пока там пользователь, а не страница, доступ неправильный.
15
Сделайте доступ бессрочным
То, что выдал Explorer, живёт пару часов. Скажите Клоду своими словами:
у меня временный доступ от Meta, сделай из него бессрочный для страницы и проверь срок
В проверке должно быть написано: тип — страница, срок жизни ноль. Ноль значит «никогда».
Готово, когда: срок жизни — ноль. Пропустите этот шаг, и через 60 дней всё встанет
Порядок здесь важнее всего остального: сначала своё приложение, потом разрешения, потом переключение на страницу, и только потом кнопка создания. Любой шаг не на своём месте — и доступ придёт рабочий на вид, но без нужных прав.
16
Попросите Клода проверить комментарии
Он запросит у Meta ваши последние посты и комментарии под ними.
проверь, приходят ли тексты комментариев под моими постами в Instagram
Готово, когда: пришли тексты комментариев. Настройка закончена, дальше только код
17
Если пришла пустота при видимых комментариях
Значит используется не тот путь. Возвращайтесь к развилке в начале: нужен вход через Facebook. Не ищите причину в правах и не идите проходить проверку приложения — дело не в них.
Это вся ваша воронка. Больше ничего придумывать не нужно.
| Что решить | Пример |
Кодовое слово короткое, чтобы написали без ошибок | ГАЙД · МАРАФОН · ХОЧУ |
Что бот отвечает публично видят все, кто читает комментарии | «Написала вам 💌» · или ничего |
Что уходит в личные главное сообщение, ради него всё | ссылка на материал плюс вопрос в конце |
Отличать ли подписчиков можно послать разное, можно одинаковое | чаще всего одинаковое |
Что ответить, если напишут в ответ короткая живая реплика | «Спасибо, что написали. Расскажите, с чем сейчас работаете?» |
Готово, когда: вы можете произнести свою воронку вслух одним предложением
19
Расскажите её Клоду обычными словами
Никаких файлов и настроек открывать не нужно: он сам разложит вашу логику куда следует и подключит к боту.
хочу воронку: человек пишет ГАЙД под постом,
бот отвечает в ветке «написала вам» и присылает
в личные ссылку на мой гайд, в конце спрашивает,
с чем человек сейчас работает
Захотите поменять текст или добавить слово — точно так же, словами. Перезапускать ничего не надо: правки начинают работать через несколько секунд.
Готово, когда: Клод сказал, что воронка добавлена
20
Проверьте живьём — с чужого аккаунта
На ваши собственные комментарии бот не отвечает намеренно. Тестировать со своего аккаунта бессмысленно: попросите знакомого или заведите второй.
Готово, когда: человек написал слово под постом, получил ответ в ветке и сообщение в личные
Если что-то пошло не так, не лезьте в настройки вслепую. Скажите Клоду, что хотели получить и что получилось вместо этого — он разберётся сам.
- На комментарий — семь дней, на переписку в личных — сутки. Неделя даётся на то, чтобы бот ответил человеку, который написал слово. Сутки — это сколько живёт разговор после того, как человек ответил вам сам
- Одно сообщение на один комментарий. Цепочку отправить нельзя: пока человек не ответил, второго сообщения у вас не будет, сколько бы дней ни оставалось
- Под прямыми эфирами правило жёстче. Ответить в личные можно только пока идёт эфир. Закончился — всё, эта возможность закрыта
- Ответов в ветке — сколько угодно. Это не ограничено, и этим стоит пользоваться: ветку читают все
- Комментарии старше недели бот пропускает. Instagram всё равно не даст на них ответить, а ещё это защита: без неё бот при сбое разослал бы приветствия под старыми постами
- Аккаунт должен быть открытым. У закрытого уведомления о комментариях не приходят вовсе
Отсюда правило для текстов: всё важное — в первое сообщение, и закончить вопросом, на который захочется ответить. Человек отвечает — открывается окно на сутки, и дальше можно разговаривать.
Пустой список комментариев
Через вход по Instagram тексты не приходят никогда, сколько прав ни выдай. Причину легко начать искать в проверке приложения, в его публикации, в возрасте постов и даже в роли тестировщика — но дело только в пути.
Список страниц приходит пустым
Не хватает разрешения
business_management. Страницы нового типа без него не видны, даже когда остальные права выданы. Выглядит так, будто страница не связана с аккаунтом, хотя связь есть.
Уведомления не приходят на российский сервер
Серверы Meta не доходят до российских адресов: за час может не прийти ни одного запроса, при том что снаружи сервер отвечает нормально. Лечится бесплатным туннелем — Клод поднимет адрес вне России. Подписок нужно
две: приложения на адрес и самого аккаунта на события. Вторую легко забыть, и тогда ничего не приходит при полностью правильной первой.
Ошибка «уже имеет ответ» — это не поломка
На один комментарий разрешено ровно одно личное сообщение. Повторное вернёт ошибку. Так и задумано: человек своё сообщение уже получил.
Бот не отвечает на ваши комментарии
Так и должно быть. Нужен любой другой аккаунт.
1
Смотрите, кто пришёл, раз в неделю
Не ради цифр, а чтобы заметить: какое слово люди пишут чаще, а какое не пишет никто. Второе обычно значит, что о нём просто негде узнать.
покажи, кто написал боту за последнюю неделю и по каким словам
2
Поставьте сигнал о поломке
Чтобы узнавать о сбое самой, а не от человека, который не получил обещанное.
сделай, чтобы бот раз в неделю сам проверялся и писал мне, если что-то отвалилось
3
Если что-то сломалось — не пересобирайте с нуля
Почти всегда дело в чём-то одном: доступ протух, бот не поднялся после перезагрузки сервера или Instagram сменил правила.
проверь, работает ли мой бот в Instagram и видит ли он комментарии
4
Помните, отчего доступ может умереть
Обычно он бессрочный и продлевать его не нужно. Но он умрёт, если сменить пароль Facebook, отозвать доступ приложения в настройках Instagram или изменить свои права на связанной странице. Тогда нужно пройти заново только часть 3 — это минут пять.
Оговорка. Meta Platforms Inc. признана экстремистской организацией и запрещена на территории России. Вход в кабинеты выполняется через аккаунт Facebook.