# Facebook Messenger

## Як підключити сторінку Facebook

Якщо у вас уже є бізнес-сторінка Facebook, ви можете підключити до неї бота.

{% hint style="warning" %}

#### **ВАЖЛИВО!**

Переконайтеся, що створюєте **Сторінку**а не Групу. Чат-боти у Facebook можна підключати лише до Сторінок.
{% endhint %}

{% hint style="danger" %}
Підключити бота може лише власник сторінки або адміністратор.
{% endhint %}

Спочатку створіть бізнес-сторінку Facebook.

<div data-with-frame="true"><figure><img src="/files/c1c7a42646b4f32ddcca45dc73adf2e61b0fa8f4" alt=""><figcaption></figcaption></figure></div>

Щоб підключити Facebook до MaviBot, перейдіть до розділу «Месенджери» та виберіть Facebook.

<div data-with-frame="true"><figure><img src="/files/5eb83a443755543a79b3b654e51a4380bb930ddd" alt=""><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/cc1552a1744b747ac3552633dcbd64020b25ba59" alt="" width="375"><figcaption></figcaption></figure></div>

У спливному вікні увійдіть, щоб надати доступ до свого облікового запису. Після авторизації ви побачите список ваших бізнес-сторінок, доступних для підключення. Виберіть ту, яку хочете використовувати.

{% hint style="info" %}
Вам можуть запропонувати підключити також ваші **бізнес-акаунти Instagram** але це необов’язково.
{% endhint %}

Далі виберіть сторінку, до якої хочете підключити бота. Потім оберіть дозволи для бота. Обов’язково увімкніть усі перемикачі.

<div data-with-frame="true"><figure><img src="/files/b40e854edbb1004db3f46bc342c5cea9e3bda4a2" alt=""><figcaption></figcaption></figure></div>

Якщо процес успішний, ви побачите таке вікно.

{% hint style="warning" %}
Для сторінки мають бути ввімкнені повідомлення.
{% endhint %}

Після входу до групи ви побачите стандартну кнопку «Start».

Не забудьте додати це слово до умов стартового блоку.

Вітальне повідомлення, яке користувач бачить перед натисканням кнопки «Start», налаштовується в параметрах сторінки Facebook.

### Що робити, якщо потрібної сторінки немає у списку

Якщо ви не бачите потрібної групи у списку, ймовірно, це означає, що у конструктора немає дозволів для цієї групи. Вам потрібно їх надати.

**Для цього:**

Вийдіть із системи за допомогою кнопки у правому верхньому куті.

Натисніть «Log in with Facebook».

<div data-with-frame="true"><figure><img src="/files/d70afc03fbf2f6f1c4c138cc141081eb1e58e5a9" alt="" width="563"><figcaption></figcaption></figure></div>

Натисніть **«Edit settings»**.

Оберіть потрібну сторінку та виконайте всі кроки, описані на початку статті.

## Як створювати розсилки у Facebook

Це стосується будь-яких повідомлень, які ви надсилаєте: через чат-боти, масові розсилки або повідомлення, надіслані вручну.

Коли користувач підписується на чат-бота або ініціює розмову зі сторінкою компанії, у вас є 24-годинне вікно з цього моменту, щоб надсилати користувачеві будь-які повідомлення, зокрема й рекламні.

1. Якщо користувач не відповідає протягом 24 годин, Facebook дозволяє надіслати ще одне повідомлення. Це повідомлення може містити кнопку та сильну пропозицію, щоб привернути увагу підписника й спонукати його відповісти.
2. Якщо користувач відповідає протягом 24-годинного вікна, відкривається нове 24-годинне вікно.
   &#x20;Це відбувається щоразу, коли він відповідає на повідомлення від чат-бота.

У цього правила є кілька винятків.
&#x20;Докладніше: [https://developers.facebook.com/docs/messenger-platform/policy/policy-overview\ <br>](https://developers.facebook.com/docs/messenger-platform/policy/policy-overview)Один із них — це **теги повідомлень** — дозволений тип повідомлення, який можна надсилати навіть після завершення 24-годинного вікна.\
\
Існує 16 типів тегів повідомлень. Ми вирішили використовувати **confirmed\_event\_update** — «Нагадування про подію». У майбутньому ми можемо додати можливість вибирати, який тип повідомлення ви хочете надсилати.

{% hint style="danger" %}
Один**Після 24 годин від останньої взаємодії користувача**ви маєте право надсилати лише повідомлення, пов’язані з нагадуваннями про події — наприклад, підтвердження майбутніх бронювань, сповіщення про зміни в розкладі або нагадування користувачам про записи чи події, на які вони записалися.

**Надсилання будь-якого рекламного контенту після 24-годинного вікна суворо заборонено.**
\
Порушення цього правила може призвести до блокування вашої сторінки Facebook.
{% endhint %}

