Используйте этот чек-лист, чтобы запустить Mailoo за один подход.
Предварительные требования
- Учётная запись Mailoo с доступом к панели управления
- Созданный проект в вашем рабочем пространстве
- API-ключи с областями действия, необходимыми для каждого вебхука
Пятиминутный план
1. Подготовка проекта (1 минута)
: Проверьте имя, скопируйте projectUid и определите, кто ротирует ключи.
2. Создание интеграции (2 минуты)
: Добавьте FORM, CONTACT_FORM, JSBOX, BLOG, MARKET или SOCIAL; при необходимости задайте разрешённые источники; скопируйте UID проекта, ID интеграции и примечания из раздела Подключение и настройки.
3. Подключение серверной части (2 минуты)
: Сохраните X-API-Key в переменных окружения, перенаправляйте отправки форм из BFF или встройте загрузчик чата на маркетинговый сайт. Никогда не размещайте API-ключи в клиентском JavaScript.
4. Отправка тестового события
: Отправьте синтетическую запись формы или откройте виджет чата и убедитесь, что в панели управления появилось новое сообщение.
Подсказки по сценариям
Маркетинговая рассылка
: Используйте интеграцию FORM и отправляйте данные с серверного маршрута. Настройте исходящий SMTP, если вы отправляете приветственные или подтверждающие письма через Mailoo.
Контактная форма поддержки
: Используйте CONTACT_FORM с ограниченным ключом и паттерн перенаправления обратной связи для Next.js (integrations/feedback-form-nextjs-example{.interpreted-text role="doc"}).
Редакционный сайт
: Создайте интеграцию BLOG, опубликуйте статью и получите её через внешний API блога (integrations/blog-headless-cms{.interpreted-text role="doc"}).
Чат в реальном времени
: Настройте JSBOX (при необходимости ограничьте источники вашим HTTPS-хостом) и направьте операторов через консоль чата в панели управления.
Витрина каталога
: Создайте интеграцию MARKET, добавьте товары и вызовите внешний API каталога с market.external-read (integrations/market-catalog-external-api{.interpreted-text role="doc"}).
Публикация в социальных сетях
: Создайте интеграцию SOCIAL, сохраните учётные данные X и/или Facebook, затем создайте и опубликуйте запись (integrations/social-networks{.interpreted-text role="doc"}).
Автоматизация через агентов
: Создайте токен MCP в разделе Профиль → Безопасность и подключите ваш MCP-хост (integrations/mailoo-mcp{.interpreted-text role="doc"}).
Проверочный чек-лист
- Статус интеграции --- Активна
- Тестовое сообщение или контент отображается с ожидаемыми метаданными
- Области действия API-ключа соответствуют каждому используемому вебхуку
- Исходящий SMTP настроен перед включением ответов подписчикам или e-mail заказов
Устранение неполадок
Вебхук отклонён
: Перепроверьте области действия, UID проекта, ID интеграции и формат JSON-тела запроса.
Виджет чата не работает
: Если проверка Origin не проходит, убедитесь в корректности разрешённых источников, HTTPS и совпадении идентификаторов встраивания с записью в панели управления.
API блога или каталога пуст
: Убедитесь, что контент опубликован для запрашиваемой локали и что API-ключ имеет соответствующую область чтения.
Готовы к дальнейшему?
getting-started{.interpreted-text role="doc"} --- обзор модели интеграций Mailoo- Руководства по интеграциям в разделе Интеграции
- OpenAPI:
https://api.mailoo.app/docs/v1