Email Integration & Automated Messaging Operating Guide

Print Life Software provides an omnichannel email communication and notification system that connects your shop's existing email accounts (Google Workspace, Microsoft 365, Yahoo Mail, Apple iCloud, Zoho Mail, or custom domain webmail) directly to your quoting and production workflows. The platform enables 1-click manual email dispatch from any quote or invoice, automated status-triggered customer notifications, internal staff alerts, and complete email delivery auditing.

---

1. Feature Scope & UI Navigation

The email engine spans connection settings, template management, manual quote dispatch, and automated pipeline rules:

┌───────────────────────────────────────────────────────────────────────────────────┐
│                             PRIMARY NAVIGATION PATHS                              │
├──────────────────────────┬───────────────────────────┬────────────────────────────┤
│ Email Provider Connect   │ /settings?tab=connections │ Settings -> Connections    │
│ Email Template Library   │ /settings?tab=templates   │ Settings -> Templates      │
│ Manual Quote Email Send  │ /quotes-invoices/[id]     │ More Actions -> Send Email │
│ Automated Triggers       │ /dashboard                │ Dashboard -> Automations   │
└──────────────────────────┴───────────────────────────┴────────────────────────────┘

Provider Connections (/settings?tab=connections)

Access by expanding Finance & Settings in the left sidebar $\rightarrow$ click Settings $\rightarrow$ select the Connections tab:

• Google Workspace / Gmail: Click Connect Gmail to authenticate via secure OAuth 2.0.
• Microsoft 365 / Outlook: Click Connect Outlook to authenticate via secure OAuth 2.0.
• Custom SMTP Relay: Click Configure SMTP (or Connect Custom SMTP) to connect Yahoo Mail, Apple iCloud, Zoho Mail, SendGrid, or private cPanel/domain webmail.
• Test Email (Action Button): Dispatches a live test message to verify outbound delivery.
• Disconnect (Action Button): Safely unlinks the active account without affecting past email records.

Email Templates Hub (/settings?tab=templates)

• Client Templates Tab: Customer-facing messages (Quote Sent, Deposit Requested, Mockup Ready, Order Completed).
• Shop Templates Tab: Internal staff notification emails (First Payment Received, Mockup Approved, Revisions Requested).
• + Add Template (Button): Creates a new custom email template with rich subject and body fields.
• Seed Industry Templates (Button): 1-click installer that populates pre-written professional print shop email copy.

Manual Quote Dispatch (/quotes-invoices/[id])

• Inside any quote or invoice, click More Actions in the top action bar $\rightarrow$ select Send Email.
• Launches the email dialog pre-populated with customer contact addresses, template selectors, and editable message content.

---

2. Capabilities & Operational Boundaries

The messaging architecture routes transactional and marketing communications through your verified shop email domain:

┌────────────────────────────────────────────────────────────────────────┐
│                        TRIGGER SOURCE ENGINE                           │
│  Manual "Send Email" Dialog OR Automated Kanban Stage Transition       │
└───────────────────────────────────┬────────────────────────────────────┘
                                    │
                                    ▼
┌────────────────────────────────────────────────────────────────────────┐
│                      DYNAMIC VARIABLE MERGE ENGINE                     │
│  Injects {customer_name}, {quote_id}, {quote_total}, {portal_link}     │
│  Enforces Recipient Boundaries: Client Templates vs. Shop Templates   │
└───────────────────────────────────┬────────────────────────────────────┘
                                    │
                                    ▼
┌────────────────────────────────────────────────────────────────────────┐
│                     AUTHENTICATED DISPATCH ROUTER                      │
│   • Google Workspace / Gmail OAuth Channel                             │
│   • Microsoft 365 / Outlook OAuth Channel                              │
│   • Encrypted Custom SMTP Relay (Port 587 TLS / 465 SSL)               │
└───────────────────────────────────┬────────────────────────────────────┘
                                    │
         ┌──────────────────────────┴──────────────────────────┐
         ▼                                                     ▼
