eSputnik

Overview

eSputnik is a service for launching email and SMS campaigns. Before integrating with eSputnik API, we recommend reading and understanding the documentation. This tutorial guides you through setting up a Corezoid process using the eSputnik API call to send emails and check their delivery status.
To learn more about eSputnik, get familiar with the following topics:

• Register account
• Create email template
• Send email via eSputnik
• Check email delivery status

Register account

To register an account on eSputnik:

1. Go to https://esputnik.com/ and click Sign Up.
   

2. In the Registration dialog:

   1. Enter your name, email, and mobile phone number.
   2. Select the checkboxes to accept the processing of your personal data and confirm that you are familiar with the terms of use of the service and anti-spam policy.
   3. Click Register.

   

3. Click Check Your Gmail.
   

4. In your mailbox, find a message from eSputnik and click Activate.
   

5. In the Login data dialog, enter your password in the Password and Password again fields and click Next.
   

6. In the Account information dialog, enter your account name in the Account name field and click Next.
   

7. In the More options dialog:
   a. Select a country in the Country dropdown list.
   b. Select a currency in the Currency dropdown list.
   c. Select a business type in the Business type dropdown list.
   d. Select the needed checkbox(es) in Contact base source.
   e. Select the number of contacts in Total number of contacts.
   f. Click Activate account.

   

You have successfully registered your account on eSputnik.

Create email template

To create an email template:

1. In the upper-left corner of the main page, click Messages and from the dropdown list, select Messages.
   

2. On the Email tab of the Messages page, click New Email.
   

3. On the Select email template page, select the needed template.
   

4. In the upper-right corner of the selected template, click Save.
   

5. Click the code editing icon and copy the HTML code in one of the parameters to launch email sending.
   

You have successfully created an email template.

Send email via eSputnik

To send an email via eSputnik:

1. Go to https://admin.corezoid.com/, in the upper-left corner, click Create and in the dropdown list, select Folder.
   

2. In the Create folder dialog, enter the eSputnik folder name and click Ok.
   

3. In the eSputnik folder, click Create and in the drop-down list, select Process.
   

4. In the Create process dialog, enter the Send Email process name and click Ok.
   Note: The process will send an email to the user and check the delivery status of your email.
   {height="" width=""}
   Note: Login and password for your account are used as a key to make a eSputnik API call.

5. In the Send Email process, add the Set Parameters node.
   Note: When adding a node, hover over the needed place in the process, click the plus that appears, and in the dropdown list, select the needed node name.
   

   Note: With the Set Parameters node, you don’t have to enter your login and password with each API call.

6. Click the Set Parameters node and on its details panel, enter:

   1. eSputnik credentials in the Add title field.
   2. login and password in the Key fields to sign in on esputnik.com.

   

7. Add another Set Parameters node to the process and on its details panel, enter:
   a. Get token in the Add title field.
   b. token and $.base64_encode({{login}}:{{password}}) in the Key and Value fields correspondingly.
   Note: The token is generated by using the login and password values encoded in Base64.

   

8. Add the API Call node to the process and on its details panel:
   a. Enter eSputnik API in the Add title field.
   b. Enter https://esputnik.com/api/v1/message/email in the URL field.
   c. Select Default in the Request format dropdown list.
   d. Select json in the Data format dropdown list.
   e. Enter application/json; in the Content-Type field.
   f. Enter plainText, emails, from, subject, and htmlText in the Key fields.
   g. Enter {{plainText}}, {{emails}}, {{from}}, {{subject}}, and {{htmlText}} in the Value fields.
   h. Select the Header parameters checkbox and enter Authorization and Basic {{token}} in the Key and Value fields below correspondingly.

   

9. In the upper-right corner, click the task parameters icon and in the Task parameters dialog:

   1. Add the following parameters by clicking + Add parameter:

      • plainText with the email адреса отримувача description
      • emails with the адреса відправника description
      • from with the HTML-код повідомлення description
      • subject with the варіант повідомлення простим текстом description
      • htmlText with the тема повідомлення description

   2. Select the Required checkbox next to the emails, from, subject, and htmlText parameters.

   3. Click Save.

   Note: You have to add the parameters to ensure that the parameters are filled in automatically each time when you send a request manually.

   

