Почта на домене
Письма на info@example.com, sales@example.com и другие адреса вашего домена могут приходить прямо в OnPress. Вы читаете их как переписки в консоли или через API, поэтому для приема писем вам не нужен отдельный почтовый сервис.
API — https://onpress.pro/api/v2, SITE — id сайта, OP_TOKEN — ваш токен API. Все эндпоинты почты описаны в справочнике.
Подключить домен
Подключение состоит из двух шагов. Сначала OnPress заводит домен вашего сайта на почтовом сервере, затем вы направляете на него почту MX-записью.
В консоли. Откройте «Настройки» → «Почта сайта», выберите сайт и нажмите «Подключить» в строке домена. Консоль покажет нужную MX-запись.
Через API. POST /inbox/domains подключает домен сайта. Например, подключите example.com:
curl -s -X POST "$API/site/$SITE/inbox/domains" \
-H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
-d '{"domain": "example.com"}'
Поле mx в ответе покажет запись. Добавьте в DNS домена MX-запись mail.onpress.pro с приоритетом 10 и удалите прежние MX-записи. С этого момента вся почта домена идет в OnPress, а прежний почтовый сервис перестает получать письма. Когда запись начнет действовать, консоль покажет «Письма на любой адрес», а поле reception в GET /inbox/settings покажет значение catch_all.
Чтобы отключить домен, нажмите «Отключить» в той же строке или отправьте DELETE /inbox/domains/{domain}. Письма на произвольные адреса домена перестанут приходить, а уже полученные письма останутся. Затем верните в DNS прежние MX-записи.
У каждого сайта есть еще адрес на домене OnPress вида mysite-abc123@onpress.pro. Письма на него приходят в тот же раздел без настройки DNS, а сам адрес вы найдете в поле sender.site_address ответа GET /inbox/settings.
Читать письма
В консоли. Откройте «Инструменты» → «Почта» и выберите сайт. OnPress собирает письма одного разговора в переписку. Фильтры «Все», «Непрочитанные» и «Архив» отбирают нужные переписки, а нажатие на строку открывает письма.
Через API. GET /inbox/threads отдает список переписок, а GET /inbox/threads/{id} отдает одну переписку с письмами и снимает с нее отметку «непрочитано». Например, получите непрочитанные переписки:
curl -s "$API/site/$SITE/inbox/threads?unread=1" -H "Authorization: Bearer $OP_TOKEN"
Ответить на письмо
OnPress отправляет ответ с адреса сайта вида mysite-abc123@framesuite.app, а не с адреса вашего домена. Адрес для ответа в письме — mysite-abc123@onpress.pro, поэтому ответ собеседника возвращается в ту же переписку.
В консоли. Откройте переписку, введите текст в поле ответа и нажмите «Ответить». Имя отправителя и подпись задайте в «Почте сайта», а готовые тексты храните в «Шаблонах ответа».
Через API. POST /inbox/threads/{id}/reply принимает текст в поле body, а PATCH /inbox/settings меняет имя отправителя from_name и подпись signature. Например, ответьте в переписке 7:
curl -s -X POST "$API/site/$SITE/inbox/threads/7/reply" \
-H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
-d '{"body": "Добрый день! Заказ отправлен сегодня."}'