Начало работы с Mailoo

В этом руководстве — то, что Mailoo реально даёт сегодня: проекты, интеграции FORM / CONTACT_FORM / JSBOX / BLOG, доступ через вебхуки и API-ключи, а также экраны панели для сообщений и подписчиков.

Что понадобится

Перед началом убедитесь, что у вас есть:

  • Аккаунт Mailoo (через настроенного поставщика идентичности)
  • Проект в панели, где хранятся интеграции и ключи API
  • Безопасное место для ключей API (сервер, BFF или автоматизация — не браузерный бандл)

Совет

Заводите отдельные ключи для staging и production и используйте RESTRICTED-области, пока не ясно, какой вебхук нужен каждой интеграции.

Создание аккаунта

Начните со страницы входа и выполните шаги:

  1. Откройте сайт Mailoo и выберите «Начать бесплатно» или «Войти».
  2. Пройдите аутентификацию у поставщика (например Keycloak).
  3. В панели создайте или выберите проект.
  4. Запишите UID проекта — он нужен в вебхуках и публичных URL блога.

Панель доступна в любой момент; сессии настраиваются через Auth.js и ваш IdP.

Первая интеграция

Mailoo не подключает чужие почтовые ящики. Вы добавляете интеграцию по тому, как посетители взаимодействуют с сайтом:

Шаг 1: Раздел интеграций

  1. В проекте откройте «Интеграции» или «Добавить интеграцию».
  2. Посмотрите доступные типы для вашего тарифа.
  3. Выберите FORM, CONTACT_FORM, JSBOX или BLOG в зависимости от задачи.

Шаг 2: Настройки типа

  1. Дайте понятное имя, чтобы команде было ясно, какой это сайт или форма.
  2. Укажите allowed origins, URL вебхуков или параметры виджета.
  3. Создайте API-ключ с нужными областями (формы, чат и т.д.).
  4. Храните ключ на сервере — не вставляйте FULL-ключи в клиентский JS.
  5. Сохраните интеграцию и убедитесь, что статус «Активна».

Шаг 3: Подключение кода

  1. Направьте backend или BFF на задокументированный вебхук по HTTPS.
  2. Передавайте тело запроса в формате из руководства по интеграции.
  3. Для JSBOX добавьте загрузчик и идентификаторы из панели.
  4. По желанию: настройте исходящий SMTP на интеграции перед рассылками.

Проверка

Проверьте цепочку до продакшена:

  1. Отправьте тест из staging (форма, чат или публикация в блоге).
  2. Дождитесь ответа вебхука или обновления панели.
  3. Откройте «Сообщения» и проверьте метаданные, статус и связь с интеграцией.
  4. Для FORM загляните в «Подписчики» с тестовым email.

Если что-то не так

Если за несколько минут ничего не появилось:

  • • Убедитесь, что область ключа соответствует вызванному вебхуку.
  • • Проверьте UID проекта и ID интеграции в URL или теле запроса.
  • • Ищите ответы 4xx в логах сервера (CORS, подпись, валидация).
  • • Напишите в поддержку с ID интеграции и примерным временем запроса.

Дальше

Когда первая интеграция стабильна:

  • Добавьте другой тип (например JSBOX рядом с FORM).
  • Настройте шаблоны и кампании для подписчиков.
  • Прочитайте руководство по формам и BFF для Next.js.
  • Откройте OpenAPI на /docs/v1 вашего API-деплоя.

Полезно прочитать

Чеклист быстрого старта →Интеграция форм на сайте →Обзор интеграций →Headless-блог →
← К документацииДалее: чеклист быстрого старта →