Настройка приложения Meta для сценария использования с Threads API

В этом документе описана настройка сценария использования с доступом к Threads API, который вы добавили в приложение в процессе его создания.

Настройка сценариев использования

Если вы ещё этого не сделали, перейдите на страницу сценариев использования. Для этого на панели нажмите Сценарии использования или значок с изображением карандаша в левом меню.
Нажмите на сценарий использования, чтобы просмотреть список обязательных и необязательных разрешений для него.
Нажмите на кнопку Добавить справа от каждого разрешения, которое нужно добавить. Если во время разработки вы поймете, что приложение не использует какое-то из этих разрешений, вы сможете вернуться в этот раздел и удалить его.

Threads API use cases permissions

The following table shows the permissions available for the Threads API use case.

Permission	Usage	Allowed actions
`threads_basic`	Required	Cannot be removed.
`threads_content_publish`	Optional.	Can be added or removed.
`threads_delete`	Optional.	Can be added or removed.
`threads_keyword_search`	Optional.	Can be added or removed.
`threads_location_tagging`	Optional.	Can be added or removed.
`threads_manage_insights`	Optional.	Can be added or removed.
`threads_manage_mentions`	Optional.	Can be added or removed.
`threads_manage_replies`	Optional.	Can be added or removed.
`threads_read_replies`	Optional.	Can be added or removed.

Добавлять и удалять разрешения в процессе разработки можно в любое время.

Настройки

В меню слева нажмите Настройки. В этом разделе вы найдете ID приложения Threads и Секрет приложения Threads.
Добавьте следующие URL:
- настройки OAuth клиента — допустимые URI для перенаправления OAuth;
- URL обратного вызова для деавторизации — URL, на который Meta будет отправлять команду ping, если пользователь отменит авторизацию вашего приложения;
- URL для запросов на удаление данных — URL, на который Meta будет отправлять команду ping, если какой-либо пользователь запросит удаление своих данных.
Нажмите Сохранить.
Нажмите Добавить или удалить тестовых пользователей Threads, чтобы добавить тестировщиков для своего приложения. Страница обновится, и на панели откроется раздел Роли в приложении > Роли.
Нажмите на кнопку Добавить людей, чтобы назначить людей на одну или несколько из следующих ролей в приложении:
- администратор;
- разработчик;
- тестировщик;
- пользователь аналитики;
- тестировщик Threads.

Webhooks (необязательно)

Разработчики Meta обычно используют Webhooks, чтобы получать уведомления в режиме реального времени и уменьшить количество вызовов API и таким образом не достигать ограничения числа обращений. Webhooks добавляются автоматически, но использовать их необязательно.

Чтобы получать Webhooks от Meta, вам нужно:

Создать конечную точку на своем сервере, которая будет получать и обрабатывать эти HTTP-уведомления.
Отправить запрос POST, чтобы подписать свое приложения на Webhooks.
Настроить Webhooks на панели своего приложения (шаг, описанный в этом разделе).

Чтобы настроить Webhooks для своего сценария использования на панели приложения, выполните следующие действия. Предполагается, что у вас открыта панель Сценарии использования > Настройка > Настройка сценария использования, и вы выбрали пункт Webhooks в меню.

Выбор продукта — выберите в этом списке объекты, такие как Страница или Рекламный аккаунт, о которых вы хотите получать уведомления.
Добавьте свой URL обратного вызова — конечную точку, которую вы создали для получения Webhooks.
Добавьте свой маркер проверки, который Meta будет использовать при проверке URL обратного вызова.
Чтобы добавить в процесс проверки аутентификацию клиента, переведите переключатель Mutual TLS из положения "Нет" в положение Да (Необязательно)

Примечание. Чтобы получать уведомления Webhooks, приложение должно быть опубликовано. Для использования Webhooks не требуется проходить проверку приложения.

Тестирование (необязательно)

Тестирование требуется, только если вы отправляете приложение на проверку и оно будет получать доступ к данным, которыми вы не владеете или не управляете.

Когда будете готовы протестировать конфигурацию, нажмите Тестирование в меню слева.

Публикация

Примечание. Для некоторых сценариев использования приложение должно быть опубликовано.

When you are ready to publish, select Publish in the left side menu.
Review your use cases and requirements.
Click Publish in the lower right corner.

Если вы хотите стать поставщиком технологий, нажмите Стать поставщиком технологий.

Для поставщиков технологий

Поставщикам технологий и разработчикам приложений, которые будут обслуживать других клиентов или бизнес-портфолио, необходимо выполнить перечисленные ниже действия.

Проверка приложения

Нажмите двойную стрелку рядом с каждым требованием в разделе Подготовьтесь и отправьте запрос на проверку приложения. Перед публикацией приложения необходимо выполнить все требования.

Рядом с выполненными требованиями появляется галочка в кружочке.

Подробнее о проверке приложений см. в этой статье.

Публикация приложения

Нажмите двойную стрелку справа от пункта Убедитесь, что все требования выполнены, а затем опубликуйте приложение. Если какие-то требования не выполнены, появится сообщение и вам нужно будет обеспечить выполнение этих требований.
Когда все требования будут выполнены, нажмите Опубликовать в нижнем правом углу.

После публикации приложения на панели появятся Состояние приложения и Вызовы API за день.

См. также

Ознакомьтесь со следующими статьями, чтобы узнать больше о процессе разработки приложений.