# xml ## Описание метода Осуществляется с помощью POST-запроса. Событие для отправки письма определяется на стороне клиента. Название операции и набор принимаемых полей настраиваются в системе Mindbox. Подробней про вызов метода можно прочитать [здесь](https://developers.mindbox.ru/docs/v3). ```xml title="Универсальная операция" POST https://api.mindbox.ru/v3/operations/{синхронная/асинхронная операция}?endpointId={уникальный идентификатор сайта/мобильного приложения/и т.п.}&operation={название операции}&deviceUUID={уникальный идентификатор устройства}&{transactionId}={Id транзакции в вашей системе} Accept: application/xml Content-Type: application/xml Authorization: SecretKey {Секретный ключ, обязательность уточнить у менеджера} {Email} <{Имя параметра}>{Значение параметра} {Имя прикрепляемого файла} {Идентификатор прикрепляемого файла} {Дата и время выполнения (можно использовать для выполнения запроса задним числом)} ``` ### Параметры запроса * `customer/email` — может быть любой другой идентификатор клиента, зависит от настроек операции. * `emailMailing` — объект для передачи дополнительных параметров при их наличии. Может меняться на `smsMailing/viberMailing/mobilePushMailing/webPushMailing` в зависимости от канала рассылок. * `customParameters` — объект для передачи [пользовательских параметров](https://help.mindbox.ru/docs/custom-parameters-operation) при их наличии. * `attachments` — массив для передачи [вложений](https://help.mindbox.ru/docs/email-with-attachment) при их наличии. **transactionId** — это ключ идемпотентности, который используется как уникальный идентификатор транзакции отправки письма в вашей системе (необязательный параметр). :::info [Подробнее о ключе идемпотентности.](https://help.mindbox.ru/docs/idempotentnost#kak-sozdat-klyuch-idempotentnosti) ::: По этому идентификатору можно узнать статус рассылки: была ли доставлена, открыта и т.п. Если в Mindbox уже зарегистрирована транзакция с таким `transactionId`, то повторно рассылка не будет отправлена и в логе запроса будет сообщение **Transaction already processed**. Если в случае ошибки вы вызываете операцию повторно, то `transactionId` передавать обязательно. Иначе рассылка может отправиться одному и тому же человеку несколько раз. :::danger Отправка Email в режиме `sync` не поддерживает использование `transactionId` — сообщения уйдут клиенту дважды. Для отправки письма используйте режим `async`. Если все же необходимо настроить операцию в синхронном режиме с использованием ключа идемпотентности, обратитесь к менеджеру вашего проекта. ::: ## Примеры операций Приветственное письмо Востановление пароля Письмо с продуктовым блоком Отправка СМС сообщения Отправка сообщения в Viber ```xml POST https://api.mindbox.ru/v3/operations/async?endpointId=MindboxRu&operation=sendWelcome Accept: application/xml Content-Type: application/xml pivan@mindbox.ru ``` ```xml POST https://api.mindbox.ru/v3/operations/async?endpointId=MindboxRu&operation=sendRestore&transactionId=1 Accept: application/xml Content-Type: application/xml pivan@mindbox.ru http://mindbox.ru/lk/restore?hash=7DCEE600A554B6CD373DC4ABABFBC3BF5B79154E 2017-09-25 ``` ```xml POST https://api.mindbox.ru/v3/operations/async?endpointId=MindboxRu&operation=sendBuy&transactionId=2 Accept: application/xml Content-Type: application/xml pivan@mindbox.ru Клиент: онлайн-лаборатория натуральной косметики

Результат: рост чистой прибыли в 3 раза

Читать кейс Клиент: магазин аутдор—снаряжения

Результат: доход от Email-канала относительного общего дохода вырос почти в 3 раза

Читать кейс Клиент: сервис по доставке продуктов питания и товаров для дома

Результат: увеличили доход Email-канала с 0% до 30%

Читать кейс Клиент: магазин товаров для дома

Результат: автоматизировали Email-маркетинг и увеличили оборот с Email-канала на 6%

Читать кейс Клиент: пивоваренная компания

Результат: увеличили конверсию промо-акции в 16 раз

Читать кейс ]]> ``` ```xml POST https://api.mindbox.ru/v3/operations/async?endpointId=MindboxRu&operation=SendSms&transactionId=3 Accept: application/xml Content-Type: application/xml 79001234567 2017-09-25 ``` ```xml POST https://api.mindbox.ru/v3/operations/async?endpointId=MindboxRu&operation=SendViberMessage&transactionId=4 Accept: application/xml Content-Type: application/xml 79001234567 2017-09-25 ```