dotCLOUD Relay - Onboarding Documentation
A step-by-step guide to integrate dotCLOUD Relay with your application or website.
👋 Welcome Aboard!
This guide will walk you through the essential steps to set up your dotCLOUD Relay service for reliable email delivery. Follow these steps to ensure optimal deliverability and performance.
Create Your Account
- Navigate to https://relay.dotcloud.red/auth/sign-up
- Complete the registration form with your business details
- Verify your email address by clicking the link sent to your inbox
- Log in to your new dotCLOUD Relay dashboard at https://relay.dotcloud.red/auth/login
Choose Your Plan
- From your dashboard, navigate to the Pricing or Billing section
- Review the available plans and select the one that matches your email volume needs
- If you're on a free trial, you can explore the service before committing to a paid plan
- Enter your payment information (if applicable)
Configure Your SMTP Settings
Retrieve Your SMTP Credentials
- In your dashboard, navigate to Settings or SMTP Configuration
- Note your unique SMTP credentials:
- SMTP Server: [Provided in dashboard]
- Port: 587
- Username: Your account-specific username
- Password: Your secure SMTP password or API key
- Encryption: [TLS/STARTTLS/SSL]
Configure Your Application
Update your application's email settings with the dotCLOUD Relay SMTP credentials. Here are examples for common scenarios:
Example: WordPress SMTP Plugin
SMTP Host: [Provided in dashboard] SMTP Port: 587 Encryption: TLS Authentication: Yes Username: [your-username] Password: [your-password]
Example: Custom Application (Python)
import smtplib
from email.mime.text import MIMEText
smtp_server = "[Provided in dashboard]"
port = 587
sender = "your-email@yourdomain.com"
password = "[your-password]"
msg = MIMEText("Test email body")
msg['Subject'] = "Test Email"
msg['From'] = sender
msg['To'] = "recipient@example.com"
with smtplib.SMTP(smtp_server, port) as server:
server.starttls()
server.login(sender, password)
server.send_message(msg)
Example: .NET Application (C#)
using System.Net;
using System.Net.Mail;
var smtpClient = new SmtpClient("[Provided in dashboard]")
{
Port = 587,
Credentials = new NetworkCredential("[your-username]", "[your-password]"),
EnableSsl = true,
};
var mailMessage = new MailMessage
{
From = new MailAddress("your-email@yourdomain.com"),
Subject = "Test Email",
Body = "Test email body",
IsBodyHtml = false,
};
mailMessage.To.Add("recipient@example.com");
smtpClient.Send(mailMessage);
Verify Your Domain (Recommended)
To maximize deliverability and ensure emails are sent from your domain:
- Navigate to Domain Settings in your dashboard
- Add your sending domain (e.g., yourdomain.com)
- Follow the instructions to add DNS records:
- SPF Record: Add the provided TXT record to authorize dotCLOUD Relay
- DKIM Record: Add the DKIM signature record for email authentication
- DMARC Record: Configure your DMARC policy (optional but recommended)
- Click Verify Domain to confirm the DNS records are correctly configured
- Wait for verification (typically 5-60 minutes depending on DNS propagation)
Send Your First Test Email
- From your dashboard, navigate to Test Email or Send Test
- Enter a recipient email address (use your own email for testing)
- Click Send Test Email
- Check your inbox to confirm delivery
- Review the delivery status in your dashboard
Monitor Your Email Activity
Dashboard Overview
Your dashboard provides real-time insights into your email activity:
- Total Emails Sent: Track your usage against your plan limits
- Delivery Rate: Monitor successful deliveries
- Bounce Rate: Identify delivery issues
- Recent Activity: View your latest email sends
Email Logs
Access detailed logs for troubleshooting:
- Navigate to Logs or Email History
- Filter by date, recipient, status, or subject
- Click on individual emails to view detailed delivery information
Optimize for Production
Best Practices
- Authenticate Your Domain: Ensure SPF, DKIM, and DMARC are properly configured
- Monitor Bounce Rates: Regularly review bounces and remove invalid addresses
- Respect Rate Limits: Stay within your plan's sending limits to avoid throttling
- Use Meaningful From Addresses: Use recognizable sender addresses to improve deliverability
- Include Unsubscribe Links: For marketing emails, always include unsubscribe options
Security Recommendations
- Rotate Credentials Regularly: Change your SMTP password periodically
- Restrict IP Access: Use IP whitelisting if available
- Enable Two-Factor Authentication: Protect your dashboard access
- Monitor for Unauthorized Access: Review login activity regularly
Scaling Your Usage
As your email volume grows:
- Monitor your usage in the dashboard
- Upgrade your plan before reaching limits to avoid service interruption
- Contact sales for custom enterprise plans with higher volumes
Common Integration Scenarios
Integrating with CRM Systems
dotCLOUD Relay works seamlessly with popular CRM platforms including:
- Salesforce
- Microsoft Dynamics 365
- HubSpot
- Zoho CRM
Integrating with E-commerce Platforms
Send transactional emails from your online store:
- Shopify
- WooCommerce
- Magento
- BigCommerce
Integrating with Marketing Automation
Enhance your marketing campaigns with reliable email delivery:
- Mailchimp
- ActiveCampaign
- Marketo
- Pardot
Troubleshooting Common Issues
Emails Not Sending
- Verify SMTP credentials are correct
- Check that your application can reach the SMTP server (firewall rules)
- Ensure you haven't exceeded your plan's sending limits
- Review error messages in your application logs
Emails Going to Spam
- Verify your domain authentication (SPF, DKIM, DMARC)
- Ensure your sending domain has a good reputation
- Avoid spam trigger words in subject lines
- Include a physical address and unsubscribe link
Authentication Failures
- Double-check username and password
- Ensure you're using the correct port and encryption method
- Verify your account is active and in good standing
- Check for any special characters in your password that may need escaping
✅ Next Steps - You're Ready!
🎉 You're ready to start sending emails with dotCLOUD Relay!
For advanced configurations, API integration, or enterprise features, please refer to our detailed documentation or contact our support team.
📋 Quick Reference Card
| Setting | Value |
|---|---|
| SMTP Server | [Available in your dashboard] |
| Port | [587] |
| Encryption | [TLS/SSL - Check dashboard] |
| Authentication | Required |
| Username | [From dashboard] |
| Password | [From dashboard] |
| Dashboard URL | relay.dotcloud.red |
| Support Email | help@dotcloud.pro |