> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shopillect.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Telegram

> Як налаштувати Telegram-сповіщення для вашого магазину

## Для чого потрібен Telegram-бот

Telegram-бот дозволяє отримувати сповіщення про події у вашому магазині прямо в Telegram. Ви будете в курсі нових замовлень, доставок та оплат без необхідності постійно перевіряти Shopify Admin.

## Що потрібно для підключення

* Telegram-акаунт
* Telegram-бот (створюється безкоштовно)
* Chat ID (ідентифікатор чату, куди бот надсилатиме повідомлення)

## Як створити Telegram-бота

<Steps>
  <Step title="Відкрийте BotFather">
    У Telegram знайдіть бота @BotFather — це офіційний бот для створення інших ботів.
  </Step>

  <Step title="Створіть нового бота">
    Надішліть команду /newbot. BotFather попросить вказати:

    * Назву бота (наприклад, "My Store Notifications")
    * Username бота (має закінчуватися на "bot", наприклад my\_store\_bot)
  </Step>

  <Step title="Збережіть токен">
    Після створення BotFather надасть вам Bot Token — довгий рядок символів. Збережіть його, він знадобиться далі.
  </Step>

  <Step title="Отримайте Chat ID">
    Додайте бота до групи або напишіть йому напряму. Потім використайте спеціальних ботів (наприклад, @userinfobot) або надішліть повідомлення і перевірте Chat ID через Telegram API.
  </Step>
</Steps>

## Як підключити бота до Shopillect

<Steps>
  <Step title="Відкрийте налаштування Telegram">
    У Shopify Admin перейдіть до Shopillect → Integrations → Telegram.
  </Step>

  <Step title="Введіть Bot Token">
    Вставте токен бота, який ви отримали від BotFather.
  </Step>

  <Step title="Введіть Chat ID">
    Вкажіть Chat ID чату або групи, куди бот надсилатиме сповіщення. Це поле необов'язкове — його можна вказати пізніше.
  </Step>

  <Step title="Оберіть типи сповіщень">
    Вкажіть, які сповіщення ви хочете отримувати:

    * **Замовлення** — нові замовлення, скасування, зміни
    * **Комунікація** — повідомлення від покупців
    * **Доставка** — створення відправок, зміни статусу
    * **Фінанси** — оплати, повернення коштів
  </Step>

  <Step title="Перевірте з'єднання">
    Натисніть "Test Connection" — бот надішле тестове повідомлення у вказаний чат. Якщо все працює, ви побачите повідомлення.
  </Step>

  <Step title="Збережіть налаштування">
    Натисніть "Save" для збереження. Тепер ви отримуватимете сповіщення.
  </Step>
</Steps>

## Які сповіщення надсилаються

| Тип             | Що надсилається                                           |
| --------------- | --------------------------------------------------------- |
| **Замовлення**  | Нове замовлення з деталями: номер, сума, товари, покупець |
| **Комунікація** | Повідомлення від покупців через магазин                   |
| **Доставка**    | Створення ТТН, зміна статусу відправки                    |
| **Фінанси**     | Оплати, часткові повернення, повні повернення             |

## Інтеграція з Shopify Flow

Якщо вам потрібні кастомні сповіщення, ви можете використовувати Shopify Flow для надсилання повідомлень через Telegram-бота Shopillect. Це дозволяє створювати власні сценарії з будь-якими тригерами Shopify і ставити їх на автопілот.

<Info>
  Налаштування Shopify Flow доступне на сторінці інтеграції Telegram після підключення бота.
</Info>