אפליקצית פרסום הודעות בעמוד פייסבוק

תיאור הבעיה: יש לי כמה וכמה עמודי פייסבוק, אני צריך אפליקצית פייסבוק שתעזור לי לפרסם בהם באופן אוטומטי, גם כשאני לא נמצא ליד המחשב. איך אני עושה את זה?

באופן עקרוני, זה די קל – כל מה שאני צריך להבין זה את קונספצית ה-access token של פייסבוק ולעשות כמה צעדים פשוטים. אני יוצא מנקודת הנחה שכל מי שקורא את המאמר הזה יודע מספיק על אפליקציות פייסבוק (קרא את המאמרים הקודמים על אפליקצית פייסבוק) ויודע מספיק PHP. מתישהו בעתיד אני אפרסם בגיטהאב אפליקצית דוגמה שעושה את מה שאני מראה, אבל כאן אני מראה איך עושים את כל תהליך האישור באופן ידני. המתכנת הנבון יכול, אם הוא צריך, לעשות את זה באופן ממוחשב. אם יש לכם אפליקציה שאמורה לעדכן רק כמה דפים באופן סדיר, לא הייתי טורח לעשות אוטומציה בכל פעם.

ראשית, אנחנו צריכים ליצור אפליקצית פייסבוק דרך הממשק של פייסבוק ולשייך אותה לעמוד מסוים. אני יוצא מנקודת הנחה שיצרתם כבר אחת כזו. איך משייכים? נכנסים לקישור הבא:

http://www.facebook.com/add.php?api_key={APP_KEY}&pages

ה-APP_KEY הוא כמובן המפתח של האפליקציה שלכם.

ברגע שאתם מכניסים את ה-URL הזה, אתם יכולים להתקין את האפליקציה על כל עמוד שתבחרו, תבחרו את העמוד שאתם רוצים לפרסם בו ותאשרו.

אחרי שהאפליקציה מותקנת בעמוד שלכם, אנחנו צריכים לקבל את ה-access token שלנו, של המשתמש. ה-access token הזה מאפשר לנו לתת לאפליקציות שונות לפעול בשמנו. לכל מי שיהיה את ה-access token הזה יש בעצם את היכולת לעשות בשמנו בפייסבוק הכל.

איך מג'נרטים את ה- access token?

ידנית:

אנו נכנס ל: https://developers.facebook.com/tools/explorer, נבחר את האפליקציה שלנו ונלחץ על get Acess Token. ה-access token יופיע לנו.

לא ידנית – ניתן לביצוע על ידי סקריפט

הכניסו לדפדפן שלכם את ה-URL הבא:

https://graph.facebook.com/oauth/authorize?type=user_agent&client_id={APP_ID}&redirect_uri={APP_URL}&scope=publish_stream,offline_access,manage_pages

שימו לב, כמובן, להחליף את ה-APP_URL ב-URL של האפליקציה שלכם ואת ה-APP_ID ב-ID של האפליקציה. אם עשינו את הכל כשורה, הדפדפן יפנה אותנו ל-APP_URL עם פרמטר GET ב-URL ששמו הוא access_token.

אחרי שיש לנו את ה-access token, נוכל להמשיך: שימו לב! מדובר בפרמטר ארוך כאורך הגלות.

כפי שציינתי קודם, מדובר ב-token שמאפשר לכל אפליקציה לפעול בשמכם. מה הבעיה איתו? התוקף שלו הוא לשעתיים בלבד. על מנת להאריך אותו ל-60 יום, אנחנו צריכים לייצר access token יותר ארוך. איך עושים את זה? בקלות:

https://graph.facebook.com/oauth/access_token?client_secret={APP_SECRET}&grant_type=fb_exchange_token&fb_exchange_token={SHORTLIVED_ACCESS_TOKEN}