┌─────────────────────────────────┐           ┌─────────────────────────────────┐
│         CUSTOMER INBOX          │           │       ACTIVITY AUDIT LOG        │
│ Delivered from your verified    │           │ Timestamped dispatch history    │
│ domain (Zero "via" spoof flags) │           │ linked to customer quote card   │
└─────────────────────────────────┘           └─────────────────────────────────┘

Supported Capabilities

• Native OAuth 2.0 for Google & Microsoft: Connects directly to Google Workspace and Microsoft 365 with 1 click without requiring insecure password storage or SMTP configuration.
• Universal Encrypted SMTP Relay: Supports Yahoo Mail, Apple iCloud, Zoho Mail, Mailgun, SendGrid, and custom domain cPanel webmail using SSL/TLS encryption.
• Dynamic Personalization Merge Tags: Automatically populates dynamic variables including {customer_name}, {quote_id}, {quote_total}, {portal_link}, and {due_date}.
• Client vs. Shop Template Isolation: Strictly isolates customer-facing templates from internal staff alert templates, preventing internal production notes from accidentally being sent to clients.
• Industry Starter Templates: Includes pre-written professional copy for quote delivery, revision requests, proof approvals, payment confirmations, and pickup notices.
• Full Outbound Audit History: Records an immutable communication log on every quote and invoice tracking recipient email, timestamp, subject line, and delivery provider.

Operational Boundaries

• 14-Day Free Trial (Credit Card Required to Unlock Connections): New accounts start on a 14-day cardless free trial in Safe Sandbox Mode. To connect Gmail, Outlook, or Custom SMTP during your trial, click the connect button under Settings $\rightarrow$ Connections and click Unlock Connections — $0 Today in the modal to add a credit card on file. Adding a card charges $0.00 today, preserves all remaining days of your 14-day free trial, and immediately unlocks all live email, payment, accounting, shipping, and transfer connections.
• No Direct POP3 Inbound Synchronization: Inbound customer replies flow directly to your normal email client (Gmail, Outlook, Yahoo, or Apple Mail). The platform focuses on outbound dispatch and activity logging.
• App Password Requirement for Consumer Providers: Major providers (Yahoo, iCloud, Zoho, AOL) mandate dedicated 16-character App-Specific Passwords and block primary login passwords on third-party relays.
• Provider Rate Limits: Outbound volume is governed by your email host's standard daily sending limits (e.g., 2,000/day for Google Workspace, 10,000/day for Microsoft 365).

---

3. Step-by-Step SOP Workflows

Workflow 1: Connecting Google Workspace or Microsoft 365 via OAuth

1. Expand Finance & Settings in the left sidebar $\rightarrow$ click Settings (/settings).
2. Select the Connections tab.
3. Under Email Providers, click Connect Gmail (for Google Workspace) or Connect Outlook (for Microsoft 365).
   • Note for 14-Day Free Trial Accounts: If you haven't added a payment method yet, clicking Connect Gmail or Connect Outlook opens the plan selector where you can click Unlock Connections — $0 Today to add your credit card (you keep all remaining free trial days and pay $0 today). Once added, click Connect Gmail or Connect Outlook again to proceed.
4. In the secure authorization window:
   • Select your business email account.
   • Review and grant sending permissions.
5. Upon returning to Print Life, a green Connected badge displays alongside your email address.
6. Click Test Email, enter your personal address, and click Send Test to verify delivery.

---

Workflow 2: Connecting Third-Party Providers via Custom SMTP

1. In Settings $\rightarrow$ Connections, locate Custom SMTP and click Configure SMTP.
2. Select your email service from the Quick Provider Preset dropdown:
   • Yahoo Mail: Pre-fills smtp.mail.yahoo.com, port 587, SSL OFF.
   • Apple iCloud: Pre-fills smtp.mail.me.com, port 587, SSL OFF.
   • Zoho Mail: Pre-fills smtp.zoho.com, port 587, SSL OFF.
   • cPanel / Custom Domain: Pre-fills port 465 with SSL ON. Replace yourdomain.com with your mail host (e.g., mail.yourshop.com).
