README

Для встановлення пакету ostapovich/facebook через Composer виконайте наступну команду у терміналі або командному рядку:

composer require ostapovich/facebook

Ця команда автоматично завантажить та встановить пакет ostapovich/facebook разом з усіма його залежностями. Після встановлення ви зможете використовувати клас Facebook для взаємодії з Facebook API у вашому проекті.

Конструктор

Створення нового екземпляру класу Facebook.

Параметри

• token (string): Токен доступу до Facebook API.

use Ostapovich\Facebook;

$facebook = new Facebook('YOUR_FACEBOOK_ACCESS_TOKEN');

Методи

setWebhook

Встановлює вебхук з переданими даними та повертає код виклику (hub challenge).

$data = ['hub_challenge' => 'CHALLENGE_STRING'];
$result = $facebook->setWebhook($data);

setSecurityWebhook

Встановлює захищений вебхук з переданими даними та перевірює токен на валідність. Повертає код виклику (hub challenge), якщо верифікація успішна.

$data = [
    'hub_mode' => 'subscribe',
    'hub_verify_token' => 'VERIFY_TOKEN',
    'hub_challenge' => 'CHALLENGE_STRING'
];
$result = $facebook->setSecurityWebhook($data, 'VERIFY_TOKEN');

getMessage

Отримує текст повідомлення з переданого масиву даних.

$data = [
    'entry' => [
        [
            'messaging' => [
                [
                    'message' => [
                        'text' => 'Hello, world!'
                    ]
                ]
            ]
        ]
    ]
];
$result = $facebook->getMessage($data);

getRefData

Отримує дані рефералу з переданого масиву даних.

$data = [
    'entry' => [
        [
            'messaging' => [
                [
                    'postback' => [
                        'referral' => [
                            'ref' => 'REFERRAL_DATA'
                        ]
                    ]
                ]
            ]
        ]
    ]
];
$result = $facebook->getRefData($data);

setStartButton

Встановлює кнопку старту для сторінки Facebook Messenger.

$facebook->setStartButton();

getFacebookUserId

Отримує ідентифікатор користувача Facebook з переданого масиву даних.

$data = [
    'entry' => [
        [
            'messaging' => [
                [
                    'sender' => [
                        'id' => '123456789'
                    ]
                ]
            ]
        ]
    ]
];
$result = $facebook->getFacebookUserId($data);

sendFacebookMessage

Надсилає повідомлення Facebook вказаному користувачеві.

$response = $facebook->sendFacebookMessage('USER_ID', 'Hello, Facebook user!');

getDeepLink

Створює глибоке посилання для бота з переданими даними рефералу.

$bot_url = 'https://m.me/your_bot';
$ref_data = 'REF_DATA';
$deep_link = $facebook->getDeepLink($bot_url, $ref_data);

Цей код створить глибоке посилання з URL бота та реферальними даними, наприклад:

https://m.me/your_bot?ref=REF_DATA

Таким чином, клас Facebook надає зручний інтерфейс для взаємодії з Facebook API у вашому додатку.