Helpdocs for email services
Related Docs
When utilising email services to communicate with your audience, it's essential to follow the warm-up process diligently. Warm-up is a strategic method to gradually increase your email sending volume, ensuring a smooth and successful delivery to your recipients.
Why is Warm-Up Necessary?
Sending a large number of emails abruptly, without a proper warm-up, can trigger spam filters on recipient clients such as Gmail or Outlook. These email providers monitor the sending behavior of IP addresses and domains. If they detect a sudden and high volume of emails, they may categorize your emails as spam or may blacklist your domain, leading to potential delivery issues.
How to Conduct Warm-Up:
To optimize your email deliverability, we recommend starting with a conservative email volume and gradually increasing it over a specified period. Here's a suggested approach:
Day 1: Send a small batch of 5,000 emails.
Subsequent Days: Increase the daily email count by 10-20%, gradually reaching your desired volume (e.g., 100,000 emails per day).
Benefits of Warm-Up:
Improved Deliverability: Gradual increases in email volume help establish a positive sending reputation of your domain and IP, reducing the likelihood of emails being marked as spam.
Enhanced Engagement: ISPs (Internet Service Providers) are more likely to recognize your emails as legitimate, leading to improved open and click-through rates.
Avoiding Spam Folders: Warm-up minimizes the risk of your emails ending up in the spam folder, ensuring they reach your audience's primary inbox.
Key Takeaway:
Taking the time to perform an effective warm-up is an investment in the success of your email delivery. By following this process, you maximize the chances of your emails being delivered to the intended recipients' inboxes.
Warm Up in Email Sen...
By configuring webhooks, you can automate the process of receiving important updates directly to your specified URL endpoint, ensuring you always stay informed about your email activities. This guide covers three main notification types: Delivery Report, Incoming Mails, and Domain Status.
Getting Started
Before you begin, ensure you have the necessary permissions to manage webhooks and access to the MSG91 dashboard.
What You Will Need:
- Access to the MSG91 dashboard
- A valid post URL endpoint where you wish to receive notifications
Configuring Your Webhook
1. Delivery Report
Purpose: Receive real-time notifications about the delivery status of your emails.
Configuration Steps:
1. Navigate to the email section on your MSG91 dashboard.
2. Select the "Webhook" option.
3. Under "Delivery Report," enter your webhook URL where you wish to receive delivery status notifications.

2. Incoming Mails
Purpose: Get data of incoming emails directly to your specified webhook URL.
Configuration Steps:
1. In the "Webhook" section, locate the "Incoming Mails" option.
2. Input the webhook URL where you want to receive data about incoming emails.
3. Domain Status
Purpose: Monitor changes in your domain status and receive updates if your domain's status fluctuates.
Configuration Steps:
1. Within the "Webhook" settings, find the "Domain Status" area.
2. Provide the webhook URL to receive notifications regarding your domain status.
For SPF, DKIM, MX and Status (of domain) : Value 2 is verified; 1 is unverified.
For Domain Enabled Status : Value 1 is enabled; 0 is disabled.
Additional Settings
Headers:
- Optional: You may specify headers to pass along with the webhook URL according to your technical requirements.
- If you do not have specific needs, you can leave the headers section blank.
Body:
- To view the payload that will be sent to your webhook, click on the "Body" section. This allows you to see and prepare for the data structure you will receive.

HTTP Response Codes
Understanding the HTTP response codes you might encounter while using webhooks is essential for troubleshooting and ensuring smooth operation. Here are the common codes and their meanings:
200 OK
401 Unauthorized
403 Forbidden
422 Invalid request Body
500 Internal server error
504 Gateway timeout
Conclusion
Setting up webhooks in MSG91 for email services is a straightforward process that empowers you with real-time data about your email communications. By following this guide, you can seamlessly integrate these notifications into your systems, enhancing your email management capabilities.
For further assistance or questions, please refer to our FAQ section or contact our support team.
Webhook for Email Ac...
Congrats on your new Topic! Meet the 'Master Article' 🌟 – unmovable and the first thing you'll see when you open the topic on Knowledgebase. Think of it as the grand opener, guiding your readers with insights. You're in control here – organize, publish, tweak – it's your space.
This isn't just an article; it's the ultimate guide, helping readers sail through info smoothly. Here's the deal: you can't delete it or unpublish it. But, if you want, you can set another article as the 'Master Article' anytime you like.
Remember, this sets the tone for your topic. Let your expertise shine, and let's kickstart this topic on the right foot! 🚀
Email's Master Artic...
This feature is used to connect your existing email service provider (Gmail & Outlook) to your MSG91 account and use the same to send emails.
How to set up email connections?
1. Click on Email on the home screen