3. Enter your full business email in Authentication User.
4. Generate and enter your provider App Password:
   • Yahoo: Sign in to login.yahoo.com/account/security $\rightarrow$ generate an app password named "Print Life" $\rightarrow$ copy the 16-character code.
   • Apple iCloud: Sign in to appleid.apple.com $\rightarrow$ Sign-In and Security $\rightarrow$ App-Specific Passwords $\rightarrow$ generate a 16-character code.
5. Paste the code into the Password / App Password field.
6. Click Save & Connect SMTP Relay, then click Test Email to confirm delivery.

---

Workflow 3: Creating Branded Templates & Dynamic Merge Tags

1. Go to Settings (/settings) $\rightarrow$ click the Templates tab (/settings?tab=templates).
2. Choose Client Templates (for customer messages) or Shop Templates (for staff alerts).
3. Click + Add Template.
4. Configure the template:
   • Template Name: Descriptive title (e.g., Artwork Proof Sign-Off Request).
   • Recipient Category: Select Client or Shop.
   • Subject Line: Enter your subject with merge tags (e.g., Artwork Proof Ready: {quote_id} for {customer_name}).
   • Email Body: Compose your branded message incorporating dynamic tags:

     Hi {customer_name},
     
     Your production artwork proof for order {quote_id} is ready for review!
     
     Please click the link below to inspect your visual mockups and approve or request revisions:
     {portal_link}
     
     Order Total: {quote_total}
     Estimated Completion Date: {due_date}
     
     Thank you,
     The Production Team
     

5. Click "Save Template".

---

Workflow 4: Dispatching Manual Emails from Quotes and Invoices

1. Open any job in Quotes & Invoices (/quotes-invoices/[id]).
2. In the top action bar, click More Actions $\rightarrow$ select Send Email.
3. In the email modal:
   • Recipient: Select the customer contact email from the dropdown (or type an additional address).
   • Template Selector: Choose a saved template to instantly populate subject and body copy.
   • Review or customize the message copy directly in the editor.
4. Click "Send Email".
5. The message is transmitted via your connected account, and an outbound activity entry is permanently logged on the quote card.

---

Workflow 5: Linking Email Templates to Automated Status Triggers

1. Navigate to Dashboard (/dashboard) in the left sidebar and click the Automations button in the top-right header action bar.
2. Scroll to your desired trigger across Stages 1–5 (for example, Proofs Emailed to Customer under Stage 2: Artwork & Proof Approvals or Order Marked Complete under Stage 4: Purchasing, Inventory & Production).
3. Toggle the switch on the trigger card to Rule Active.
4. Under AND SEND EMAIL, click Select email template and choose your designated Client Email Template.
5. (Optional) Under AND NOTIFY SHOP, click Select notification template and choose a Shop Email Template to dispatch an internal heads-up to your shop contact email.
6. Your rule auto-saves immediately — click Exit Command Center when finished. Whenever that event occurs, the email will dispatch automatically in the background!

---

4. Technical Rules, Merge Variables & SMTP Port Standards

Dynamic Merge Tag Directory

The template engine scans and replaces variables dynamically upon dispatch:

Variable Tag	Output Description	Example Value
{customer_name}	Primary customer contact or company name	Acme Athletics
{quote_id}	Official quote or invoice number	INV-1042
{quote_total}	Formatted currency order total	$1,245.50
{portal_link}	Direct passwordless Customer Portal URL	https://yourshop.com/portal?auth=...
{due_date}	Promised completion or event delivery date	October 24, 2026
{shop_name}	Shop commercial brand name	The Print Life

Master SMTP Relay Configuration Matrix

When connecting custom email servers, use the appropriate port and security combinations:

Provider / Service	Outgoing Host (Server)	Port	SSL / TLS Switch	Password Standard
Yahoo Mail	smtp.mail.yahoo.com	587	OFF (or 465 ON)	16-character Yahoo App Password
Apple iCloud	smtp.mail.me.com	587	OFF	16-character Apple App-Specific Password
Zoho Mail	smtp.zoho.com	587	OFF (or 465 ON)	Zoho Application-Specific Password
AOL Mail	smtp.aol.com	465	ON (or 587 OFF)	16-character AOL App Password
cPanel / Custom Webmail	mail.yourdomain.com	465	ON	Standard Mailbox Password
SendGrid SMTP	smtp.sendgrid.net	587	OFF	SendGrid API Key (SG.xxx...)
Mailgun SMTP	smtp.mailgun.org	587	OFF	Mailgun SMTP Password

---

5. Troubleshooting & Diagnostic Matrix

Symptom / Question	Root Cause	Exact Remediation Step
"SMTP Authentication Failed (535)"	Standard mailbox password was entered instead of an App Password.	Log into your email security settings (Yahoo, Apple ID, Zoho), generate a 16-character App Password, and paste it into Settings $\rightarrow$ Connections $\rightarrow$ Configure SMTP.
Automation triggers but no email is delivered	An automation trigger was enabled without selecting an active Email Template.	Go to Dashboard (/dashboard) $\rightarrow$ click Automations, locate the active trigger rule, click Select email template under AND SEND EMAIL, and choose a valid template.
Gmail OAuth disconnects after several days	Google Workspace OAuth security refresh token expired or permissions were modified.	In Settings $\rightarrow$ Connections, click Disconnect, then click Connect Gmail to establish a fresh authentication session.
Customer reports emails landing in Spam folder	Custom domain SMTP lacks proper DNS authentication (SPF, DKIM, DMARC).	Add your SMTP mail server IP to your domain's SPF TXT record (v=spf1 include:... ~all) and configure DKIM signing, or switch to Google Workspace / Microsoft 365 OAuth.
Merge tags render as literal text (e.g. {due_date})	Merge tag syntax was misspelled or the invoice has no due date set.	Verify tag formatting matches {customer_name}, {quote_id}, {quote_total}, {portal_link}, or {due_date} exactly with brackets.

---

6. Frequently Asked Questions & Action Prompts

Q: Where do I connect our shop email address?

Answer: Expand Finance & Settings in the left sidebar $\rightarrow$ click Settings (/settings) $\rightarrow$ select the Connections tab. You can connect Google Workspace or Microsoft 365 with 1-click OAuth, or connect Yahoo, iCloud, or custom domain webmail via Configure SMTP!

[Connect shop email account](chat:How do I connect my shop email in Settings?)

Q: Why did our Yahoo or iCloud SMTP connection fail with error 535?

Answer: Consumer email services like Yahoo and Apple require modern 2-Step Verification and strictly block third-party servers from using your primary account password. You must generate a dedicated 16-character App Password in your Yahoo Account Security or Apple ID portal and paste it into your Print Life SMTP settings.

[How do I create an App Password?](chat:How do I set up an App Password for Yahoo or iCloud?)

Q: How do I send an email directly to a customer from their quote?

Answer: Open the quote in Quotes & Invoices (/quotes-invoices/[id]), click More Actions in the top action bar, and select Send Email. You can pick a pre-written template, personalize the copy, and send it directly from your connected business email address!

[Take me to Quotes & Invoices](chat:Show me Quotes and Invoices)

Q: Can Print Life send automated emails when jobs move across the Kanban board?

Answer: Yes! Go to Dashboard (/dashboard) and click the Automations button in the top-right header. Enable any trigger across Stages 1–5 (e.g., Proofs Emailed to Customer or Order Marked Complete) by toggling Rule Active, then click Select email template under AND SEND EMAIL. Print Life will automatically dispatch the email whenever that milestone fires!

[Configure email automations](chat:How do I set up automated emails for job status changes?)

Q: Where do I customize or create new email templates?

Answer: Go to Settings (/settings) $\rightarrow$ click the Templates tab (/settings?tab=templates). Here you can create branded client-facing messages or internal staff alert templates, or click Seed Industry Templates to install pre-written print shop copy!

[Open Email Templates](chat:Where do I manage email templates?)