Webhooks за интеграции, срок от 30 дни за генерираните отчети и „За какво“ в портфейла

В „Интеграции“ добавяте webhook адрес и външната ви система получава събитията за резервации и клиенти в момента, в който станат. Генерираните отчети се пазят 30 дни, а в портфейла се вижда за какво е всяко захранване и плащане.

✨ Накратко

• Webhooks: адрес за вашата интеграция, избор на събития, тестово изпращане, история на изпращанията и повторно изпращане.
• Генерирани отчети: файловете се пазят 30 дни и после се изтриват автоматично.
• Портфейл: колона „За какво“ в „История на захранванията“ и „Последни плащания“.
• Фактури: редът за захранване казва дали е за тарифен план или за известия.

---

Webhooks за вашата интеграция

Webhook позволява на външна система, например CRM или собствено приложение, да научава за промяна в Reservation.Studio в момента, в който стане, вместо да я пита непрекъснато. Нужен е абонамент, който включва „Външна свързаност“.

Как да добавите адрес

1. Отворете „Интеграции“, в картата „Webhooks“ изберете „Настройки“, после „Нов webhook адрес“.
2. Попълнете „Име“ и „Адрес (URL)“ и изберете поне едно събитие под „Събития“.
3. В „Имейл за известия“ посочете кой да получи писмо, ако адресът бъде спрян.
4. Изберете „Създай“ и копирайте „Тайна на webhook“. Тя се показва само веднъж: интеграцията я ползва, за да провери, че събитията идват от Reservation.Studio.

Кои събития се изпращат

• Резервации: „Резервацията е създадена“, „Резервацията е променена“, „Резервацията е изтрита“ и „Резервацията е възстановена“.
• Участници: „Клиент се записа“, „Статусът на клиента е сменен“ и „Клиент е махнат“.
• Клиенти: „Клиентът е създаден“ и „Клиентът е променен“.

Събитието казва какво се е случило и за кой запис. Пълните данни интеграцията чете от API с API ключ.

Тест, история и нова тайна

• „Изпрати тестово събитие“ от менюто на реда показва какво е отговорил сървърът на интеграцията.
• „История на изпращанията“ показва всяко изпращане. Когато събитие не е стигнало, в подробностите му има „Изпрати отново“.
• „Генерирай нова тайна“ от менюто на реда създава нова тайна и я показва веднъж. Сегашната тайна спира веднага, затова сложете новата в интеграцията.

Кога адресът се спира

Адресът се спира автоматично, когато сървърът отговори, че адресът вече не съществува (410 Gone), или когато всяко изпращане към него се проваля 3 дни. Писмо идва на „Имейл за известия“, а ако полето е празно, до служителя, който е създал адреса.

Подробно, заедно със заглавките и подписа за разработчика: Webhooks.

Колко време се пазят генерираните отчети

Над списъка в „Изтегляне на генерирани отчети“ пише: „Генерираните файлове се пазят 30 дни, след което се изтриват автоматично.“ След този срок файлът и редът му в списъка изчезват.

Бележка

Изтеглете файловете, които ви трябват, преди да са навършили 30 дни. Ако ви трябва изтрит отчет, заявете го отново от отчета, от който сте го генерирали.

Подробно: Изтегляне на генерирани отчети.

Портфейл: за какво е всяко плащане

• „История на захранванията“ има колона „За какво“ с етикет „Тарифен план“ или „Известия“.
• „Последни плащания“ показва „Номер“, „Дата и час“, „За какво“, „Количество“ и „Цена“.
• В „История на захранванията“ захранване без записано предназначение е с тире.

Редът във фактурата

Фактурата за захранване казва за какво е то, например „Тарифен план — захранване на портфейла от 3 ноември 2026“ или „Захранване на портфейла за известия от 3 ноември 2026“. Когато предназначението не е записано, редът е „Захранване на портфейла от 3 ноември 2026“. Така пише във фактурите, които се издават оттук нататък. Издадените фактури не се променят.

Подробно: Портфейл известия и Фактури.