2. Click on connections from the left menu pane.

3.You’ll get the option to choose from Gmail or Outlook. Choose one of the following option which you want to use and click continue (You’ll be redirected to the service provider URL for login)

4. Provide the login credentials of your existing email or create a new account and click continue

5. It’ll take you to the page where you can check the permissions for MSG91 and also the privacy policy, if you are ok with that click on continue. Once done you can see the account under Connection in your email dashboard and you will be able to send emails from it.

Note : The email limits and restrictions will be as per your email service provider.
6. If you want to add another account you can click on the Connect button on the top left side of the screen and continue from step 3 to step 5

7. If you want to delete the any existing connection then just hover over the connection that you want to delete and click the delete button
8. In order to send emails using API for connections, kindly use the same cURL as Send Email API and replace "domain" with "integration_id" which can be found under the connection tab. Also "from field" is not required if you are using connections as the from email will be the email as per connection.

Email Connections
MX (Mail Exchange) records are a crucial part of email communication, as they ensure that your domain can send and receive emails properly. If your MX records are not verified, you may encounter several issues that can negatively affect your email deliverability and domain reputation. Below are some potential problems that can occur if your MX records are not set up or verified:
Inability to Receive Emails
Without MX records, your domain won’t be able to receive incoming emails. If you’re not allowing incoming mail, recipient mail servers will notice this issue, which could harm your domain’s reputation. This could signal to others that you’re not supporting two-way communication, which might raise concerns about the legitimacy of your domain.Undelivered Bounce-Back Messages
If users are unable to receive emails due to their own firewall settings or if the emails are being flagged as spam, the recipient's mail server will typically attempt to send a bounce-back message. However, without proper MX records, this bounce-back message will not be delivered to you. This can further impact your domain’s reputation, as recipient servers like Google or Hotmail may view this as an email misconfiguration and could flag your domain as unreliable.Risk of Being Flagged by Spam Filters
Spam filters from major email services (like Google, Hotmail, and Yahoo) rely on the presence of valid MX records to verify that a domain is properly configured for email communication. Without verified MX records, your domain may be flagged as suspicious, increasing the chances of being blacklisted. This could severely hinder your ability to send legitimate emails, leading to delivery failures and decreased email engagement.Negative Impact on Deliverability
Email service providers (ESPs) use MX records to route email traffic. If they cannot find valid MX records for your domain, they may reject your emails outright. Even if your email is not flagged as spam, the absence of verified MX records makes it difficult for ESPs to ensure that your domain is trustworthy. This can lead to a lower inbox placement rate and higher chances of your emails being marked as spam.
How to Resolve These Issues
To avoid these problems, it’s essential to verify your MX records. Here’s the recommended solution:
Verify MX Records for Your Sub-domain: By verifying the MX records for your sub-domain, you’ll allow proper routing of incoming and outgoing emails for that sub-domain without needing to verify the main domain directly.
This verification process ensures that your domain is configured correctly for email communications, which helps maintain your reputation, improves email deliverability, and ensures that emails can be sent and received smoothly.
Why MX Records are m...
Now you can easily view and reply to all email responses from a single dashboard. Explore Hello Inbox to efficiently manage all replies and respond promptly. To get started, simply click on Hello.

After clicking on Hello, select All Inboxes

After clicking on all inboxes, Then, simply click on the Create Inbox button located at the top-right corner

After clicking on create inbox, Select Email Inbox to integrate your Msg91 email account

Select MSG91 and click on Create Now

After selecting the MSG91 Inbox, you’ll need to fill in the following required fields:
Inbox Name: This is how the inbox will be displayed in Hello, allowing you to view all responses. Select Domain: Choose the configured domain you have used in your MSG91 email service.
Email : Add the same email ID you used for sending emails through your MSG91 account.
From Name: Set the name that will appear to users when responses are triggered
After filling in the required fields, click on Next to proceed.