שימו לב לשים את כל הפרטים הנכונים בכתובת – את ה-APP Secret ואת ה-ACCESS TOKEN. אם הכל תקין אנחנו נקבל אובייקט JSON שבו יש Access token אחר לגמרי – זה ה-long live access token. הוא תקף ל-60 יום. זה המקסימום שאפשר לקבל ב-access token של משתמשים, אבל אנחנו רוצים לעשות פעולות לא בשמם של משתמשים, אלא בשמם של דפים – וכאן אפשר לקבל access token שתקף לנצח (או לפחות עד שפייסבוק ישנו שוב את ה-API שלהם).

איך עושים את זה? אנו נעתיק את ה-long term access code ונכניס אותו לכתובת הבאה

https://graph.facebook.com/me/accounts?access_token={TOKEN}

אם עשיתם את הכל כמו שצריך, תקבלו אובייקט JSON ארוך כאורך הגלות (בהתאם למספר הדפים שאתם מנהלים)

{
   "data": [
      {
         "category": "Community",
         "name": "\u05e1\u05d5\u05d3\u05d5\u05ea",
         "access_token": "VERY_VERY_LONG_CODE",
         "perms": [
            "ADMINISTER",
            "EDIT_PROFILE",
            "CREATE_CONTENT",
            "MODERATE_CONTENT",
            "CREATE_ADS",
            "BASIC_ADMIN"
         ],
         "id": "178091852371976"
      },
      {
         "category": "Community",
         "name": "\u05db\u05e0\u05e1 \u05de\u05d9\u05ea\u05d5\u05e4\u05d9\u05d4",
         "access_token": "VERY_VERY_LONG_CODE",
         "perms": [
            "EDIT_PROFILE",
            "CREATE_CONTENT",
            "MODERATE_CONTENT",
            "CREATE_ADS",
            "BASIC_ADMIN"
         ],
         "id": "231715803508970"
      },
   }
}

השינוי המשמעותי בין הדוגמה שלעיל למה שאתם תקבלו הוא שבמקום VERY_VERY_LONG_CODE יהיה לכל דף את ה-access token שהוא מחרוזת די רצינית של מספרים ואותיות. לכל דף יש access token משלו.
אם התמזל מזלכם והשמות של הדפים שלכם באנגלית, אתם תוכלו לראות אותם. אבל אם שמות הדפים בעברית, רואים אותם בקידוד. איך מבדילים בין דף לדף? פשוט לפי ה-ID שלו. איך מבררים את ה-id של הדף? משתמשים בכלי כזה למשל: http://findmyfacebookid.com/

זה access token שאפשר להשתמש בו והוא אמור להיות לנצח. איך נדע מה התוקף שלו? בקלות:

ידנית

הולכים אל https://developers.facebook.com/tools/debug/access_token ומכניסים את ה-access token של העמוד. אם הכל תקין, תוכלו לראות -expires: never.

אחרי שיש לנו את ה-access token ארוך הטווח, כל מה שנותר לנו לעשות זה להריץ את קוד ה-PHP הזה בכל פעם שאנחנו רוצים לפרסם הודעה. זה יכול להיות עם cron, או בכל דרך אחרת שמתחשק לכם:

include_once("facebook.php");

$page_id = 'YOUR PAGE ID';
$page_access_token = 'LONG LONG TOKEN';


function message($data) {   
        $data['access_token'] = $page_access_token;

        $ch = curl_init();
 
        curl_setopt($ch, CURLOPT_URL, $this->post_url);
        curl_setopt($ch, CURLOPT_POST, 1);
        curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
 
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
 
        $return = curl_exec($ch);
        curl_close($ch);

        return $return;        
}

$post_url = 'https://graph.facebook.com/'.$page_id.'/feed';
	message(array( 'message'     => 'The message header', 
				  'link'        => 'https://internet-israel.com', 
				  'picture'     => 'http://some-image.jpg',
				  'name'        => 'Name of the picture, shown just above it', 
				  'description' => 'Full description explaining whether the header or the picture' ) );

כמובן שצריך לעשות error handling (כי try catch לא עובד הכי טוב עם cURL, אבל יש דרכים אחרות) אבל נתתי כאן את הקוד הבסיסי ביותר.

הלוואי שהייתי יכול לומר שהדוקומנטציה של פייסבוק עזרה לי פה, אבל היא היתה לעזר מועט ביותר.