Sending emails with Yandex Cloud Postbox

When creating a new workflow or editing an existing one, in the management console, under Create workflow / Edit workflow, select Constructor.

From the Integration steps section on the left side of the screen, drag the Yandex Cloud Postbox element to the relevant workflow location in the constructor window.

You can drag and drop steps into areas marked by the dotted line in the workflow schema, such as Add a step, etc.

In the workflow schema window, click the new Yandex Cloud Postbox section to select it.

At the right of the window, on the Settings tab.

1. In the Step name field, enter a name for the workflow step.

2. In the From address field, enter the Yandex Cloud Postbox address that will send the emails.

   Note

   Make sure the service account specified in the workflow settings and the address specified in this field reside in the same folder.

3. Under To addresses, select:

   • Address array to specify recipient addresses one by one using Add address.
   • Raw string to specify recipient addresses as a comma-separated list.

4. Optionally, under BCC addresses, select:

   • Address array to specify BCC recipient addresses one by one using Add BCC.
   • Raw string to specify BCC recipient addresses as a comma-separated list.

5. Under Message, add the content of the message to send. Select:

   • Text to set the email content using the form:

     1. In the Subject field, specify the message title.
     2. In the HTML content field, specify the message text to display in email clients with HTML support.
     3. In the Text field, specify the message text to display in email clients without HTML support.
     4. In the Encoding field, select the message encoding.

   • Template to set the email content as a template. For more information, see the Yandex Cloud Postbox documentation.

6. Optionally, in the Timeout, ms field, set the maximum execution time for the current step.

7. Optionally, to set a custom retry policy for a step, expand the Retry policy section and click Retry policy. In the form that appears:

   1. Optionally, in the Initial delay, ms field, set the initial value for a delay between step retries.

   2. Optionally, in the Backoff rate field, set the multiplication factor for delay before each step retry.

   3. Optionally, in the Maximum delay, ms field, set the value for a maximum delay between step retries.

   4. In the Errors field, select the errors for which the step will or will not be retried.

      For detailed information about possible errors, see this section.

   5. Optionally, in the Maximum number of retries field, set the maximum number of step retry attempts.

   6. In the Error selection mode field, select:

      • INCLUDE: Retry executing a step when errors specified in the Errors field occur.
      • EXCLUDE: To retry executing the step on any errors other than those specified in the Errors field.

   If you want to delete a retry policy you created for the step earlier, click and select Delete in the Retry policy row.

   If no custom retry policy is configured for a step, the retry policy set for the whole workflow will apply.

Optionally, navigate to the Input tab and set a jq template to filter the workflow state fed into the step.

Optionally, navigate to the Output tab and set a jq template to filter the step outputs added into the workflow state.

Optionally, add an error transition rule for the step you are creating to handle errors you may get during this step.