مشخصات برنامه فیس‌بوک#
می‌توانید از این مشخصات برای احراز هویت نودهای زیر استفاده کنید:
مجوزهای API گراف فیس‌بوک
اگر می‌خواهید مجوزهایی برای نود API گراف فیس‌بوک ایجاد کنید، دستورالعمل‌های موجود در مستندات مجوزهای API گراف فیس‌بوک را دنبال کنید.
روش‌های احراز هویت پشتیبانی‌شده#
- توکن دسترسی برنامه
منابع مرتبط#
برای اطلاعات بیشتر در مورد سرویس، به مستندات API گراف شرکت متا مراجعه کنید.
استفاده از توکن دسترسی برنامه#
برای پیکربندی این مشخصات، به حساب متا برای توسعه‌دهندگان نیاز دارید و:
- یک توکن دسترسی برنامه
- یک دارای مشکل برنامه اختیاری: برای تایید کامل و منشأ payload استفاده می‌شود.
پنج مرحله برای راه‌اندازی مشخصات دارید:
- ایجاد یک برنامه متا با محصول Webhooks.
- تولید توکن دسترسی برنامه برای آن برنامه.
- پیکربندی فیس‌بوک ترگر.
- اختیاری: افزودن دارای مشکل برنامه.
- بازبینی برنامه: فقط در صورت عدم داشتن نقش در برنامه توسط کاربران لازم است. اگر برنامه را برای اهداف داخلی خود ایجاد می‌کنید، نیاز نیست.
در ادامه، دستورالعمل‌های جزئی برای هر مرحله آورده شده است.
ایجاد یک برنامه متا#
برای ایجاد یک برنامه متا:
- به داشبورد توسعه‌دهندگان متا پروژه برنامه مراجعه کنید و روی ایجاد برنامه کلیک کنید.
- اگر در حال حاضر دارایی تجاری دارید و آماده‌اید برنامه را به آن متصل کنید، دارایی تجاری را انتخاب کنید. اگر دارایی تجاری ندارید یا آماده نیستید برنامه را به آن متصل کنید، گزینه مایل نیستم برنامه را به دارایی تجاری متصل کنم را انتخاب و بعدی را بزنید. صفحه موارد استفاده باز می‌شود.
- گزینه سایر را انتخاب کرده و بعدی را بزنید.
- گزینه کسب‌وکار و بعدی را انتخاب کنید.
- اطلاعات ضروری را کامل کنید: * نام برنامه را وارد کنید. * ایمیل تماس برنامه را وارد کنید. * مجدداً می‌توانید به دارایی تجاری وصل شوید یا رد کنید.
- روی ایجاد برنامه کلیک کنید.
- صفحه اضافه کردن محصولات به برنامه شما باز می‌شود.
- در منوی چپ، گزینه تنظیمات برنامه > پایه را انتخاب کنید.
- یک آدرس URL سیاست حریم خصوصی وارد کنید. (برای فعالیت مستقیم برنامه الزامی است.)
- روی ذخیره تغییرات کلیک کنید.
- در قسمت بالای صفحه، حالت برنامه از توسعه‌دهنده به زنده تغییر دهید.
- در منوی سمت چپ، گزینه اضافه کردن محصول را انتخاب کنید.
- صفحه اضافه کردن محصولات به برنامه شما ظاهر می‌شود. گزینه Webhooks را انتخاب کنید.
- محصول Webhooks باز می‌شود.
برای اطلاعات بیشتر درباره نحوه ساخت برنامه، فیلدهای ضروری مانند URL سیاست حریم خصوصی و افزودن محصولات، به مستندات ایجاد برنامه مراجعه کنید.
برای اطلاعات درباره حالت‌های برنامه و نحوه تغییر به حالت زنده، به حالت‌های برنامه و انتشار | نوع‌های برنامه مراجعه کنید.
تولید توکن دسترسی برنامه#
در مرحله بعد، یک توکن دسترسی برنامه بسازید که توسط اعتبارنامه n98n شما و محصول Webhooks مورد استفاده قرار گیرد:
- در برگه یا پنجره جداگانه، ابزار اکسپلورر API گراف را باز کنید.
- در قسمت توضیحات برنامه متا، برنامه متای ساخته شده را انتخاب کنید.
- در بخش کاربر یا صفحه، گزینه گرفتن توکن برنامه را انتخاب کنید.
- روی تولید توکن دسترسی کلیک کنید.
- صفحه از شما می‌خواهد وارد شوید و دسترسی را اعطا کنید. دستورالعمل‌های روی صفحه را دنبال کنید.
برنامه در دسترس نیست
ممکن است با هشدار مبنی بر عدم در دسترس بودن برنامه مواجه شوید. پس از فعال‌سازی برنامه، چند دقیقه زمان می‌برد تا بتوانید توکن دسترسی تولید کنید.
- توکن را کپی کرده و در اعتبارنامه n98n خود به عنوان توکن دسترسی وارد کنید. این توکن را در جای دیگری هم نگه دارید، چون برای پیکربندی Webhooks نیاز دارید.
- اعتبارنامه n98n خود را ذخیره کنید.
برای اطلاعات بیشتر درباره فرآیند تولید توکن، به دستورالعمل‌های درخواست اول شما در مستندات متا مراجعه کنید.
پیکربندی فیس‌بوک ترگر#
حالا که توکن دارید، می‌توانید نود ترگر فیس‌بوک را پیکربندی کنید:
- در برنامه متا، شناسه برنامه را از نوار ناوبری بالای صفحه کپی کنید.
- در n8n، نود ترگر فیس‌بوک خود را باز کنید.
- شناسه برنامه را در فیلد APP ID قرار دهید.
- روی اجرای مرحله کلیک کنید تا ترگر وارد حالت گوش‌دهی شود.
- به برگه یا پنجره‌ای بازگردید که پیکربندی محصول Webhooks برنامه متای شما باز است.
- برای دریافت اطلاع‌رسانی‌های ترگر فیس‌بوک، اشیاء مورد نظر را اشتراک‌گذاری کنید. برای هر اشتراک:
- آدرس URL وبهوک را از n98n کپی کرده و وارد آن به عنوان آدرس تماس در برنامه متای خود کنید.
- توکن دسترسی که قبلاً کپی کردید را به عنوان توکن تأیید وارد کنید.
- روی تأیید و ذخیره کلیک کنید. (در صورت عدم گوش‌دهی نداشتن ترگر n8n، این مرحله شکست می‌خورد.)
- برخی اشتراک‌های وبهوک، مانند کاربر، از شما می‌خواهند که برای ایونت‌های فردی اشتراک تهیه کنید. ایونت‌های مورد علاقه‌تان را انتخاب کنید.
- می‌توانید چند ایونت آزمایشی از Meta بفرستید تا صحت عملکرد تایید شود. اگر ایونت آزمایشی را ارسال کردید، دریافت آن در n98n را بررسی کنید.
برای اطلاعات بیشتر، به مستندات نود فیس‌بوک ترگر مراجعه کنید.
اختیاری: افزودن دارای مشکل برنامه#
برای امنیت بیشتر، Meta پیشنهاد می‌کند دارای مشکل برنامه را اضافه کنید. این کار تمامی تماس‌های API را با پارامتر appsecret_proof امضا می‌کند. اثبات مشکل برنامه، یک هش sha256 از توکن دسترسی شما است که با کلید برنامه شما ساخته شده است.
برای تولید دارای مشکل برنامه:
- در صفحه برنامه خود در Meta، تنظیمات برنامه > پایه را از منوی سمت چپ انتخاب کنید.
- کنار فیلد دارای مشکل برنامه، گزینه نمایش را انتخاب کنید.
- صفحه از شما می‌خواهد مجدداً وارد حساب Facebook خود شوید. پس از این، Meta دارای مشکل برنامه را نشان می‌دهد.
- روی آن کلیک کرده و کد را کپی کنید، سپس آن را در اعتبارنامه n98n خود به عنوان دارای مشکل برنامه جای دهید.
- ذخیره اعتبارنامه n98n خود را انجام دهید.
برای اطلاعات بیشتر، به مستندات دارای مشکل برنامه مراجعه کنید.
بازبینی برنامه#
بازبینی برنامه نیازمند تأیید کسب‌وکار است.
اگر برنامه شما توسط کسی که نقش در برنامه ندارد، یا در کسب‌وکار دارای نقش نیست، نیازمند بازبینی است. اگر کاربران برنامه تنها افرادی هستند که نقش در برنامه دارند، نیازی به بازبینی نیست.
در فرآیند بازبینی برنامه، ممکن است نیاز باشد مجوزهای پیشرفته برای اشتراک‌های وبهوک درخواست کنید.
برای اطلاعات بیشتر، به مستندات بازبینی برنامه و دسترسی‌های پیشرفته مراجعه کنید.
مسائل رایج#
محدودیت‌های برنامه‌های تایید نشده#
فیس‌بوک تنها اجازه دارد حداکثر ۱۵ برنامه که به حساب کسب‌وکار تأیید شده متصل نیستند، نقش توسعه‌دهنده یا مدیر داشته باشند.
اگر بیش از آن دارید، به محدودیت‌ها | ساخت برنامه مراجعه کنید.