10. Add the Condition node to the process and on its details panel, enter:
    a. Check status in the Add title field.
    b. {{results.status}} in the Key field.
    c. Ok in the Value field.

    Note: This node is needed to check the sending status of your email.

    

11. Add the End node to the Condition node:

    1. On the right side of the Condition node, click the plus icon, drag it to the right side, and from the dropdown list, select End: Error.
       

    2. On the End: Error node details panel, enter Email sending error in the Add title field.
       

12. In the upper-left corner, click Deploy.
    

13. On the top panel, click View and in the upper-left corner, click + New task.
    

14. In the New Task dialog:

    1. Enter the recipient’s email in the emails field.
    2. Enter the sender's email in the from field.
    3. Enter the email HTML code in the htmlText field.
    4. Enter the email subject in the subject field.
    5. Click Add task.

    

Your email is sent via eSputnik API successfully, and the created request appears in the Final node.

Check email delivery status

To check an email delivery status:

1. In the Send Email process, add the Delay node.
   Note: When adding a node, hover over the needed place in the process, click the plus that appears, and select the needed node name in the dropdown list.
   

2. Click the Delay node and on its details panel:

   1. Enter 4. Waiting before status checking in the Add title field.
   2. Select the Maximum interval, for which the task stays in the node before being forwarded checkbox.
   3. Enter "2" in the field below.
   4. Select Min in the time interval dropdown list.

   

3. Add another API Call node to the process and on its details panel:

   1. Enter Check email status in the Add title field.
   2. Enter https://esputnik.com/api/v1/message/email/status in the URL field.
   3. Select Default in the Request format dropdown list.
   4. Select json in the Data format dropdown list.
   5. Enter application/json in the Content-Type field.
   6. Enter ids in the Key fields.
   7. Enter {{results.requestId}} in the Value fields.
   8. Select the Header parameters checkbox and enter Authorization and Basic {{token}} in the corresponding Key and Value fields below.

   Note: This node will call the eSputnik API to check the email delivery status.

   

4. Add another Condition node to the process and on its details panel:

   1. Enter What’s status? in the Add title field.
   2. In Condition Block, enter {{results.delivered}} and true in the corresponding Key and Value fields.
   3. Click + New block and enter {{results.failed}} and true in the corresponding Key and Value fields.
   4. Click + New block and enter {{results.delivered}} and {{results.failed}} in the Key fields and true in both Value fields.
   5. Select the "!=" (not equal) for both {{results.delivered}} and {{results.failed}} values before the true in the last condition block.

   Note: Thus, the tasks which check results are neither {{results.delivered}}, nor {{results.failed}} (neither successfully delivered, nor failed to be delivered) will be forwarded for recheck.

   

5. Add the End nodes to the Condition node:

   1. On the right side of the first condition, click the plus icon, drag it to the right side of the node, and from the dropdown list, select End: Success.
      

   2. On the End: Success node details panel, enter Delivered in the Add title field.
      Note: If the task satisfies the {{results.delivered}}=true condition, it goes to the Delivered node.
      

   3. On the right side of the second condition, click the plus icon, drag it to the right side of the node, and from the dropdown list, select End: Error.
      

   4. On the End: Error node details panel, enter Failed in the Add title field.
      

   5. On the right side of the third condition, click the plus icon, drag it and drop it on the Waiting before status checking condition node.
      

6. In the upper-left corner, click Deploy.
   

7. On the top panel, click View and in the upper-left corner, click + New task.
   

8. In the New Task dialog:
   a. Enter the sender's email in the from field.
   b. Enter the email HTML code in the htmlText field.
   c. Enter the email subject in the subject field.
   d. Click Add task.

   

Your task goes to the Delivered node after two minutes. Congratulations! You have learned how to set up the Corezoid process for sending email and checking the delivery status of your emails via eSputnik API.