Права доступа страницы и токены

AFP действует на подключённой странице с доступом, который выдаёт администратор этой страницы. На Facebook это означает роль администратора на странице плюс согласие профиля, который ею администрирует; при Instagram Business Login это означает три разрешения, покрывающие бизнес-данные аккаунта, его комментарии и его сообщения. Каждое разрешение хранится для страницы как токен доступа, и каждое действие, которое совершает кампания, использует его.

Сводка

Разрешение	Где вы его одобряете	Что оно даёт	Что ломается без него
Роль администратора на странице Facebook	На Facebook, в настройках этой страницы	AFP запрашивает у Facebook собственный токен доступа страницы, который использует каждое действие на странице	Facebook не возвращает токен страницы, и AFP отказывается подключать страницу, сообщая об отсутствии доступа администратора
Управление страницей, запрашиваемое как `pages_manage_metadata`	Экран согласия Facebook, при присоединении профиля	Регистрация и удаление подписки страницы на события	Комментарии и сообщения никогда не доходят до AFP, так что ничто на странице не запускается
Доступ Instagram, запрашиваемый как `instagram_basic`	Экран согласия Facebook	Доступ к бизнес-аккаунту Instagram, присоединённому к подключённой странице Facebook, через токен этой страницы	Аккаунт Instagram, присоединённый к странице, нельзя ни прочитать, ни на него подействовать
`instagram_business_basic`	Экран согласия Instagram, во время Instagram Business Login	Чтение id, имени пользователя, имени и фото профиля аккаунта — так AFP определяет, что он подключил	Business Login не может завершиться, и ни один аккаунт не подключается
`instagram_business_manage_comments`	Экран согласия Instagram	Получение событий комментариев на аккаунте и выполнение действий с комментариями на нём	Триггеры и действия с комментариями не срабатывают на этом аккаунте
`instagram_business_manage_messages`	Экран согласия Instagram	Получение личных сообщений на аккаунте и их отправка	Триггеры ЛС никогда не срабатывают, и ни одно ЛС не доставляется

Доступ к странице Facebook

Выдаётся: профилем Facebook, который администрирует страницу
Хранится как: один токен доступа на подключённую страницу
Обновляется: самим AFP, когда вызов отклонён, или повторной авторизацией профиля

AFP строит список страниц, которые вы можете подключить, спрашивая у Facebook, какими страницами администрирует каждый присоединённый профиль. Подключение затем запрашивает собственный токен доступа этой страницы, и страница, для которой Facebook не возвращает токен, пропускается, а не подключается, с сообщением об отсутствии у профиля доступа администратора к ней.

Токен страницы — это то, что публикует каждое действие на этой странице: публичный ответ на комментарий, скрытый или удалённый комментарий, личное сообщение и блокировку комментатора. Бизнес-аккаунт Instagram, присоединённый к подключённой странице Facebook, работает на том же токене страницы Facebook вместо собственного.

Когда вызов за постами страницы отклоняется, AFP перезаписывает токен этой страницы из текущего доступа владеющего профиля, заново регистрирует подписку страницы на события и повторяет вызов. Отказ, переживший этот повтор, — это то, что проявляется как истёкший доступ.

Выдаётся: самим бизнес-аккаунтом Instagram
Хранится как: один долгоживущий токен Instagram на подключённый аккаунт, действителен 60 дней
Обновляется: ежедневным проходом обновления, или повторным запуском Business Login

Instagram Business Login подключает бизнес-аккаунт без участия страницы Facebook. AFP запрашивает три разрешения на экране согласия Instagram — базовые бизнес-данные, управление комментариями и управление сообщениями — и сохраняет полученный долгоживущий токен на аккаунте.

Ссылка согласия, которую создаёт AFP, одноразовая и истекает через десять минут после выдачи. Отмена на экране Instagram, открытие той же ссылки дважды, или возврат после её истечения — всё это заканчивается без подключения.

Используйте один способ на аккаунт Instagram. Аккаунт, который AFP уже достигает через подключённую страницу Facebook, отклоняется Business Login, а аккаунт, подключённый через Business Login, не присоединяется повторно, когда его страница Facebook подключается позже.

Почему доступ истекает, и что вы видите

Симптом	Что это значит
Страница на Аккаунтах (Accounts) читается как истёкшая	Доступ, сохранённый для этой страницы, больше не работает
Группа профиля Facebook читается как истёкшая	Собственный доступ Facebook профиля больше не работает, так что затронута каждая страница под ним
Страницы профиля исчезают из доступного списка	AFP запросил у Facebook страницы этого профиля, получил отказ и пометил профиль
Уведомление о том, что доступ аккаунта Instagram истёк	Плановое обновление долгоживущего токена этого аккаунта окончательно не удалось

Токены Instagram Business Login истекают по замыслу: они долгоживущие, а не постоянные, так что аккаунт, чьи обновления продолжают проваливаться, в итоге перестаёт работать. Доступ Facebook не несёт даты истечения, за которой AFP мог бы следить — страница или профиль помечаются в первый раз, когда Facebook отклоняет вызов, сделанный с ним.

Тип страницы	Как восстановить доступ
Страница Facebook, или аккаунт Instagram, доступный через неё	Обновите доступ владеющего профиля. AFP отправляет вас на Facebook снова дать согласие и снимает флаг истечения по возвращении; запрос держится пять минут
Отдельный бизнес-аккаунт Instagram	Обновите доступ этого аккаунта. AFP отправляет вас обратно через Instagram Business Login, который сохраняет свежий долгоживущий токен

Автоматическое обновление

Раз в день AFP обновляет долгоживущий токен каждого подключённого аккаунта Instagram, который истекает в течение следующих семи дней, по несколько аккаунтов за раз. Обновление, которое не удаётся из-за того, что авторизация исчезла, помечает доступ аккаунта истёкшим и отправляет уведомление; обновление, которое не удаётся по любой другой причине, оставляет аккаунт нетронутым для повтора на следующем проходе.

Токены страниц Facebook обновляются по запросу, а не по расписанию: отказ вызова — это то, что побуждает AFP заново вывести токен страницы из профиля, которому она принадлежит.

Каталог уведомлений перечисляет уведомление, которое отправляет истёкший токен Instagram, и какие каналы оно достигает.

Подписка страницы на события

События доходят до AFP только для страницы, чья подписка на события зарегистрирована на платформе и подтверждена. Подтверждение — это рукопожатие: платформа вызывает AFP с испытанием и токеном подтверждения, AFP отражает испытание обратно, и события начинают поступать. Рукопожатие, чей токен AFP не распознаёт, отклоняется, и платформа считает подписку незарегистрированной.

Регистрация привязана к кампаниям, а не к подключению. Создание первой кампании на странице регистрирует подписку этой страницы, перепривязка кампании к другой странице регистрирует и новую страницу, а удаление последней кампании на странице снова убирает подписку.

Одна подписка покрывает всё, на что может реагировать кампания на этой странице: активность комментариев на её постах, входящие сообщения и нажатия кнопок внутри этих сообщений.

Примечания

Доступ, сохранённый для страницы, никогда не отправляется в браузер. AFP убирает и токен страницы Facebook, и токен Instagram из каждого списка страниц, который возвращает.
Доступ привязан к странице, а не к аккаунту. Одна истёкшая страница не останавливает другие страницы того же аккаунта, хотя группа профиля Facebook показывает худший статус среди своих страниц.
Профиль, чей доступ Facebook истёк, сохраняет свои подключённые страницы. Страницы остаются на Аккаунтах, помеченные, и снова начинают работать, как только профиль переавторизован.
Отклонение экрана согласия ничего не меняет. Страница или профиль остаются точно такими же, как были, всё ещё помеченными.

Связанное

Подключение страницы — процедура присоединения профиля, подключения его страниц и запуска Instagram Business Login.
События триггеров — четыре события, которые доставляет подписка страницы, и что несёт каждое из них в кампанию.
Каталог уведомлений — уведомления о страницах и токенах, которые отправляет AFP, и куда идёт каждое из них.
Почему моя кампания не отвечает? — как истёкший доступ выглядит в истории выполнений кампании.