Контактная форма обратной связи

Используйте интеграцию Contact / feedback form для сбора сообщений с вашего сайта (контакты, поддержка, обратная связь). Каждая отправка создаёт сообщение в Mailoo и связанную запись обратной связи со структурированными полями.

:::: important ::: title Important :::

Только на стороне сервера: отправляйте данные с вашего бэкенда или BFF; вызывайте Mailoo с X-API-Key из переменных окружения. Не передавайте ключ в браузерный JavaScript или публичные сборки. ::::

:::: note ::: title Note :::

Устаревший подход: Прямой вызов вебхука обратной связи из браузера может работать при совпадении CORS и разрешённых источников, однако API-ключ становится доступен клиенту. Для новых интеграций используйте бэкенд или BFF. ::::

Быстрый старт

В панели управления откройте проект → Создать интеграцию → Contact / feedback form.
При необходимости задайте разрешённые источники (список Origin). Оставьте пустым, чтобы пропустить проверку Origin; API-ключ по-прежнему обязателен. BFF может пересылать заголовок Origin браузера, поэтому заполненный список применяется.
Создайте API-ключ с областью Feedback form submissions (webhook.feedback-submission) для ключа RESTRICTED или используйте Full Access. Храните ключ только на сервере.
С вашего сервера отправьте POST на вебхук обратной связи (см. справку по API ниже).
Просмотрите отправки в разделе Сообщения этой интеграции.

Исходящий SMTP (панель управления)

На вкладке Подключение и настройки интеграции раздел Исходящая почта (SMTP) позволяет настроить почту для потоков подписчиков и ответов оператора, использующих SMTP на уровне интеграции (см. outbound-smtp{.interpreted-text role="doc"}). Нажмите Отправить тестовое письмо, чтобы проверить текущие SMTP-поля; тест доставляется на e-mail вашей учётной записи Mailoo и не сохраняет форму автоматически.

Справка по API

Эндпоинт

POST /api/v1/webhooks/feedback/{projectUid}/{integrationId}

Заголовки

Заголовок Обязательно Описание

Content-Type Да application/json

X-API-Key Да API-ключ проекта с webhook.feedback-submission (или FULL)

`Origin` Нет Если `allowedOrigins` не пуст, должен совпадать с записью. Не указывайте или оставьте список пустым, чтобы пропустить проверку Origin (API-ключ по-прежнему обязателен).

Тело JSON

Поле Обязательно Описание

email Да E-mail отправителя

message Да Текст сообщения (обычный текст)

name Нет Имя отправителя

subject Нет Тема письма (при отсутствии используется значение по умолчанию)

`metadata` Нет Объект с дополнительными парами ключ/значение (сохраняется вместе с отправкой)

Успешный ответ (200)

{
  "success": true,
  "messageId": "...",
  "feedbackId": "...",
  "message": "Feedback submission processed successfully"
}

Панель управления

Откройте Проект → Интеграция → Просмотр сообщений для списка и просмотра отдельных сообщений. Интеграции обратной связи не используют вкладки подписчиков/кампаний рассылки.

Интеграция из приложения Next.js

Настройте BFF-маршрут с @mailoo/forms, чтобы браузер никогда не видел API-ключ. Полное описание, параметры окружения и клиентские паттерны: feedback-form-nextjs-example{.interpreted-text role="doc"}.

См. также

feedback-form-nextjs-example{.interpreted-text role="doc"} --- Next.js BFF, опциональный список разрешённых источников, клиентская отправка
outbound-smtp{.interpreted-text role="doc"} --- исходящий SMTP интеграции, тестовое письмо, MAIL_SMTP_ENCRYPTION_KEY
../index{.interpreted-text role="doc"} --- другие типы интеграций
OpenAPI: https://api.mailoo.app/docs/v1 --- API-ключи и allowedOperations

Контактная форма / форма обратной связи