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

# Каталог подій

> Усі події вебхуків: коли надсилаються і що приходить у data

На сторінці кожної події описані всі поля `data` з типами. Загальні поля тіла — `_id`, `event`, `description`, `timestamp` — описані у [форматі запиту](https://api.zenedu.io/uk/webhooks/overview.md#формат-запиту).

Об’єкти в `data` збігаються з об’єктами API:

* **Підписник** — як в [Отримати підписника](https://api.zenedu.io/uk/api-reference/subscribers/get.md). Поля події (`tag_id`, `product_name` тощо) лежать на одному рівні з полями підписника.
* **Замовлення** — як в [Отримати замовлення](https://api.zenedu.io/uk/api-reference/orders/get.md), підписник у `data.subscriber`.
* **Підписка** — як в [Отримати підписку](https://api.zenedu.io/uk/api-reference/subscriptions/get.md), підписник у `data.subscriber`.
* **Завдання** — як у [Список завдань](https://api.zenedu.io/uk/api-reference/tasks/list.md), плюс `step_name` і `product_name`.

## Замовлення та підписки

| Подія | Коли надсилається | Об’єкт у `data` |
| - | - | - |
| [`order.created`](https://api.zenedu.io/uk/api-reference/webhook-events/order-created) | Підписник оформив замовлення за тарифом | Замовлення |
| [`order.paid`](https://api.zenedu.io/uk/api-reference/webhook-events/order-paid) | Замовлення перейшло в статус `paid` | Замовлення |
| [`order.cancelled`](https://api.zenedu.io/uk/api-reference/webhook-events/order-cancelled) | Замовлення перейшло в статус `cancelled` | Замовлення |
| [`order.refunded`](https://api.zenedu.io/uk/api-reference/webhook-events/order-refunded) | Замовлення перейшло в статус `refunded` | Замовлення |
| [`order.status.changed`](https://api.zenedu.io/uk/api-reference/webhook-events/order-status-changed) | Статус замовлення змінився, попередній статус у `old_status` | Замовлення |
| [`subscription.created`](https://api.zenedu.io/uk/api-reference/webhook-events/subscription-created) | Підписник оформив підписку | Підписка |
| [`subscription.renewed`](https://api.zenedu.io/uk/api-reference/webhook-events/subscription-renewed) | Списано черговий платіж за підпискою | Підписка |
| [`subscription.past_due`](https://api.zenedu.io/uk/api-reference/webhook-events/subscription-past-due) | Черговий платіж за підпискою не пройшов | Підписка |
| [`subscription.cancelled`](https://api.zenedu.io/uk/api-reference/webhook-events/subscription-cancelled) | Підписку скасовано, доступ діє до `expired_at` | Підписка (власна форма), підписник у `subscriber` |

## Підписники

| Подія | Коли надсилається | Об’єкт у `data` |
| - | - | - |
| [`subscriber.added`](https://api.zenedu.io/uk/api-reference/webhook-events/subscriber-added) | У боті з’явився новий підписник | Підписник |
| [`subscriber.unsubscribed`](https://api.zenedu.io/uk/api-reference/webhook-events/subscriber-unsubscribed) | Підписник заблокував бота в Telegram | Підписник |
| [`subscriber.resubscribed`](https://api.zenedu.io/uk/api-reference/webhook-events/subscriber-resubscribed) | Підписник розблокував бота в Telegram | Підписник |
| [`subscriber.contact.created`](https://api.zenedu.io/uk/api-reference/webhook-events/subscriber-contact-created) | Підписник залишив телефон або ел. пошту | Підписник |
| [`subscriber.custom_field.changed`](https://api.zenedu.io/uk/api-reference/webhook-events/subscriber-custom-field-changed) | Змінилося значення додаткового поля підписника | Підписник |
| [`tag.added`](https://api.zenedu.io/uk/api-reference/webhook-events/tag-added) | Підписнику додано тег | Підписник |
| [`tag.removed`](https://api.zenedu.io/uk/api-reference/webhook-events/tag-removed) | У підписника видалено тег | Підписник |

## Продукти та воронки

| Подія | Коли надсилається | Об’єкт у `data` |
| - | - | - |
| [`product.subscriber.added`](https://api.zenedu.io/uk/api-reference/webhook-events/product-subscriber-added) | Підписник отримав доступ до продукту | Підписник |
| [`product.subscriber.started`](https://api.zenedu.io/uk/api-reference/webhook-events/product-subscriber-started) | Підписник почав проходити продукт | Підписник |
| [`product.subscriber.finished`](https://api.zenedu.io/uk/api-reference/webhook-events/product-subscriber-finished) | Підписник пройшов продукт до кінця | Підписник |
| [`product.access.expired`](https://api.zenedu.io/uk/api-reference/webhook-events/product-access-expired) | Закінчився термін доступу підписника до продукту | Підписник |
| [`funnel.subscriber.added`](https://api.zenedu.io/uk/api-reference/webhook-events/funnel-subscriber-added) | Підписника додано до воронки | Підписник |
| [`funnel.subscriber.started`](https://api.zenedu.io/uk/api-reference/webhook-events/funnel-subscriber-started) | Підписник почав проходити воронку | Підписник |
| [`funnel.subscriber.finished`](https://api.zenedu.io/uk/api-reference/webhook-events/funnel-subscriber-finished) | Підписник пройшов воронку до кінця | Підписник |
| [`lesson.opened`](https://api.zenedu.io/uk/api-reference/webhook-events/lesson-opened) | Підписник відкрив урок у додатку | Підписник |
| [`lesson.completed`](https://api.zenedu.io/uk/api-reference/webhook-events/lesson-completed) | Підписник завершив урок у додатку | Підписник |
| [`button.clicked`](https://api.zenedu.io/uk/api-reference/webhook-events/button-clicked) | Підписник натиснув кнопку в кроці | Підписник |

## Канали та групи

| Подія | Коли надсилається | Об’єкт у `data` |
| - | - | - |
| [`channel.subscriber.joined`](https://api.zenedu.io/uk/api-reference/webhook-events/channel-subscriber-joined) | Підписник приєднався до каналу | Підписник |
| [`channel.subscriber.left`](https://api.zenedu.io/uk/api-reference/webhook-events/channel-subscriber-left) | Підписник покинув канал, причина в `reason` | Підписник |
| [`group.subscriber.joined`](https://api.zenedu.io/uk/api-reference/webhook-events/group-subscriber-joined) | Підписник приєднався до групи | Підписник |
| [`group.subscriber.left`](https://api.zenedu.io/uk/api-reference/webhook-events/group-subscriber-left) | Підписник покинув групу, причина в `reason` | Підписник |

## Відповіді та завдання

| Подія | Коли надсилається | Об’єкт у `data` |
| - | - | - |
| [`poll.response.received`](https://api.zenedu.io/uk/api-reference/webhook-events/poll-response-received) | Підписник відповів на опитування | Відповідь |
| [`quiz.response.received`](https://api.zenedu.io/uk/api-reference/webhook-events/quiz-response-received) | Підписник відповів на тест | Відповідь |
| [`quiz.response.correct`](https://api.zenedu.io/uk/api-reference/webhook-events/quiz-response-correct) | Підписник відповів на тест правильно | Відповідь |
| [`quiz.response.wrong`](https://api.zenedu.io/uk/api-reference/webhook-events/quiz-response-wrong) | Підписник відповів на тест неправильно | Відповідь |
| [`question.response.received`](https://api.zenedu.io/uk/api-reference/webhook-events/question-response-received) | Підписник відповів на запитання | Відповідь |
| [`task.received`](https://api.zenedu.io/uk/api-reference/webhook-events/task-received) | Підписник надіслав завдання на перевірку | Завдання |
| [`task.approved`](https://api.zenedu.io/uk/api-reference/webhook-events/task-approved) | Завдання підписника прийнято | Завдання |

## Повідомлення

| Подія | Коли надсилається | Об’єкт у `data` |
| - | - | - |
| [`message.received`](https://api.zenedu.io/uk/api-reference/webhook-events/message-received) | Підписник написав боту | Повідомлення, підписник у `subscriber` |
| [`message.sent`](https://api.zenedu.io/uk/api-reference/webhook-events/message-sent) | Підписнику надіслано повідомлення з чату | Повідомлення, підписник у `subscriber` |

## Тестовий вебхук

| Подія | Коли надсилається | Об’єкт у `data` |
| - | - | - |
| [`webhook.test`](https://api.zenedu.io/uk/api-reference/webhook-events/webhook-test) | Тестовий запит для перевірки адреси | Тестові дані |
| `webhook.test` надсилається лише кнопкою **Надіслати тест** і через [Надіслати тестовий вебхук](https://api.zenedu.io/uk/api-reference/webhooks/test.md). | | |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.