In the next field, set the permissions for handling email responses. Select the agent or team based on your Hello Inbox configuration, or click on 'Invite an Agent' or 'Add a Team' as needed. Once done, click on Save & Next to proceed

Next, you'll see the forwarding option. Keep the settings as they are and click Next

In the next field, you'll find the configuration option. Add your signature so it appears in the email replies. Enable Show Mail Thread to view the entire email thread in Hello. The Undo Email option allows you to undo an email after sending, set the duration and click Save.

After clicking on Save, your integrated Email Inbox will appear in the "Hello All Inboxes" section and below the filters, your configured Email Inbox will be displayed. After selecting the Email Inbox, you can review all received email responses and respond accordingly.

Next, to complete the setup, go back to your MSG91 email service, click on Webhook, and add the provided URL - https://api.phone91.com/receive-mail/ in the Incoming Email Post section & click save to start receiving email responses in Hello.

By following these simple steps, you can seamlessly manage and respond to all your email replies instantly from a single dashboard using the same email ID in Hello.
You can also check how to use Hello to manage and reply to all your customer responses effectively - https://video-faq.viasocket.com/demo/cm4s55g6y01uqql5jashah58w
How to View and Resp...
Gmail Markup uses schema.org structured data to enhance emails by enabling quick actions and highlighting important information directly in the inbox. This allows users to interact with emails such as checking into a flight, confirming an event, or tracking an order without opening the email fully or clicking external links..
Example Use Case:
If you send a flight booking confirmation email, Gmail Markup can display a “Check-In” button inside the email, allowing users to check in directly from their inbox.

Types of Actions & Interactive Cards
Gmail supports various actions and interactive cards, which allow different types of user interactions:
For a full list of supported actions, refer to Gmail Markup Documentation.
Using JSON-LD and Microdata in Gmail Markup
1. JSON-LD Format (Recommended) -
JSON-LD is the preferred format as it allows structured data to be included in a <script> tag inside the email - <script type="application/ld+json">
This format supports multiple predefined structures that help you customize the JSON object to display the data as required.
<script type="application/ld+json">
{
"@context": "http://schema.org",
"@type": "Person",
"name": "John Doe",
"jobTitle": "Graduate research assistant",
"affiliation": "University of Dreams",
"additionalName": "Johnny",
"url": "http://www.example.com",
"address": {
"@type": "PostalAddress",
"streetAddress": "1234 Peach Drive",
"addressLocality": "Wonderland",
"addressRegion": "Georgia"
}
}
</script>
2. Microdata
Microdata consists of name-value pairs, called items, which are defined according to a specific vocabulary. These pairs help organize and structure the data within the email to make it easier for Gmail to display key information.
<section itemscope itemtype="http://schema.org/Person">
Hello, my name is
<span itemprop="name">John Doe</span>, I am a
<span itemprop="jobTitle">Graduate research assistant</span>
at the
<span itemprop="affiliation">University of Dreams</span>
My friends call me
<span itemprop="additionalName">Johnny</span>
You can visit my homepage at
<a href="http://www.example.com.com" itemprop="url">www.example.com</a>
<section
itemprop="address"
itemscope
itemtype="http://schema.org/PostalAddress">
I live at
<span itemprop="streetAddress">1234 Peach Drive</span>
<span itemprop="addressLocality">Warner Robins</span>
<span itemprop="addressRegion">Georgia</span>.
</section>
</section>
Both formats require DateTime values to be in the ISO 8601 format, like this: '2013-02-14T13:15:03-08:00' (YYYY-MM-DDTHH:mm:ssZ).
Testing Gmail Markup
To ensure proper functionality, test your markup using the following methods:
Send a Test Email:
Send an email from your Gmail account to the same Gmail account.
Refer to the Google Developers Guide for step-by-step testing.
Use the Google Markup Tester to check your structured data: Google Markup Tester.
Whitelisting Process
There is a whitelisting process, similar to AMP Emails, where Google verifies the schema we send. Once the schema is verified and whitelisted, the highlights and actions will be visible in the email.
For more details on the whitelisting process, refer to this link
By following this simple step, you can easily design your interactive email template using Gmail markup.