Setrow

SetRow is an email sending platform specialized in providing transactional email services, primarily utilizing template-based delivery. In the Netmera platform, it is configured as a high-priority email connector.

Overview

Attribute	Details
Connector Name	SetRow
Category	Email Providers
Provider	SetRow (http://www.setrowsend.com)
Primary Function	Transactional and marketing email delivery using templates.
Netmera Adapter Class	SetRowMailAdapterImpl
Data Flow	Outbound (Netmera > SetRow)
Priority Ranking	Highest Priority (Rank 1 for email, subject to service permission).

SetRow is integrated through the SetRowMailAdapterImpl class and is prioritized first among email connectors, followed by Amazon SES and Uzman Posta, provided the necessary Service Permission (ServiceDef.SERVICE_NAME_SETROW_MAIL_SERVICE) is granted to the application.

Use Cases and Benefits

1. Transactional Email Sending: SetRow is predominantly used for sending critical, transactional emails such as order confirmations, password resets, and user authentication notifications.

2. Template-Based Delivery: Emails must be created as templates within the SetRow panel first. Netmera sends the request using the unique transcode of the SetRow template along with personalized data, allowing the platform to rely on SetRow's infrastructure for rendering and delivery.

3. High Deliverability and Priority: Due to its Rank 1 priority, if SetRow is configured and active with the correct service permission, all compatible email traffic will be routed through it first, ensuring fast and reliable message delivery.

4. Integration with Netmera Messages: Users can select the SetRow template when creating an email message in the Netmera panel (Messages > Create Message > Email), ensuring the email sending process uses the SetRow API.

Data Flow

The data flow is strictly Outbound from Netmera to the SetRow API.

1. Message Creation: An email message is created in Netmera, specifying the SetRow template transcode and personalization parameters (messageParams).

2. Adapter Selection: The MailSenderServiceImpl checks active email connectors. If the application has permission to use SetRow Mail Server Service, the SetRowMailAdapterImpl is selected as the top priority.

3. Template Synchronization: When the email message is saved, the SetRow template is automatically synchronized or updated on the SetRow platform via the SetRow service layer (SetRowService).

4. API Submission: The adapter uses the configured apiKey to authenticate and submits the transactional request to the SetRow API, including the template transcode and user data.

$\text{Netmera Mail Sender} \xrightarrow[\text{SetRowMailAdapterImpl}]{\text{Template Transcode + API Key}} \text{SetRow API}$

Configuration Reference

The configuration for SetRow is minimal, relying on a single API key for authentication.

Parameter	Type	Description	Provider Context
apiKey	String	The unique API key provided by SetRow.	Used for API authentication when submitting transactional email requests.

Setup Instructions

The setup requires obtaining the API key from the SetRow platform and performing a connection test within Netmera.

Step 1: SetRow Prerequisites

1. Establish an account with SetRow.

2. Log into the SetRow panel and retrieve your API Key.

3. Create and manage your email templates, noting their specific Transcodes.

Step 2: Configure in Netmera

1. Navigate to the Netmera Control Panel and select the Connectors section.

2. Choose the SetRow connector.

3. Enter the obtained API Key.

4. Crucially, utilize the "Test Connection" feature provided in the SetRow connector configuration page to verify the connection.

5. Click Save Configuration.

Verification: A successful connection test confirms that Netmera can authenticate with SetRow. Subsequent verification involves creating a test email in Netmera using a SetRow template transcode and confirming successful delivery.

Usage Notes & Considerations

1. Service Permission Requirement: SetRow is the highest-priority email connector, but it is contingent upon the application possessing the specific service permission (ServiceDef.SERVICE_NAME_SETROW_MAIL_SERVICE). If this permission is not configured for the application, the system will fall back to the next connector (Amazon SES).

2. Template Dependency: The integration is designed around SetRow's template structure. All email content must correspond to a pre-defined and managed template (identified by its transcode) on the SetRow platform. It may not support direct HTML injection for mass campaigns as easily as raw API senders.

3. Limited Test Connection: The documentation notes that test connection functionality is specifically available only for Amazon Storage and SetRow, implying a higher dependency on this verification step compared to other connectors.

4. Authentication Reliance: The entire email flow depends on the single apiKey. If this key is compromised, rotated on the SetRow side, or expires, the connector will fail immediately, requiring a manual update in Netmera.

The SetRow integration operates like a secure vault for your email templates: Netmera provides the security key (API Key) and the instruction code (Template Transcode), ensuring that highly sensitive transactional messages are dispatched directly and reliably by the specialized SetRow infrastructure.