تم تحديث هذا المستند.
لم تكتمل الترجمة إلى اللغة ‏العربية‏ حتى الآن.
تاريخ تحديث المصدر باللغة الإنجليزية: ‏٩ سبتمبر
تاريخ تحديث اللغة ‏العربية‏: ‏١١ يونيو

Customize a Meta app with the Access the Threads API Use Case

This document shows you how to customize the Access the Threads API use case you added to your app during the app creation process.

Customize use cases

  1. If you are not already on the Use cases page of the dashboard, click Use cases, or the pencil icon, in the left-side menu.
  2. Click on a use case to view the permissions that are available, both required and optional, for this use case.
  3. Click the Add button to the right of each permission you'd like to add. If, during development, you find that your app doesn't use the permission, you can return here and remove it.

Threads API use cases permissions

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

PermissionUsageAllowed 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.

You can add and remove permissions at any time during the development process.

Settings

  1. In the left side menu, click Settings. You'll find your Threads app ID and Threads app secret.
  2. Add the following URLs:
    • Client OAuth Settings – valid OAuth redirect URIs
    • Deauthorize callback URL – the URL Meta will ping when a user deauthorizes your app
    • Data Deletion Requests URL – the URL Meta will ping when someone requests that you delete their data
  3. Click Save.
  4. Click the Add or Remove Threads Test Users to add testers to your app. The page will refresh to the App roles > Roles page in the dashboard.
  5. Click the Add People button to add people as to one or more of the following app roles:

    • Adminstrator
    • Developers
    • Testers
    • Analytics Users
    • Threads Testers

Webhooks (اختياري)

يستخدم غالبية مطوّري Meta أحداث webhooks للحصول على إشعارات فورية وتقليل عدد استدعاءات API، وبالتالي تقليل معدل تغيير تقييد معدلات الاستدعاء. تتم إضافة أحداث Webhooks تلقائيًا ولكنها تظل اختيارية.

لاستلام أحداث webhooks من Meta، ستحتاج إلى ما يلي:

  1. إنشاء نقطة نهاية على الخادم لاستلام إشعارات HTTP هذه ومعالجتها
  2. إرسال طلبPOST لتسجيل اشتراك التطبيق في أحداث webhooks
  3. تكوين أحداث webhooks في لوحة معلومات تطبيقك (الخطوة المذكورة في هذا القسم)

لتكوين أحداث webhooks لحالة الاستخدام الخاصة بك في لوحة معلومات التطبيق، اتبع الخطوات التالية. تفترض هذه الخطوات أنك موجود في لوحة معلومات حالات الاستخدام > تخصيص > تخصيص حالة الاستخدام وأنك قد حددت خيار Webhooks في القائمة.

  1. تحديد المنتج - في القائمة المنسدلة، حدد الأصول، مثل الصفحة والحساب الإعلاني، الذي تريد استلام إشعارات بشأنه.
  2. أضف رابط الاستدعاء، نقطة النهاية التي أنشأتها لاستلام أحداث webhooks.
  3. أضف رمز التحقق الذي ستستخدمه Meta كجزء من عملية التحقق من صحة رابط الاستدعاء.
  4. يمكنك إضافة مصادقة العميل إلى عملية التحقق عن طريق تبديل أمان طبقة النقل المتبادلة من الخيار "لا" إلى الخيار "نعم". (اختياري)

ملاحظة: لاستلام إشعارات webhook، يجب نشر تطبيقك. لا يلزم الخضوع لعملية مراجعة التطبيقات لاستخدام أحداث webhooks.

Testing (Optional)

Testing is only required if you are submitting your app for App Review; if your app will access data you don't own or manage.

  1. Click Testing in the left-side menu if you are ready to test your configuration.

Publish

Note: Some use cases require your app to be published.

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

If you would like to become a Tech Provider click Become a Tech Provider.

For Tech Providers

The following steps must be completed if you're a Tech Provider, your app will serve clients or other business portfolios.

App Review

  1. Click the chevron next to each requirement listed under Prepare and submit for App Review. You must complete each requirement before publishing your app.

A checkmark within a circle appears when each of these requirements has been completed.

Learn more about App Review.

Publish your app

  1. Click the chevron to the right of Check that all requirements are met, then publish your app. If any requirements have not yet been met, messaging will appear and you will need to satisfy those requirements.
  2. Once you have successfully completed all the requirements, click Publish in the lower-right corner.

After your app has been published, the Dashboard will show App Health with Daily API Calls.

See Also

Visit the following to learn more about the app development process: