Mailoo помогает управлять формами на сайте, списками подписчиков, headless-блогом, каталогом товаров, публикацией в социальных сетях и виджетом чата JSBOX из одной панели управления. Вы подключаете свой продукт через серверные вебхуки и API-ключи --- Mailoo не является коннектором к почтовому ящику.
Что потребуется
- Учётная запись Mailoo через настроенного поставщика удостоверений
- Проект в панели управления, к которому привязаны интеграции и API-ключи
- Серверная часть или BFF с возможностью безопасно хранить секрет
X-API-Key
Шаг 1: Создание учётной записи и проекта
-
Перейдите на https://mailoo.app и нажмите Начать (или Войти).
-
Пройдите аутентификацию у вашего поставщика удостоверений (IdP). Отдельной формы регистрации внутри панели управления Mailoo нет: Войти / Начать открывает IdP. Вход, регистрация, сброс пароля и подтверждение электронной почты происходят на брендированных страницах IdP Mailoo. Языки соответствуют сайту (английский, немецкий, испанский, русский). Светлая и тёмная тема соответствуют теме, выбранной на mailoo.app.
-
Создайте проект в панели управления и сохраните его
projectUid.Владельцы проекта могут приглашать участников с ролью OWNER или EDITOR (опционально с ограничением на конкретную интеграцию). Приглашённые участники входят и принимают приглашение по ссылке.
Шаг 2: Добавление первой интеграции
- Откройте раздел Интеграции внутри проекта (или выберите Добавить интеграцию).
- Выберите тип, соответствующий вашей задаче:
- FORM --- подписка на рассылку или сбор лидов
- CONTACT_FORM --- сообщения поддержки или обратной связи
- JSBOX --- встраиваемый чат в реальном времени
- BLOG --- редакционный контент через публичный API блога
- MARKET --- каталог товаров, заказы и генераторы коммерческих предложений
- SOCIAL --- публикации в X и Facebook
- Завершите мастер настройки (необязательные разрешённые источники, отображаемые имена и параметры подключения для конкретного типа).
Шаг 3: Подключение приложения
- Формы: вызывайте Mailoo с сервера или BFF с ограниченным API-ключом, хранящимся в переменных окружения. Для Next.js предпочтительнее использовать BFF-хелперы
@mailoo/forms. - Чат: встройте виджет JSBOX (или
@mailoo/chat), передайте идентификаторы проекта и интеграции, а для операторов используйте консоль чата в панели управления. - Блог / Каталог: публикуйте через панель управления, затем читайте данные на вашем сайте через внешние API с
X-API-Key. - Социальные сети: добавьте учётные данные каналов в разделе Подключение и настройки, затем создавайте и публикуйте записи в панели управления.
- Агенты (необязательно): создайте токен MCP-агента в разделе Профиль → Безопасность → Токены MCP и укажите вашему MCP-хосту адрес
https://mcp.mailoo.app/mcp. Подробнее:integrations/mailoo-mcp{.interpreted-text role="doc"}.
Шаг 4: Проверка сообщений и подписчиков
- Отправьте тестовую заявку из безопасного окружения.
- Убедитесь, что запись появилась в разделе Сообщения с ожидаемыми метаданными.
- Для интеграций FORM проверьте, что в разделе Подписчики зафиксирован тестовый e-mail.
Дополнительно: исходящая почта (SMTP)
Письма подписчикам (ответы, приветственные серии, транзакционная отправка, подтверждения заказов из каталога) отправляются через SMTP-реквизиты, сохранённые в интеграции. Автоматического переключения на общую платформенную почту не предусмотрено --- настройте SMTP перед использованием этих функций. Подробнее: integrations/outbound-smtp{.interpreted-text role="doc"}.
Следующие шаги
quick-setup{.interpreted-text role="doc"} --- чек-лист для быстрого запуска в продакшен- Руководства по интеграциям в разделе Интеграции
- Схемы OpenAPI:
https://api.mailoo.app/docs/v1