Email Provider Setup
Communication Management lets you work with emails within J1 Web. Emails can be sent on-demand and included with other interactions in an automation plan that gets sent at a scheduled time. To utilize these features, an email provider is needed to send, receive, and store emails. You can use Jenzabar’s Client Application Services or SendGrid, Jenzabar’s integrated solution.
Client Application Services and SendGrid Comparison
Feature | Client Application Services | SendGrid |
---|---|---|
Basic Email | ✓ | ✓ |
Real-time bidirectional emails | ✓ | |
Plain text email formatting | ✓ | ✓ |
HTML template email formatting | ✓ | ✓ |
Analytica (e.g., how many emails were opened, forwarded, bounced back, etc.) | ✓ |
Note
Recipients must have a valid, active, verified email address in the system. They are not limited to using their institutional email address; personal email addresses are also acceptable.
Recipient Email Addresses
For recipients to receive email interactions, they must have a verified, valid email address in the system. J1 Web looks for email addresses on the Person Information Details page in the order that they are prioritized on the Data Definitions page.
Notice
If you have identified *CUR as the highest priority and *LHP as the second highest priority, then the system will look for a *CUR email address first. If no *CUR email address is found, it will look for one identified as *LHP.
When a recipient clicks an unsubscribe link in an email interaction, their Verified Status is automatically changed to Unsubscribed and they no longer receive email interactions at that email address. For more information about opting in and out of interactions, see Recipient Opt In and Out.
Warning
Your school may already be using Client Application Services for relaying emails with the Desktop application. Contact your System Administrator or Customer Success Representative for more information.
Base Communication Management uses Client Application Services SMTP relay to send emails. School already using J1 Web or Desktop are likely using Client Application Services for other features.
Client Application Services only supports outbound communications. Email replies go to the email address of the person the email is from and not back into J1 Web.
Client Application Services doesn't offer analytic data. Dynamic WYSIWYG email formatting options are available, but only if you are licensed for Communication Management Plus.
Access the Desktop application.
Access the SMTP Relay Configuration window.
Select the Relay E-mail Messages with J1 Client Application Services option.
From the Relay Server Name, select the server you want to use.
Note
J1 Client Application Services must be installed on the relay server machine you select in this step.
Click Save.
Create and Configure a SendGrid Account
Communication Managment Plus integrates with SendGrid to provide enhanced emailing capabilities. SendGrid is a communication platform that facilitates real-time, bi-directional emails.
Allows your school to send, receive, and save email messages, which are then associated with the appropriate records in the system.
Provides informative analytics.
Includes robust content editing features.
When you set up SendGrid for the first time or change your email provider to SendGrid in System Settings, the system creates email assignments in Communications Management for all active J1 Web users. These email addresses append the inbound subdomain configured to send and receive emails to the username your users enter to log in to J1 Web (i.e., the value in the USER_ID field of the APP_USER table). For example, if a J1 Web username is charlie.brown and your inbound subdomain is inbound.school.edu, the J1 Web email address will be charlie.brown@inbound.school.edu. Email assignments can be reviewed in J1 Web on the System Administration, Communication Settings page, Email Assignments tab.
If you plan to set up a test/play environment to work with Communications Plus, Jenzabar recommends creating two entirely different environments with unique DNS entries for each.
Access https://signup.sendgrid.com/.
Create an account.
From the account dashboard, click your name in the top, left corner and choose Account Details.
Click the Your Products tab.
Choose an email API plan.
Jenzabar recommends the Pro 100K subscription at a minimum. This plan provides a dedicated IP address for your account and ensures your email success is not impacted by other users in the SendGrid ecosystem.
For SendGrid to send emails from your domain, you must create two environments with unique DNS entries for each. The live/production envrinoment will use the primary J1 Web SendGrid account and the test/play environment will use the subuser account. This lets you have distinct environments that share billing resources.
Eventually, SendGrid will direct all inbound emails destined to your subdomain to the J1 Web server. To avoid disruption to your normal .edu email services, Jenzabar recommends creating a new subdomain that will be used exclusively for communication to and from J1 Web.
Note
mail.jenzabaruniversity.edu would be used for emails@mail.jenzabaruniversity.edu.
Log in to your SendGrid account. The Welcome page appears.
Click Authenticate domain. The Authenticate Your Domain page appears.
From the Which Domain Name Server host do you use? drop-down, select your domain name server (DNS) host. If you are using one that is not listed or your own DNS, select Other Host.
Note
If you select a cloud DNS host provider, most of the configurations are completed for you.
From the Would you also like to brand the links for this domain options, select:
Yes to ensure links look like they came from within your institution (Jenzabar recommended).
No to make links in emails look like they came from somewhere outside of the institution. For example, they'll include sendgrid.com in them. When a recipient clicks a link, they'll be routed through SendGrid before reaching the link you provide.
Click Next.
Enter your sending domain. To avoid disruption to your normal day-to-day .edu email services, Jenzabar recommends creating two new subdomains that will be used exclusively for communication to and from J1 Web. One for your production environment like J1mail.school.edu or J1.school.edu and one for your test environment like j1test.school.edu.
Click Advanced Settings. Advanced Settings options appear.
Select Use automated security checkbox and click Next. The Install DNS Records page appears.
Note
This setting ensures DKIM keys are automatically rotated and communications remain secure.
I THINK THEY NEED TO PICK ONE AND CLICK COPY. Host or Value?
Keep SendGrid open and access the application, tool, or service your school uses to manage your public DNS configurations.
Enter the CNAME entries provided by SendGrid in your DNS provider in order to authenticate your domain.
Add the following MX record for your domain to support inbound emails:
Note
The MX record reroutes inbound communications to SendGrid.net for authentication.
MX 10 yourinboundsubdomain mx.sendgrid.net
Save your changes.
Access the MX Lookup tool (https://dnschecker.org/mx-lookup.php).
Verify your subdomain MX record is correctly pointing to mx.sendgrid.net.
Return to SendGrid.
Select the I've added these records checkbox and click Verify. An email is sent to your designated testing recipient. The email includes a link that verifies your domain.
Note
Do not click the link more than once because the values will change.
Be sure you enter the authentication information exactly as it appears in the email. Periods and spaces in the wrong place can invalidate your credentials.
If SendGrid does not return a successful verification, adjust your DNS until it properly verifies. If you need assistance with Sender Verification, log a ticket with SendGrid Customer Support (https://sendgrid.com/docs/ui/account-and-settings/support/).
Click API Keys from the left-hand menu. The API Keys page appears.
Click Create API Key. The Create API Key page appears.
In the API Key Name, enter J1 Web.
From the API Key Permissions, select Full Access. This allows J1 Web to manage your account via the API, which enables endpoints configuration and statistic collection.
Click Create & View. The API Key Create page appears and shows your API Key. Your key is only shown once so copy and paste it somewhere like Notepad where you can access it for entering into J1 Web.
Click Done.
From the API Key Permissions, select Email Address Validation Access. This creates a key for J1 Web email validations.
Slide the Validation bar to Full Access.
Click Create & View. The API Key Create page appears and shows your API Key. Your key is only shown once so copy and paste it somewhere like Notepad where you can access it for entering into J1 Web.
Access the SendGrid Dashboard.
Click Settings and select Subuser Management.
Click the Create New Subuser button.
Provide a username that will be used to log in to SendGrid to manage your Test environment. The username must be unique.
Provide an email address and password to be used with the account. You can use the same primary account email address.
If you are using the Pro100 account or greater, you can select which IP address you’d like the Test environment to use.
Enter your City, Country, Zip Code, and State.
Click Create Subuser.