Introduction
Connecting MailGun with your Chamaileon account allows you to streamline your email marketing workflow, enabling seamless syncing of email designs and content.
Through this synchronization, email templates in Chamaileon will be directly tied to a MailGun campaign.
Each time the design or content is updated in Chamaileon and the Sync button is pressed, the campaign design will automatically update in MailGun.
This guide will walk you through the integration process step-by-step, covering everything you need to know to get started.
Prerequisites
Before you begin the process, make sure you have:
An active Chamaileon account with Administrator or Content Manager access.
Access to your MailGun account with the necessary permissions (e.g., Admin or API access).
A MailGun API key, which you need to obtain from MailGun.
Step-by-Step Integration Setup Process
Step 1: Access Integration Settings in Chamaileon
Log in to your Chamaileon account.
Navigate to the Workspace settings and select the "Integrations" tab.
Choose "MailGun" from the list of available integrations.
Step 2: Obtain API Key and Configure User Permissions in MailGun
Log in to your MailGun account.
Navigate to the API settings or integration section (the specific location may vary depending on the platform).
Generate or locate the API key required for the integration.
Note: Ensure you have the correct user permissions to access these credentials.
Copy the API key and return to Chamaileon.
Step 3: Authorize MailGun with Chamaileon
In the Chamaileon integration setup for MailGun, create a new Variation. Each variation serves as a distinct account connection, allowing you to sync emails from one Chamaileon account to multiple MailGun accounts.
Name the integration variation and click “Auth.”
Enter the API key you obtained from MailGun to complete the authorization.
Data Sync Details
The integration will sync the following data between Chamaileon and MailGun:
Subject: The email's subject line.
Preview Text: The preview text displayed in the recipient's inbox.
Domain: The domain through which the email will be sent.
Name: The name of the email campaign.
Description: A brief description of the campaign.
Testing the Integration
To test the integration, try syncing a sample email template from Chamaileon to MailGun.
Check your MailGun account to verify that the campaign has been successfully imported.
If the export is successful, you’re all set!
Handling API Limits and Security Considerations
API Limits: MailGun may impose API call limits. Refer to MailGun's documentation to ensure you stay within these limits.
Security: Keep your API key secure and do not share it. If you suspect it has been compromised, regenerate the key in your MailGun account.
Troubleshooting and Known Limitations
Common Issues:
If the connection fails, double-check that the API key is correctly copied and has the necessary permissions.
Ensure that your MailGun account has the correct access level for integration.
Known Limitations:
This integration supports syncing only email templates and campaigns.
Supported file types and character limits depend on MailGun’s specifications.
Notifications: Chamaileon will notify you in case of integration issues, such as failed syncs or expired API keys.
Disconnecting or Removing the Integration
To safely disconnect or remove the MailGun integration, go to the “Integrations” section in Chamaileon Workspace settings.
Click on the MailGun card, select the desired variation, and click the red "Delete Variation" button.
Remember to remove access/authorization/API keys from MailGun as well.
Sync Email Designs with MailGun
From the email dashboard, click the "Sync" button in the email's menu.
Choose "MailGun" from the options list.
Customize your email campaign's settings, such as the subject line, preview text, domain, name, and description before clicking "Sync."
Attention!
Never edit the code directly in MailGun, as its editor might alter the email HTML code, potentially causing size or rendering issues. Use Chamaileon’s visual editor interface for any changes and the Sync button to update the design.
Syncing one template to multiple MailGun accounts is possible using Integration Variations, so avoid copy-pasting the email HTML manually.
Conclusion
You have now successfully integrated MailGun with your Chamaileon account! This integration will enhance your email marketing process by allowing seamless exports and efficient content management. If you have any questions or encounter issues, please refer to our support documentation or contact our support team.