\
Перевага цього рішення полягає в тому, що розсилки не потребують модерації.
&#x20;Воно також дає вам спосіб обійти правило 24+1.

## Як працювати з Facebook Pixel

{% hint style="success" %}
Щоб встановити Pixel на нашу мінілендінг-сторінку, вам потрібно прив’язати до неї власний домен.
{% endhint %}

Facebook вимагає використання підтверджених доменів. Детальні інструкції щодо встановлення Pixel читайте ТУТ.

## Як створити карусель

<div data-with-frame="true"><figure><img src="/files/77e2f3d5386bcfb181720dd58082dc8a8ccb0759" alt="" width="375"><figcaption></figcaption></figure></div>

{% hint style="success" %}
Карусель може містити від 2 до 10 карток (слайдів).
{% endhint %}

Розгляньмо приклад каруселі з 3 карток. Щоб створити картки, потрібно ввести в поле «Калькулятор» таке.

p = \[
\
{"title": "TITLE", "description": "DESCRIPTION OF CARD 1", "image": "LINK TO IMAGE 1", "buttons": \[{"text": "BUTTON TEXT 1"}]},
\
{"title": "TITLE", "description": "DESCRIPTION OF CARD 2", "image": "LINK TO IMAGE 2", "buttons": \[{"text": "BUTTON TEXT 2"}]},
\
{"title": "TITLE", "description": "DESCRIPTION OF CARD 3", "image": "LINK TO IMAGE 3", "buttons": \[{"text": "BUTTON TEXT 3"}]}
\
]

r = send\_carousel(p, '')

<div data-with-frame="true"><figure><img src="/files/8a4520777fe63dac5522762fe933b5b92865bbdd" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}
Зверніть увагу: рядок **r = send\_carousel(p, '')** слід вводити з нового рядка у полі введення калькулятора.
{% endhint %}

{% hint style="danger" %} <mark style="color:red;">**ЗВЕРНІТЬ УВАГУ!**</mark>

Під час створення опису картки каруселі, як-от

\
{"**title**": "TITLE", "**description**": "DESCRIPTION OF CARD 1", "**image**": "LINK TO IMAGE 1", "buttons":\[{"text":"BUTTON TEXT 1"}]} <br>

важливо **заповнити** або **title** <mark style="color:red;">**та**</mark> **параметр description, або image**.
{% endhint %}

Спочатку призначте масив із title, description, image та buttons змінній p (ви можете назвати змінну інакше). Потім використайте її в методі send\_carousel(p, '').

Ви також можете використати таблицю, щоб просто вставити потрібні заголовки, посилання тощо, а потім просто скопіювати результат у ваш блок.

У полі «Response» залиште #{None}.

<div data-with-frame="true"><figure><img src="/files/e2795c2119f8d36007d36eda363dcb902de542db" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}
Ви можете вставляти URL-адреси в кнопки на картках каруселі. Коли користувач натисне кнопку, його буде перенаправлено за посиланням.
{% endhint %}

Щоб додати посилання до кнопки на картці, включіть його в такий масив:

p = \[
{
"title": "title",
"description": "DESCRIPTION OF CARD 1",
"image": "LINK TO IMAGE 1",
"buttons": \[
{
"text": "BUTTON TEXT 1",
"url": "LINK FOR BUTTON"
}
]
}
]

{% hint style="info" %}
Додано додатковий необов’язковий параметр **payload** до кнопок карток каруселі.
&#x20;Цей параметр не буде видимим для користувача, але дозволить вам відстежувати та аналізувати його вибір.
{% endhint %}

Оскільки часто потрібно мати картки каруселі з однаковим текстом кнопки, додано додатковий параметр під назвою **payload** було додано.

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

<div data-with-frame="true"><figure><img src="/files/53511c43e5e56a217b0fcc8295f1eb430e248f16" alt="" width="563"><figcaption></figcaption></figure></div>

Будь ласка, зверніть увагу на правильне використання:\
p = \[
{
"title": "title",
"description": "DESCRIPTION OF CARD 1",
"image": "LINK TO IMAGE 1",
"buttons":\[{"text": "BUTTON TEXT 1", "payload": "1"}]
},
{
"title": "title",
"description": "DESCRIPTION OF CARD 2",
"image": "LINK TO IMAGE 2",
"buttons": \[{"text": "BUTTON TEXT 1", "payload": "2"}]
}, {
"title": "title",
"description": "DESCRIPTION OF CARD 3",
"image": "LINK TO IMAGE 3",
"buttons": \[{"text":"BUTTONTEXT 1"}]
}
]

Параметр payload є необов’язковим і може бути пропущений, як показано на зображенні кнопки 3.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/uk/chatbot/mesendzheri/facebook-messenger.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.