Overview

Using BarTender Integrations, it is possible to trigger a print job via email. 

This article will go over the steps required to set up an email integration.

Applicable to 

BarTender 2016 and later

Automation Edition and higher

Integration Builder

Information

Setup an Email Integration

This example will use a BTXML script for printing. For details on how to set up the BTW file, review the following article Print Multiple Records With a Single Call to Your Web Service Integration.

Once the Btw file is properly setup you can follow the steps below to create an email integration:

1. Open Integration Builder and create a new email integration
   
2. Enter the information for the email address to be monitored for incoming emails: 
   1. Mail Server: This is the address for the email Server it depends on the email provider you are using. (Check the Commonly Used Email Services section below)
   2. Email Address: which will be monitored for incoming emails
   3. Port: This setting should be left as default unless instructed otherwise by your email service provider. (Check the Commonly Used Email Services section below)
   4. Login Settings: Your user credentials to login to your email account.
      
3. Once you have entered all of the information use the Test button at the bottom to verify the connection. 
4. Set the integration's behavior when checking the inbox: 
   1. Email Address: Filter the emails by the sender's email address.
   2. Check Inbox Every: Frequency with which the inbox is polled.
   3. Subject: Filter the emails by subject line. Set this to "Email Integration".
   4. When Mail Arrives: Choose to forward and delete or simply delete the email after it is processed.
      
   5. Process the email content: 
      1. Click the radio button next to Run actions using the Email's body content as input data 
      2. Input Data Format: Specify the format of the content as BTXML Script.
         
   6. Remove the Print Document action and add a Print BTXML Script action by clicking on the + button. 
   7. Make sure that the source variable is set to EventData
      
   8. Click on the Test tab and run the integration by clicking Start 
   9. Send an email with the subject line you specified as a filter and the BTXML code in the body. Address it to the email address being monitored by the integration: 
       

Logging Into Gmail and Other Common Email Services

When connecting a Gmail account to your email integration, follow these steps when you're asked to log into your account:

1. Turn On 2-Step Verification
2. Create an App Password: https://myaccount.google.com/apppasswords
3. Use the 16-digit App Password generated there as the password for the email integration.

See the links below for more detailed instructions on how to connect your integration to various common email services.

• Outlook: POP, IMAP, and SMTP settings for Outlook.com
• Gmail: Read Gmail messages on other email clients using POP
• Yahoo: POP access settings and instructions for Yahoo Mail

OAuth Support

Starting with BarTender 2022 R5, BarTender supports OAuth for both POP3 and SMTP in email Integrations and actions: 

1. OAuth settings for POP3:
2. OAuth settings for SMTP:
   

Additional Resources

Email Types for Integration

Integration Error sending an email using Office 365 Mail Server