Каналы уведомлений
Каналы уведомлений — это способы, которыми система связывается с гостями: письма о подтверждении брони, коды подтверждения (OTP), напоминания, чеки об оплате. Учётные данные каналов задаются на уровне организации и используются всеми её объектами.
Каналов три: Email, SMS и WhatsApp. У каждого свой раздел в настройках организации.
Email-канал отвечает за письма гостям: подтверждения бронирований, коды входа, чеки, уведомления.
Как это работает
Заголовок раздела «Как это работает»- Если собственный провайдер не подключён, письма уходят через общий сервис StayBase с лимитами вашего тарифа.
- Чтобы письма уходили от вашего домена, подключите собственного email-провайдера.
Подключение
Заголовок раздела «Подключение»Нажмите «Добавить провайдера» — откроется каталог провайдеров, доступных в стране организации (шаг 1 из 2). Каждый провайдер — плитка: логотип, название, где хранятся данные писем (США, ЕС), отметки «Домен отправителя» и «События доставки» — умеет ли провайдер подтверждать ваш домен и сообщать о доставке, и ссылка «Документация» на его сайт. Плитки собраны в две группы:
- Можно подключить — Postmark, Resend и универсальный SMTP: у каждой плитки кнопка «Подключить». Если провайдер этого типа уже подключён, вместо кнопки стоит метка «Подключён» — второй такой же не заводится.
- Скоро — Amazon SES, Mailgun, SendGrid: плитки пунктиром. Они ещё не прошли проверку на живом аккаунте, поэтому подключаются по заявке — см. ниже.
Поле «Найти по названию» над плитками фильтрует список. Каталог собирается по стране из настроек организации: провайдер, который работает только в другой стране, в нём не появится; если страна не указана, каталог попросит сначала заполнить её.
Провайдер помечен «Скоро»
Заголовок раздела «Провайдер помечен «Скоро»»На плитке есть кнопка «Запросить подключение» — форма не нужна, провайдер и канал уже известны. Нажатие заводит обращение в разделе Поддержка, а плитка получает метку «Запрос отправлен» с номером обращения; второй раз попросить нельзя. Поддержка ответит в этом обращении, что подготовить: аккаунт у провайдера и API-ключ, а если карточка попросит адрес вебхука — вписать его в кабинете провайдера. Ключи в обращение не присылайте.
Когда доступ открыт, плитка становится сплошной с меткой «Открыт для вас» и обычной кнопкой «Подключить». Введите ключ в форму как у любого провайдера и напишите в то же обращение — поддержка проверит отправку и доставку в течение двух рабочих дней. Тестовые письма придут на адрес, с которого открыто обращение.
Провайдера нет в списке
Заголовок раздела «Провайдера нет в списке»Под плитками — блок «Нужен другой провайдер?». Нажмите «Написать», впишите название или сайт провайдера (комментарий — по желанию) и отправьте: заведётся обращение, поддержка вернётся с ответом в нём.
Нажмите «Подключить» у выбранного провайдера — откроется форма данных доступа (шаг 2 из 2). Сверху — выбранный провайдер с подсказкой, что взять в его кабинете, и ссылка «К каталогу», чтобы вернуться и выбрать другого. Укажите:
- Email отправителя — адрес, с которого будут уходить письма. Домен из этого адреса используется для проверки прав на отправку.
- Имя отправителя — как гость увидит отправителя в почте (необязательно).
- Дневной и месячный лимиты — необязательное ограничение количества писем, чтобы не превысить квоту провайдера.
- Учётные данные — для Postmark и Resend это API-ключ (Server API Token у Postmark); для SMTP — хост, порт, шифрование (TLS), логин и пароль.
- Включить отправку — переключатель, делающий провайдера активным. Можно сохранить провайдера выключенным и включить позже.
После подключения система покажет таблицу DNS-записей (DKIM, Return-Path, SPF, DMARC), которые нужно добавить для вашего домена — это подтверждает право отправлять письма от вашего имени и защищает их от попадания в спам. Каждую запись можно скопировать кнопкой. Статус домена показан бейджем: Ожидает DNS, Подтверждён, Ошибка или Не требуется. Кнопка «Проверить» запускает повторную проверку DNS.
При редактировании провайдера тип менять нельзя — он зафиксирован. Учётные данные по умолчанию не показываются (видна только маска вида apiKey: pm_••••); чтобы заменить ключ, включите переключатель «Обновить».
Состояние отправок
Заголовок раздела «Состояние отправок»На карточке провайдера, между лимитами и строкой последнего теста, стоит блок «Состояние» — сводка за последние 24 часа в четырёх ячейках:
- Последняя отправка — время и счётчики: сколько писем отправлено, из них сколько тестов, сколько отказов. Тесты считаются отдельно и в отказы не входят.
- Последнее событие доставки — время и исход (доставлено, не доставлено, жалоба на спам). Пока событий не было — прочерк.
- Последний отказ — время, короткое имя причины и что делать: например «Ключ не принят — проверьте ключ в кабинете провайдера и введите заново». Ячейка подсвечена предупреждением; когда отказов за сутки не было — обычный текст «Отказов не было».
- События доставки — состояние вебхука: «Подключены», «Ждём первое событие» (адрес вписан, отправьте тестовое письмо и подождите минуту) или «Не подключены» (впишите адрес вебхука в кабинете провайдера). Если письма уходят, а события перестали приходить, ячейка тоже подсвечивается. Кнопка «Подключить заново» живёт здесь же — у провайдеров, где адрес регистрируется автоматически.
Подсветка одна — предупреждение; зелёного «всё хорошо» нет, здоровое состояние — обычный текст. Большинство отказов вы закрываете сами по подсказке в ячейке. Кнопка «Написать в поддержку» появляется только когда провайдер не отвечает или отклонил отправку без понятной причины: она заводит обращение с временем и текстом отказа, ничего вписывать не нужно.
SMS-канал отправляет гостям коды входа (OTP). Подключается ваш собственный аккаунт у SMS-провайдера — вы платите провайдеру напрямую по его тарифам, StayBase SMS не продаёт.
Как это работает
Заголовок раздела «Как это работает»- Если SMS-провайдер не подключён, коды входа уходят гостю на email вместо SMS.
- Для отправки SMS нужно подключить провайдера и зарегистрировать имя отправителя и тексты кодов у операторов — как именно, зависит от страны. Какого провайдера выбрать и что регистрировать — на странице Подключить SMS-провайдера.
Подключение
Заголовок раздела «Подключение»Нажмите «Добавить провайдера» — откроется каталог провайдеров, доступных в стране организации (шаг 1 из 2). Каждый провайдер — плитка: логотип, название, страны, из которых он принимает клиентов (или «Любая страна»), где хранятся данные сообщений, отметки «Отчёты о доставке», «Код в мессенджер» и «Имя без регистрации» — умеет ли провайдер сообщать о доставке, отправлять код в Telegram или WhatsApp и работать без регистрации имени отправителя в вашей стране — и ссылка «Документация» на его сайт. Плитки собраны в две группы:
- Можно подключить — у каждой плитки кнопка «Подключить». Если провайдер этого типа уже подключён, вместо кнопки стоит метка «Подключён» — второй такой же не заводится. Пока в этой группе только Mock (для тестов).
- Скоро — Mobizon, SMSC.kz, Kazinfoteh (Казахстан), Eskiz, Playmobile (Узбекистан), Twilio и seven.io (любая страна): плитки пунктиром с кнопкой «Запросить подключение». Они ещё не прошли проверку на живом аккаунте и подключаются по заявке — как это идёт и сколько занимает, на странице Подключить SMS-провайдера.
Поле «Найти по названию» над плитками фильтрует список. Каталог собирается по стране из настроек организации: провайдер, который работает только в другой стране, в нём не появится; если страна не указана, каталог попросит сначала заполнить её. Нет нужного провайдера — блок «Нужен другой провайдер?» под плитками заводит обращение.
Нажмите «Подключить» у выбранного провайдера — откроется форма подключения (шаг 2 из 2). Сверху — выбранный провайдер с подсказкой, что взять в его кабинете, и ссылка «К каталогу», чтобы вернуться и выбрать другого. Укажите:
- Имя отправителя — подпись, которую гость видит вместо номера (2–11 латинских символов, цифр, пробела, точки, дефиса или подчёркивания). Над полем — что требует ваш провайдер: регистрацию у операторов с абонплатой (Казахстан), одобрение имени с общим номером до одобрения (Узбекистан) или ничего (Германия). Пока своё имя не зарегистрировано, укажите общее имя провайдера — оно подсказано в поле.
- Заметка — необязательный комментарий, например номер и дата заявки на регистрацию имени.
- Дневной и месячный лимиты — необязательные ограничения.
- Учётные данные — поля зависят от провайдера и подписаны так, как они называются в его кабинете (API-ключ, логин и пароль, секретный ключ вебхука и т. п.).
- Код сначала в мессенджер — только у провайдеров, которые умеют отправлять код в Telegram или WhatsApp по номеру телефона (SMSC.kz, Kazinfoteh). Включите переключатель и задайте, сколько секунд ждать доставки (10–60): код сначала уходит в мессенджер, а если не доставлен за это время — тем же провайдером в SMS.
- Отчёты о доставке — у части провайдеров адрес для отчётов нужно вписать в их кабинете: он появится в форме и на карточке после сохранения, с кнопкой копирования. У остальных отчёты подключаются сами — их состояние показано в ячейке «Отчёты о доставке» блока «Состояние» на карточке, там же кнопка «Подключить заново», если провайдер отказал. Что означают ячейки — в разделе Состояние отправок выше, у SMS они те же: «Последний отчёт о доставке» вместо события и «Отчёты о доставке» вместо событий.
- Шаблоны для регистрации — четыре текста кода на русском, английском, казахском и немецком. Зарегистрируйте их у провайдера как верификационные шаблоны, иначе коды пойдут по рекламному тарифу или не пройдут фильтр операторов.
- Включить отправку — переключатель, делающий провайдера активным. Активным может быть один SMS-провайдер организации.
При редактировании форма открывается сразу, без каталога, и тип провайдера менять нельзя. Учётные данные не показываются (видна только маска); чтобы заменить ключи, включите переключатель «Обновить».
Имя отправителя
Заголовок раздела «Имя отправителя»Статус имени показан в карточке провайдера:
| Статус | Что означает |
|---|---|
| Ожидает регистрации | Имя отправлено на согласование оператору связи |
| Подтверждён | Имя одобрено, SMS уходят с ним |
| Отклонён | Имя не прошло проверку, нужно выбрать другое |
| Не требуется | Регистрация имени для этого провайдера не нужна |
Статус проставляет команда StayBase по итогам согласования с оператором, поэтому в карточке он показан как информационный.
WhatsApp-канал позволяет отправлять гостям сообщения через WhatsApp Business.
Как это работает
Заголовок раздела «Как это работает»- Канал работает через Meta WhatsApp Cloud API.
- Для тестов доступен режим Mock, который имитирует отправку без реальных сообщений.
- Объект может использовать отдельный номер — он задаётся в настройках объекта.
Подключение
Заголовок раздела «Подключение»При добавлении провайдера указываются:
- Тип провайдера — Meta WhatsApp Cloud API или Mock (для тестов).
- Phone number ID — числовой идентификатор номера из кабинета Meta (10–20 цифр), это не сам телефонный номер.
- WABA ID — идентификатор аккаунта WhatsApp Business (необязательно).
- Имя отправителя — отображаемое имя в чатах (необязательно).
- Дневной и месячный лимиты — необязательные ограничения.
- Учётные данные — System user access token из кабинета Meta; при желании можно указать версию Graph API (по умолчанию используется актуальная).
В карточке провайдера также есть кнопка «Тест отправки» для проверки отправки и подсказка о том, что номер должен быть верифицирован в кабинете Meta.