Demos

How to create an order confirmation process

11min

Scenario:ย We will create a process flow that can be very useful for every ecommerce platform as it represents one of the steps they need to perform in the end-to-end selling process. Every time an order is placed by a customer, they receive confirmation details via email/SMS.ย 

ย This will be a basic scenario where PROCESIO can help you with sending the confirmation email and SMS to the customer, together with the invoice and order details.

Before you get started:ย by the end of the process creation, we will configure:

  • a configuration to an email server that will be used to send the email.
  • a configuration to a REST API of an web-to-sms service.ย 
  • the above requires the creation of 2 connection configurations in the Credentials Manager.

Let's build this process!ย 

The process flow created will look like this:

Document image
๏ปฟ

Create the credentials

Step 1. Create the email server configuration: Go to Credentials Manager section and click on Add New button. This will take you to the Basic Info step of the configuration. Fill in the inputs like below:ย 

Document image
๏ปฟ

Click Next step to take you to the next step of the configuration, i.e. Details.ย 

For this demo we have created a connection to a Gmail server, check theย GMail documentation.

You can also create and use a connection to any email server (checkย Yahooย orย SendGridย connection documentation).

See below how the email server configuration for sending out emails from your Gmail account is configured (add your Gmail username & app password):

Document image
๏ปฟ

Click Test connection to see if you completed the settings correctly. If the test is successful, click Save to save this configuration. We will use this configuration in setting up the SendEmail action.

Step 2. Create connection to the web-to-sms service provider you want to use. Similar to the email server config, go to Credentials Manager section to set it up. For this demo we used SMSO's API (check documentation forย SMSO connection).We will use this API configuration in CallAPI action.

Create and configure the process

Step 1.ย  Create a new process: Go to the Process Designer section and click on the Create New button. This will take you to the canvas where you will build the flow.

Step 2. Add Send Email and Call API actions on canvas and connect them by dragging relations between all the actions.ย 

Document image
๏ปฟ

Step 3. Create the process variables: as mentioned at the beginning, we want to automate this process and make it pass dynamic data such as customer name, email, order id etc. Thus, we need to create some process variables within our process flow, which will act as data placeholders while designing the flow. At runtime, they will take new values.ย 

Go to Process Variablesย (x)ย in top bar to start creating the variables needed for this process. Click Add Variable. You need to define variables as follows:

Document image
๏ปฟ

Step 4. Configure the SendEmail action.

  • Click on it and the properties panel will open. You can rename it from Send Email to Email - order confirmed.ย 
  • Select the email server configuration created in step 1.
  • Click on the Send Email card to proceed to the next steps:
Document image
๏ปฟ

Configure the parameters of the action:

  • The From field will set the display name of the sender. The actual email address of the sender is the one set in the Credential Manager, but we can set the display name to be anything we want. Iโ€™ll use โ€œShop Nameโ€.
  • The To: <%customeremail%> variable.
  • The Subject: <%customerName%>, your order is now confirmed!
  • The Body:
Text
๏ปฟ

To open the variables selector in Body and add process variables to your message: press Insert key (for Windows) or Shift + Tab (for MacOS)

Document image
๏ปฟ
  • The attachment will be the <%invoice%> variable created earlier.
Document image
๏ปฟ

Step 5. Configure the Call API action which is the send SMS step.

  • Click on Call API action and the properties panel will open. You can rename it from Call API to Send SMS.
  • Select the API configuration created in step 2.
  • Click on Configure Request to proceed next steps:
Document image
๏ปฟ

For the Call API configurations you are going to check the SMS provider's API documentation regarding the method name, parameters needed, etc.ย 

Weโ€™ll select the verb POST. As you can see here the URL is prefilled. This comes from the REST API credential configuration. I just need to specify which method name to use to have a valid endpoint - /api/v1/send.ย 

Add the needed query parameters:

  • to:ย <%customerPhone%>ย variable
  • body:ย <%customerName%>, your orderย orderIdย (variable)has been confirmed. Thank you for your purchase!
  • sender: 4 (as per SMSO REST API documentation, you'll need to set it).
  • Status output will contain the <%smsOutput%> variable.
  • Save the changes.
Document image
๏ปฟ

Use the Activate multi line Editing functionality in order to expand the editor:

Document image
๏ปฟ

Step 6. Save the process. Validate the process. Run the process.

Document image
๏ปฟ

Fill in the values for the input variables declared and press Run:

Document image
๏ปฟ

Once the process completes, a notification will appear. Click on the Check instances button to view the details at the process and action level:

Document image
๏ปฟ

Congrats! You have just created a new process flow in PROCESIO!

If you encountered any issues while creating this first process flow, please let us know as we are all growing together.