• Open CleverTap > Settings > Channel > Select “WhatsApp”

  • Choose “WhatsApp Connect” and Select the blue button “+ Provider Configuration”.


  • Now choose “Generic (Other)” from the drop down and fillup these fields - 


—-----------

Copy both the callback URLs and send it over an email to [email protected] with this content - 


Hi Support, we wish to enable WhatsApp integration with CleverTap. Please enable these webhooks with your CleverTap connector.


  1. Webhooks - 

    1. Delivery Report Callback URL - Paste_the_URL_here

    2. Inbound Message Callback URL - Paste_the_URL_here

  2. WhatsApp Integrated Number - Add_your_number_here

  3. MSG91 Account Username - Add_your_username_here


Thanks!

—-----------

  • Add these values under Headers

  • Add these values
    Authkey - MSG91 Authkey
    Content-type : application/json
    Accept : application/json

  • Select this checkbox and type “50” in the field.

Now test the WhatsApp Connector and you are good to go.


Few Points - 

  1. Please don’t save the integration till the Webhook URLs are configured within MSG91. After sending the email, please confirm with your AM to check if Webhooks have been enabled, then only test the integration.

  2. Mobile number has to be added with country code and without the “+” sign.

NOTE: If sent without a country code, submission and deduction depend on the detected country based on the starting number: For, 91xxxxxxxxxx, etc

WhatsApp CleverTap C...

Invalid Date

WhatsApp Charges:

500/-per month per WhatsApp Number (Platform charges)

WhatsApp Message Charges:

Meta pricing - zero margin


Step 1: Go to the MSG91 Dashboard and click on WhatsApp. 


Step 2: Click on the ‘Subscription’ button from the left side panel.

Screenshot 2025-01-01 at 5.29.11 PM.png



Step 3: After clicking "Subscription," click the "Show Details" button for the number you want to make changes.

Screenshot 2025-01-01 at 5.25.56 PM.png




A. Remaining Prepaid Balance: This balance is reserved exclusively for WhatsApp usage. Adding it helps prevent communication failures due to low balance and reduces the need for frequent postpaid deductions.


Note: This balance will be used only after you've exhausted your included WhatsApp balance, and it is non-refundable to the wallet. 

B. Balance Auto-Recharge: In this section, there are two amounts. The "Threshold Amount" sets a limit, and when that limit is reached during a campaign, the "Recharge Amount" is automatically deducted from the wallet.

This feature is typically enabled to ensure the campaign runs smoothly without any interruptions due to insufficient funds.

C. Extra Balance Charges: MSG91 provides a postpaid limit of ₹90, allowing you to use this amount if your main wallet doesn't have sufficient funds. The postpaid amount will be deducted once you recharge your main wallet.

Note: You'll need to clear the dues within 4 working days after you've reached the limit. If not, your WhatsApp Subscription plan will expire.

Due to insufficient balance if the number renewal expires then in that case your auto-recharge will also not work automatically and you need to add the balance manually to the prepaid balance of Whatsapp.


 D. Monthly Limit: This is a postpaid monthly spending limit, separate from your prepaid balance. It's useful if you're using multiple services and want to allocate a specific amount for a particular service.

WhatsApp Subscriptio...

Invalid Date

How to turn off the 2-factor authentication

Step 1: Go to the WhatsApp Manager. Select phone number from the left hand side panel. 

Step 2: Click on Settings Icon. 


Step 3: Click on ‘Two-step Verification’ and turn off the verification from the button mentioned. 



Step 4: A link will come to your respective mail ID, which you have connected with the Meta Account, click on that link and click on the Turn Off 2 Step Verification.  

How to turn off the ...

November 10, 2024

Step 1 - Open Msg91 dashboard and Click on Whatsapp



​Step 2 - Number section will open. Click on the edit button on your chosen number from right side.

Screenshot 2025-01-31 at 4.21.42 PM.png


​Step 3 -  After clicking on settings, a dialog box will appear, enable Welcome message toggle and click on Save

Screenshot 2025-01-31 at 4.22.13 PM.png

Whatsapp Icebreaker

Ice Breakers are interactive text options that appear in a WhatsApp conversation when a user chats with you for the first time. These customizable prompts, can guide users towards specific actions or services.


How to configure?

In the same dialog box as welcome message, there is an option of “Icebreaker”. Click on it. This is how it would loo

We can add upto 4 icebreakers.

Icebreakers give customers an idea of our services. For example, a clothing store can have icebreakers like “brands on discounts” or “trending fashion” for customers to start a conversation.

Screenshot 2025-01-31 at 4.25.56 PM.png


Whatsapp Commands 


Commands are text strings that WhatsApp users can see by typing a forward slash in a message thread with your business.

You can define up to 30 commands. 




How to configure?

"Go to the 'Commands' section and click 'Add Commands'. You can create up to 30 custom commands. Give each command a clear name and a helpful description. A preview of your command will appear on the right side of the screen as you type."

Screenshot 2025-01-31 at 4.29.57 PM.png


​Each command consists of a command word and a hint. For example, you can create a command like '/suggest places to visit in monsoon'. The command word is '/suggest' and the hint is 'places to visit in monsoon'.

WhatsApp Icebreakers...

Invalid Date

1. What is “Template Pacing”?
"Template Pacing" is a feature by Meta that initially sends marketing messages to a smaller subset of a campaign's total audience and assesses the quality of the content based on the initial feedback received, depending on the quality assessment.

2. Does template pacing apply to all types of templates? 
Template pacing is relevant exclusively for marketing templates.

​3. Where can we understand template quality?
Partners and businesses should monitor template quality ratings in WhatsApp Manager or set up webhooks for immediate quality signal alerts.

4. How does WhatsApp assess the quality of a campaign during Template Pacing? 
When the initial messages are sent, WhatsApp monitors real-time user feedback and quickly processes it to determine an accurate quality assessment of the template.

​5. How will template pacing work? 
​Instead of broadcasting the template to everyone, the message will be sent to a selected group of recipients. WhatsApp will evaluate the quality of the template using these sample messages, while processing the rest of the queued messages. If the sample messages receive positive feedback, the rest of the messages will be sent. However, if the feedback is negative, the remaining queued messages will be canceled, and the business will be informed about the poor-quality feedback from users.


6. How will template pausing work in conjunction with template pacing?
Meta uses the same system and indicators for evaluating template quality in Template Pacing as they do for template pausing and other quality enforcement measures. This means that messages dropped during Template Pacing due to low-quality templates would have been paused later on a larger scale. By offering this quality assessment earlier, Meta provides businesses with greater predictability and control. Template Pacing happens within the first 30 minutes of a campaign, allowing businesses to respond more quickly compared to hours or days later with template pausing. However, even after initial success, a template might still encounter quality issues.

7. Will phone number rate limiting no longer take place?
If a business does not improve its messaging quality over time, phone number rate limiting will still occur. However, similar to the effect of template pausing, template pacing is expected to lessen phone number downgrades by providing quicker quality feedback at the template level. Meta is currently exploring updates to phone number rate limiting and will provide more details in the coming months.

8. How long does the Template Pacing process take before deciding to send or drop the remainder of the messages?
Once WhatsApp begins processing messages, Meta intends to make a prompt decision. However, if the quality systems cannot reach a decision within 30 minutes, they will permit the template to scale and send messages to the rest of the recipients. It’s important to note that not all messages will be queued; the pace limit is influenced by the speed of user feedback and the accuracy of quality assessments.

9. Can Template Pacing be applied to any campaign, regardless of its size? 
Although specific details are not provided, Template Pacing is mainly intended for high-volume marketing campaigns. Our pacing system is designed to make the process smooth for businesses, giving them complete transparency into the progress of their messages.

10. What happens if the user feedback during the Template Pacing process is negative?
If WhatsApp finds that the feedback from the sample users is unsatisfactory, Meta will discard the remaining queued messages and notify businesses via email, webhooks, and WhatsApp Manager notifications. Businesses can reactivate templates that were paused during the quality assessment phase using either the API or the WhatsApp Manager UI.

11. Can I decide the size of the initial audience for the Template Pacing process, or is it predetermined by WhatsApp? 
WhatsApp will set the size of the initial audience in advance and manage the entire message delivery process for your campaign.

12. What feedback will be provided to businesses during template pacing, and through which channels? 
If a template is paused and messages are dropped, the business will be notified through:

- Business Manager Notifications Center

- WhatsApp Manager Banner

- Email

- Webhook (message_template_status_update)


Furthermore, any quality changes will be communicated through the message_template_quality_update webhook. The business will also receive updates via webhooks for message sends from and drops from the queue through the messages webhook.

WhatsApp- Template P...

November 27, 2024

 1. How to send an image in your template at the place of the header using a campaign?

Step 1: On the MSG91 Dashboard, click on WhatsApp. 

Step 2: After Adding the number on WhatsApp, click on the ‘Templates’ option from the left-hand side panel to create a new template. Click the ‘Create new template’ button from the right-hand corner. 

Step 3: Fill in all the details while creating the template, such as Name, category, and Language. 
In the header section, select ‘Media’ and in ‘Media Type’ choose Image. 

Step 4: Click on the ‘Add Sample’ button beside the Save button, to add the sample of the image. A pop-up will be showcased. Click on ‘Upload Image’ to upload the image of the template. 



Step 5: Once the template is approved, launch the campaign and select the respective template.


 2. How to change the Display name on meta?

Step 1: Go to the Facebook business page and, from the left-hand side panel, click on the hamburger icon (the three horizontal lines) and then click on Business Settings.
​ Select the WhatsApp Accounts option from the left-hand side panel. 



Step 2: Go to WhatsApp Manager, and select the phone number. The display name can be changed from there. Just near the name, if you hover it around, a pen icon will appear, by clicking onto it you can change the display name.



3. How to turn off the 2-factor authentication?

Step 1: Go to the WhatsApp Manager. Select phone number from the left hand side panel. 



Step 2: Click on Settings Icon. 



Step 3: Click on ‘Two-step Verification’ and turn off the verification from the button mentioned. 


Step 4: A link will come to your respective mail ID, which you have connected with the Meta Account, click on that link and click on the Turn Off 2 Step Verification.  



4. How to check the messaging limit and also how to increase the limit?

Step 1: Go to WhatsApp Manager and select the overview option from the left-hand side panel. Here the messaging limit of the business account will be showcased. 

Note: At first the limit will be 250 conversations, after the process of business verification it will reach 1000 conversations. 
Increasing the limit depends upon your level of inputs and quality in the messages, sending up of messages to original users and their readability rate. 


5. How to change the display image on Meta and how to raise a ticket on Meta?


Step 1: Click on WhatsApp from the dashboard.



Step 2: Click on Numbers from the left-hand side panel. In that click on profile icon.



Step 3: Display image can be changed and uploaded from here.




Step 4: Go to the Meta Business page, click on business support home.
 

 


Step 5: Go to WhatsApp Accounts, click on the account for which you want to raise a ticket for the issue being faced by you. Here you can raise the ticket.



Step 6: The brief details will be provided to you in the activity issues.

 




6. How to Remove Mobile Number from Meta?


Step 1: Go to the Facebook business page and from the left-hand side panel, click on the hamburger icon (the 3 horizontal lines) and click on Business Settings. 
Select the WhatsApp Accounts option from the left-hand side panel. 



Step 2: Select the phone number from the left-hand side panel. A delete button will be showcased beside settings. Click on that button and the number will be deleted. 


7. How to request a review on the Meta Account? 

Step 1: Log in to your business account and select the business connected with MSG91. 

From the left-hand panel, click on 'All Tools' and select 'Business Support Home.


Step 2: Select the integrated WhatsApp account.




Step 3: Request a review from the button mentioned on the right-hand side.





8. Basic errors along with solutions that occurs while delivering the WhatsApp Templates.


131026: Message Undeliverable- 

This error occurs from the side of Meta for marketing messages. 

The reasons for the occurrence are as follows:

1. Meta has renewed its policy, in that a user can only receive up to 5 promotional messages in a day from any business that is sending the promotional messages. 

2. The message was not delivered to create a high quality user experience.

3. The recipient phone number is not a WhatsApp phone number.


131053: Media Upload Error- 

The error occurs when the media is not uploaded in the supported file formats or the media sizes. 

Kindly refer to the document for the supported file formats and the sizes:

https://docs.google.com/document/d/1DAFUUklg3E-qFjbBBrHfZZrALbu0ot6NflcYyKJtCn0/edit


33: Parameter value is not valid- 
In invalid parameter value, verify that the business phone number is correct. 





WhatsApp Solutions

November 10, 2024

Whatsapp All feature...

Invalid Date

Step 1: Go to the WhatsApp Manager, and select the phone number from the left-hand side panel.  Click on Payment Configuration and then select 'India'.




Step 2: In Payment Configuration click on the 'New Configuration' button from the upper right-hand side corner.


Step 3: After clicking on the New Configuration button, a pop-up will appear, click on 'Get Started'.



Step 4: Please select 'UPI VPA ID', as the other options are currently unavailable.


Step 5: Enter the details appearing in the payment configuration pop-up window. 



Step 6: Go to MSG91 WhatsApp Panel, and click on the Number from the left-hand side panel. Click on the edit icon from the action column.

Screenshot 2025-01-31 at 4.21.42 PM.png

Step 7: Click on the edit icon from the action column. A pop-up will appear. Choose the payment method from the list then Enter the details of the Payment Configuration and then click on the 'Save' button. 

Screenshot 2025-01-31 at 5.00.20 PM.png

Screenshot 2025-01-31 at 5.00.34 PM.png


Step 8: Click on the 'Send WhatsApp' option from the left-hand side panel. From there, businesses can send the catalog to their users and users can select the products. 


NOTE: If sent without a country code, submission and deduction depend on the detected country based on the starting number: For, 91xxxxxxxxxx, etc


Step 9: A sample message is provided below to show how the catalog messages will be displayed to users.


Step 10: Users will select products from the catalog, and upon proceeding, the business will send interactive automated messages for payment. 



Step 11: When the customer proceeds with the 'Continue Button' he will see the payment option to pay with the WhatsApp UPI.


Step 12: The customer will receive a confirmation of the payment as soon as he completes the payment. 


WhatsApp Payment Flo...

Invalid Date


WhatsApp media type Support 


Document Name

Supported Extension

Size (Max.)

IMAGE

image/jpeg, image/png

5 MB

AUDIO 

 audio/aac, audio/mp4, audio/amr, audio/mpeg,
audio/ogg; codecs=opus

16 MB

DOCUMENT

Any valid MIME-type.

100 MB

VIDEO

video/mp4, video/3gpp

16 MB



         *Note: Audio is not supported in the header section.*


Whatsapp media limit...

Invalid Date

Q. What all nature of messages can be shared via WhatsApp with the end-user?



Q. What type of file attachment is possible in the header part of the message and any size limitation?


Q. How many messages I can send in 24 Hours i.e., what are WhatsApp Messaging Limits?

Ans: 
WhatsApp follows a unique self-up-gradation approach, if a user has bypassed their messaging limit in a defined time period, they upgrade the user to the above tier.

  • Tier 1: Allows your business to send messages to 1K unique customers in a rolling 24-hour period.

  • Tier 2: Allows your business to send messages to 10K unique customers in a rolling 24-hour period.

  • Tier 3: Allows your business to send messages to 100K unique customers in a rolling 24-hour period.

Learn More


Q. How to get a green label on your WhatsApp account?

Ans:

Your account must represent a well-known, often searched brand or entity. we review account that are featured in multiple news sources, and we don’t consider paid or promotional content as sources for review. Our criteria for WhatsApp official business account are based on a number of factors and are different from policies on other platforms.
Please note that you will be able to submit another request for review only after 30 days. In the meantime, this decision doesn't limit your ability to share your business details. For example, each phone number also has a business profile which includes a profile picture, email, website, and business description. These are fields that you can edit at any time.
Learn More


Q. Can I use the WhatsApp Business number on mobile after WhatsApp service activation? 

Ans:
Once you migrate your number to the API, you will no longer be able to use the WhatsApp Business App with that number.


Q. Can I check the number before sending the WhatsApp messages that the number is available on WhatsApp or not?

Ans: 
It is not possible to check WhatsApp availability before sending WhatsApp messages.

WhatsApp- FAQ

Invalid Date

Facebook Business Verification is different from Facebook Page Verification and it comes with its own benefits. When you verify Facebook business manager account, you get access to different tools and products.

Apart from that, a verified Facebook business manager account earns trust amongst the users. Over 2 billion people are on WhatsApp. Leveraging it for your business growth by connecting with your customer is an important step for business communication. 

Why you should verify Facebook Business Manager account?

Many Facebook advertising accounts are terminated for a variety of reasons. The Facebook Business Manager’s Business Verification feature is one potential aid.

The closure of Facebook ad accounts could be caused by a variety of circumstances. Facebook sites have also been banned despite doing nothing wrong and having their accounts falsely flagged. 

Facebook has frequently requested that business manager accounts in these situations get their business accounts verified. Business verification does not imply that all issues are resolved. Facebook’s preference for verified business manager accounts over unverified business manager accounts only helps.

Please check the below image to understand the difference.



(L) Facebook business verification (R) Facebook page verification

Now, let’s talk about how you can complete Facebook Business Verification.

Steps to Verify Facebook business manager account







How Long does it take to verify a Facebook Business Manager account?

After applying for verification, it might take 1-5 business days to get a reply back from Facebook. After that, if everything goes with the Facebook policies, your business manager will get approved.

What documents should I share to verify my Facebook business manager account?

In some cases, no documents are required for Facebook Business Verification because Facebook may be able to match your business against publicly available records. In that case,  select from the list of publicly available records that Facebook shares with you.



Facebook Business Verification matches your details against public records. However, if Facebook couldn’t find any details, you must submit the following documents.

Documents to submit to verify Facebook Business Manager Account

1. Legal Name Document – One of the below documents

– Business Registration (BR)

– Company Incorporation Certificate

– Tax/VAT Certificate

2. Address Proof Document – One of the below documents

– Bank Account Statement

– Utility Bill (Phone/Electricity Bill)

A one-time password (OTP) will be issued to you through text, email, or phone call as soon as you have submitted the required documentation to Facebook Business Manager for verification. 

You can check the current status of your verification by going to Facebook Business Manager>Business Settings> Security Center. The table below shows what documents you can submit to verify Facebook business verification processing for your country of residence.


Required Documentation

Apart from sharing the above documents, you must verify your business domain. For domain verification, Facebook will send a code to your registered business email address, and you must enter it.

What are common reasons for the rejection of Business Verification?

  • The legal Name Document & Address Proof Document have different addresses – Please ensure all documents have the same address.

  • Business Legal Name not found in the website URL submitted – Ensure your company’s legal name is on the footer of your website. 


  • Business Email Address not used during verification: Use your registered business email address for Facebook Business Verification.

If I verify my Facebook Business Manager account, will it help get Blue Tick Verification on my Facebook Page or Green Tick Verification on WhatsApp?

Facebook Business Verification is different from Facebook Page Blue Tick Verification and WhatsApp Account Green Tick Verification.

While Business Verification on Facebook is granted to all valid businesses, the public verification ticks (blue tick and green tick) are only approved for highly reputed businesses. There are no fixed criteria/eligibility for the same.


For more information, visit the official document from WhatsApp: https://www.facebook.com/business/help/1095661473946872?id=180505742745347






How To Get your busi...

Invalid Date


In this doc, we have shared the basic steps that you need to follow in order to integrate WhatsApp Services. To begin with, you can follow these simple steps:







Please refer to this: https://msg91.com/help/MSG91/how-to-create-a-template-for-whatsapp


For template-related FAQs, check: https://msg91.com/help/whatsapp-faq

For creating the template on META please refer to this video guide: https://www.loom.com/share/94118f7bc89a4279b1b7eeeb8fcef3bc

For Whatsapp Logs and Reports, refer to this article.

You can use them to send Whatsapp messages in the following ways.


  • Campaign (Multi-channel where you can add other services like SMS, Email, and Voice also)- HelpDoc [Recommended]


  • Whatsapp API (If you have a specific use-case where you want to use the dedicated Whatsapp API only and not use any other channels)- The Base URL of the API will look like this:


POST: https://api.msg91.com/api/v5/whatsapp/whatsapp-outbound-message/

JSON/Payload for a corresponding approved template is already available in the template section of the MSG91 dashboard. Refer to the below screenshot for reference:


Templates inside WhatsApp

You can copy the JSON & use it as a payload in your API with the base URL. All you need to do is insert the parameter's value like the Receiver's number, variables, and auth key.



WhatsApp Code


How to begin with Wh...

November 19, 2024


Create a QR code to allow your audience to initiate a chat with you using WhatsApp without saving your WhatsApp number in the contact list -


  1. Login to https://business.facebook.com/ with your admin ID.

  2. Select your Business.

  3. Click WhatsApp Manager.

  4. Click the account that you want to manage the QR code for.

  5. In the left side menu, click Phone Numbers.

  6. Navigate to the phone number that you want to use for the code.

  7. Under Settings, click on the settings icon.

  8. Click Message links.

  9. In the Message field, input the text for a pre-filled message that will populate for customers to edit and send to you after they scan the QR code. If you don't add text, your QR code will pop up as an open-ended conversation when scanned.

  10. Click Save.

Create WhatsApp QR C...

November 27, 2024

You can send WhatsApp directly from your Google spreadsheet by using this add-on without switching back and forth to the panel. This add-on is introduced to save you time and help you to send WhatsApp SMS efficiently to all your contacts directly from the sheet.

Follow the below-mentioned steps to send WhatsApp directly by using the sheet:

Install the SMS Sheet add-on from MSG91 in Google Spreadsheet.






For Sending WhatsApp:






Depending on your template body, the variable, header, etc will be visible, and map them accordingly. 




NOTE: If sent without a country code, submission and deduction depend on the detected country based on the starting number: For, 91xxxxxxxxxx, etc

How to send WhatsApp...

Invalid Date

Once your registration gets completed on meta and integration steps will be completed with MSG91. Subscribe to the WhatsApp plan to start using WhatsApp services. 










Free Session:


1. User-initiated conversations: If the business responds to a message initiated by the user with text/media/location; those messages will be free for the next 24 hours from the business replied (but user-initiated charges will be applied for the first message)


2. Business conversations: If the business sends a template of some category; then the message will not be charged for 24 hours for that category template if sent back again of the same type.


3. Free conversations: If the user responds to a message with an action button; i.e. visit a link or call a number; or the user clicks on a Facebook AD; then the business is allowed to send any kind of message from that particular time till 72 hours and no message will be charged during this time.


Paid Conversations:


1. User conversations: If the user initiates a chat, then user-initiated prices will be applied to those messages replied with a text/media/locations by a business. But, if the business replies with a template; the template category charges will be applied to that particular conversation.


2. Business conversations: If the business sends different category templates, those templates will be charged according to their category for the first message.


Note: This pricing change will be applicable from the 1st of JAN. 


If you still face any issues do not hesitate to drop us a mail at [email protected], we are always here to help you.






WhatsApp pricing and...

November 27, 2024

1. Select the Whatsapp channel from the MSG91 dashboard.



2. Go to the Logs section from the sidebar. You can filter the logs by date, integrated number, customer number, inbound/outbound, and delivery status from the Filter option at the top. Click on the Export option to download the report and select your timezone.

The report would be sent to the registered email of the account. Please check the Spam folder if not found in the Inbox.




How to download What...

November 10, 2024

You can check the reason for the failed messages on the failed logs section of the Whatsapp section. Click on the Whatsapp icon.


MSG91 Dashboard


Step 1: Click on the Failed logs to directly check the logs for which the Whatsapp message failed. 

Also, the alerts on the dashboard include the number of failed logs in the case of WhatsApp and will redirect to the failed logs section.


MSG91 WhatsApp Tool


Step 2: If you want to see the content of the message in the case of failed logs, please click on the log and you can see its content as well.


Failed Logs View


Details for the failed logs

Happy WhatsApping!!:)

Where to check the F...

November 10, 2024

1. Login to MSG91 and click on WhatsApp.



2. Go to the Webhook option and post the callback URL for the Inbound and/or Outbound messages. 

Please note that there is a timeout of 5 secs, if the updated webhook does not respond for 5 sec then the request will be lost and we will not post it , also we don't store logs for webhook delivery


Get Outgoing Messages via Webhook :- Webhook sample Response
{

"account_manager_email_id": "[email protected]",

"campaign_name": "sample_campaign_name",

"campaign_request_id": "80df970d89814681a196e193b8e1c7bd",

"company_id": 12345,

"content": {},

"customer_number": "91626XXXXX",

"submitted_at": "1716356585",

"read_at": "1713764585",

"delivered_at": "1711086185",

"direction": "outbound/inbound",

"email_id": "[email protected]",

"integrated_number": "91898XXXXXX",

"message_type": "text/template/image/video/location/template/contacts",

"message_uuid": "622d25f7914d4405801aa5b69cf31557",

"pluginsource": "sample_plugin_source",

"request_id": "876fc02b91894d61bc1f400583d42cc4",

"status": "Submitted/Sent/Delivered/Read/Failed",

"template_language": "en/en_US/hi",

"template_name": "sample_template_name",

"conversation_expiration_timestamp": "1716356585"

}

Screenshot 2025-02-18 223434.png

Try webhook.site to test this service.

Thank you!

How to get reports o...

Invalid Date

Here is a guide for Facebook Business Page verification:-


  • Log in to your Facebook Business account with the Admin ID

  • Go to the left bar of the dashboard and select your business page dropdown

  • Go to the Business Settings dropdown.

  • In the bottom left corner, you will see the option called ‘Business Info’

  • Click on the ‘Business Info’, here you will see the verification status as Verified. 










Note: In case your Facebook Business Page is Unverified, complete the Two-factor authentication and check the details below in order to get your Business page verified. 


  • Certificate of corporation or business license.

  • Business verification checks whether a business verification account belongs to the original business or organization.

  • Business is a legal entity

  • Authentic your business's mobile number & Email ID via the verification code


















How to check if your...

November 27, 2024


WhatsApp Green Tick Verification is different from WhatsApp API Verification. In this article, we’ll show you the Whatsapp business verification process and how to get verified on WhatsApp easily. For example, a business may be approved for using WhatsApp APIs but may not have a Green Tick. 


What is WhatsApp green tick?


WhatsApp Green Tick is a badge that appears on your WhatsApp API number profile. You will receive it once your Business profile has been successfully verified by WhatsApp, indicating that you are an Official Business Account.


Benefits of a verified badge?


A green tick badge indicates that your brand is genuine, one-of-a-kind, and trustworthy.


1. Obtaining the Green tick badge can help reduce the number of times your customers block you.

2. It may also increase the read rate of your messages, resulting in a higher ROI on your messaging costs.

3. It can eventually become a part of your overall branding.

4. Customers can see your brand name even if they do not save your business contact information. More faith!


WhatsApp is exploring newer ways to connect with the businesses that matter to their customers. Once WhatsApp has verified that your phone number belongs to a business, the green tick badge ✅ appears next to your profile picture. The green tick badge confirms that WhatsApp verifies your phone number.


You can apply for Green Tick after being approved for WhatsApp Business APIs. Very few businesses meet WhatsApp’s official business account criteria. WhatsApp typically grants Green Tick or an Official Business account to minimal and highly reputed businesses.


Types of business accounts


There are two types of WhatsApp business accounts:


1. Official Business Account


WhatsApp has verified that an authentic, notable brand owns this account.

An official business account has a green checkmark badge and chat thread headers in its profile. 

The business’s name is visible even if the user hasn’t added the business to their address book.

Very few businesses will be official business accounts.


2. Business Account


Any account using the WhatsApp Business API or WhatsApp Business App is a business account.

WhatsApp verifies the authenticity of a brand for every account on the WhatsApp Business API.


Official business account


If your WhatsApp account is an official business account, the display name will be visible in the chat list, chat screens, chat groups, and contacts view instead of the phone number. In addition, there will be a green checkmark beside the displayed name in the contacts view.



Business account (with API access, but without Green Tick)


If your WhatsApp account is a business account, it will only show the display name in the contacts view in the smaller text; all other views will show the phone number. You can help customers learn more about your company by filling out your business info, including your business website, address, and hours.



How to apply-

1. In your META Business Manager, go to Business Settings -> WhatsApp Accounts -> WhatsApp Manager.


2. Under Account tools, select ‘phone number’.


3. On the next page, you’ll find your WhatsApp account details. Click the ‘Settings’ icon to proceed.


4. Click ‘Profile’, fill in all the details, and click the ‘Submit Request’ button.


5. Once the request is submitted, you can see that your request is in review status.


You can reapply for green tick badge verification after 30 days if your application gets denied. However, META suggests that businesses take the time to establish their presence in news articles before reapplying.


Note: You can follow these recommendations which increase your chance to get the green badge:

  • Increase media coverage (3-4 organic articles about your brand)

  • Initiate more WhatsApp Conversations to reach tier 2 or above messaging level.

  • Add a WhatsApp link to your social handles to increase interaction.

  • Some ad spends from Facebook

  • The high number of followers on Facebook or Instagram shows brand credibility.


FAQs


Can I still use WhatsApp APIs without a green tick?


Yes. Not having a Green Tick on your account does not limit you from using WhatsApp Business APIs. You can continue to use WhatsApp Business APIs without a Green Tick. You will have access to all WhatsApp API features.


What are the eligibility criteria to get a green badge? ✅


You must be using WhatsApp API Approved Business Account

You must enable 2-Step Authentication

Facebook Business Manager account must be verified by Facebook

Must be a business (Individuals are not allowed as of now)

Recommended you are in Tier 2 or above messaging level

Must be a notable and reputed brand


How long does the green tick verification process take?


Green Tick application decision takes typically about 1-2 business days. However, in rare cases, it may take up to a week.


What should you do if your green badge application is rejected?


The only distinction is how your profile and contact information appear to customers. So yes, the green badge makes it seem more official, but everything else remains the same, and you can run campaigns and support customers just like any other brand with the badge.


You can also try again after 30 days if you want.


What’s the most critical factor in obtaining green tick verification?


Having 3-5 PR articles about your company increases the likelihood of your account getting the green tick.


Which businesses are not eligible for WhatsApp green tick verification?


WhatsApp disallows certain business categories for WhatsApp API and hence for WhatsApp Green Tick Verification. Businesses dealing in the following products/services cannot be approved for using WhatsApp Business APIs:


Drugs

Tobacco Items

Gambling Businesses

Alcohol Brands

Weapons & Ammunition Businesses

Live Animals

Adult Product/Services

Medical & Healthcare Products

Dating Services

Cryptocurrencies

How to apply for Wha...

November 10, 2024

1. Create a Facebook Business Account for your business. 

Go to http://business.facebook.com/ and click on the Create button.


2. Get the Facebook Business Account verified. HelpDoc

If you already have a Facebook Business Account and want to check if it's verified or not, refer to the steps in this article.


3. Create an app and Add the number to be used for Whatsapp

Add a number that is not in use in Whatsapp and perform the required configuration as suggested in this HelpDoc.


3. Add the number on MSG91

Once the number shows active, add it on MSG91 by the steps suggested in this HelpDoc.


4. Create templates

Create templates for the messages that you wish to send either via MSG91 or directly in Meta

Once the templates are approved on Meta, they will be synced in your MSG91 dashboard and you can use them to send messages. HelpDoc


  • Utility conversations - Facilitate a specific, agreed-upon request or transaction or update to a customer about an ongoing transaction, including post-purchase notifications and recurring billing statements

  • Authentication conversations - Enable businesses to authenticate users with one-time passcodes, potentially at multiple steps in the login process (e.g., account verification, account recovery, integrity challenges)

  • Marketing conversations - Include promotions or offers, informational updates, or invitations for customers to respond/take action. Any conversation that does not qualify as utility or authentication is a marketing conversation.


Pricing- HelpDoc

If you find the integration process difficult, you can opt for MSG91 assistance where we will help you with the overall integration. The one-time fee to set up your WhatsApp Business account is ₹3000 +GST.


For more help, you can refer to the FAQs.


  • User-Initiated Conversation: A conversation that initiates in response to a user message. Whenever a business replies to a user within the 24-hour customer service window, that message will be associated with a user-initiated conversation. Businesses can send free-form messages within this 24-hour customer service window.

  • Business-Initiated Conversation: A conversation that initiates by a business sending a user a message outside the 24-hour customer service window. Messages that initiate a business-initiated conversation will require a message template.

  • Service conversations – all user-initiated conversations will be categorized as service conversations, which help customers resolve inquiries.

  • One session will comprise 24 hrs. Unlimited messages can be exchanged during a 24-hour conversation without an extra fee.



Step-by-step process...

November 27, 2024

Step 1: On the MSG91 Dashboard click on WhatsApp.


Step 2: Navigate to the side panel and click on the numbers. Select the number that displays the catalog icon, then click on the catalog icon.



Step 3: Enter the Business ID details in the pop-up that will be showcased. Click on Proceed once the details are entered. The Business ID can be obtained from the URL Section of your business account. 

Step 4: After clicking "Proceed," you will be redirected to Facebook login, where a list of business accounts will be showcased. Select the account from which you want to connect MSG91. Click on continue once the account is selected. 



Step 5: Select the catalog from the list you want MSG91 to access. Click on continue once the catalog is selected.

 


Step 6: Click on Save to review what MSG91 is requesting permission to do. 

 



Step 7: A message will be displayed regarding the account that has been connected to MSG91. 

Click on Got it once it’s displayed.


WhatsApp Catalog

November 10, 2024

WebEngage WhatsApp Integration Using WSP Private Connector

This help document guides you through integrating WebEngage with WhatsApp using the WSP Private Connector. Follow these steps to set up the integration and configure the webhook for fetching delivery events.

Integrating the API

  1. 1. Login to WebEngage: Go to the WebEngage website and log in with your credentials.

  1. 2. Navigate to Integrations: In the WebEngage dashboard, navigate to Data Platforms > Integrations.


    3. Configure WhatsApp: Click on Configure WhatsApp.


    4. Add Private WSP: Click on Add “Private WSP”


    5. Fill in the Configuration Details: 
    Configuration Name: Enter MSG91.
    WhatsApp Business Number: Enter your WhatsApp Business number, including the country code, in the format 91XXXXXXXXXX.URL: Enter the URL https://api.msg91.com/api/v5/whatsapp/outbound/web-engage/



    6. Set Request Type: Choose Send personalization variables.

    7. Add Custom Headers: 
    Authkey: Enter your MSG91 authkey.
    Accept: Set to “application/json”.
    Content-type: Set to “application/json”.


    Configuring the Webhook for Fetching Delivery Events

    View Webhook URL in WebEngage:

    In the WebEngage dashboard, navigate to Data Platforms > Integrations > Configure WhatsApp.
    Click on the three dots next to your configured WhatsApp integration and select View Webhook URL.
    Copy the displayed URL.

    Add Webhook URL in MSG91:

    Login to your MSG91 account.
    Navigate to Whatsapp > Webhooks > Outbound Messages.
    Add the copied WebEngage webhook URL in the specified field.



    Get “WebEngage DSN Key” and share the same with our support team at [email protected] to enable the webhooks.


  2. Summary

    By following these steps, you will successfully integrate WebEngage with WhatsApp using MSG91's WSP Private Connector. This setup allows you to send personalized messages and track delivery events efficiently. Ensure that all configurations are accurately filled in to avoid any issues with the integration.

  3. Fill in the Configuration Details: 
    Configuration Name: Enter MSG91.
    WhatsApp Business Number: Enter your WhatsApp Business number, including the country code, in the format 91XXXXXXXXXX.URL: Enter the URL https://api.msg91.com/api/v5/whatsapp/outbound/web-engage/


  4. Set Request Type: Choose Send personalization variables.

  5.  Add Custom Headers: 
    Authkey: Enter your MSG91 authkey.
    Accept: Set to “application/json”.
    Content-type: Set to “application/json”.


    Configuring the Webhook for Fetching Delivery Events

    View Webhook URL in WebEngage:

    In the WebEngage dashboard, navigate to Data Platforms > Integrations > Configure WhatsApp.
    Click on the three dots next to your configured WhatsApp integration and select View Webhook URL.
    Copy the displayed URL.

    Add Webhook URL in MSG91:

    Login to your MSG91 account.
    Navigate to Whatsapp > Webhooks > Outbound Messages.
    Add the copied WebEngage webhook URL in the specified field.

Get “WebEngage DSN Key” and share the same with our support team at [email protected] to enable the webhooks.


Summary

By following these steps, you will successfully integrate WebEngage with WhatsApp using MSG91's WSP Private Connector. This setup allows you to send personalized messages and track delivery events efficiently. Ensure that all configurations are accurately filled in to avoid any issues with the integration.

WebEngage WhatsApp I...

November 10, 2024

Step 1: On the dashboard click on WhatsApp

Step 2: Click on the Send WhatsApp Option from the side panel. 



Step 3: A dialogue box will be opened. In the To Section enter all the mobile numbers to which you want to send the template. Numbers can be separated from commas, and 1000 numbers can be inserted. After that select the phone number you want to send the template.

Note: If sent without a country code, submission, and deduction depend on the detected country based on the starting number: For, 91xxxxxxxxxx, etc





Step 4: Select the template you want to send to the users. 
In Variable Mapping, enter the variable name as per the template. Mention the Catalog ID and Product according to the template you are sending. 



Step 5: Click on review and send after entering all the details.


Send WhatsApp

Invalid Date

You can also refer to this video guide link: 




Step 1: In Order to create the templates, you can apply for the templates from the create new template option directly there is no need to visit your Facebook business page.  



Step 2: A popup will appear like this on the screen.


In the Name section, you can give the name to your template.


In the Category section, you can select the category of your template as Transactional, Marketing, or OTP.


In the Language section, you can select your preferred language.




Step 3: After filling in the details now add the template details.




A WhatsApp message comprises different parts like a header, body, footer, and button, adding them to your message is optional, A body can have a maximum of 1024 characters, a footer can have a maximum of 60 characters, and each button can have a maximum of 20 characters.

Header: The header can be of the media type and can send over files like videos, images, and documents.

File Type of Document: PDF, DOC(X), PPT(X), and XLS(X) [Document file sizes can be up to 100MB.]

File Type of Image: JPG, JPEG, and PNG [Image sizes can be up to 5MB.]

File Type of Video: MP4 and 3GPP [Video sizes can be up to 16MB.]

Body:  You can add your message content.

Footer: You Add a short line of text to the bottom of your message template.

Button: Create buttons that let customers respond to your message or take action such as a call to action, Quick reply, or Marketing opt-out

Step 4: You can see the Preview of the template on the right side and once you are satisfied with the template you can submit it for approval just click on the Create button. 

  • Utility conversations - Facilitate a specific, agreed-upon request or transaction or update to a customer about an ongoing transaction, including post-purchase notifications and recurring billing statements

  • Authentication conversations - Enable businesses to authenticate users with one-time passcodes, potentially at multiple steps in the login process (e.g., account verification, account recovery, integrity challenges)

  • Marketing conversations - Include promotions or offers, informational updates, or invitations for customers to respond/take action. Any conversation that does not qualify as utility or authentication is a marketing conversation.

How to create a temp...

November 19, 2024

If there is an issue in the WhatsApp message you sent, error codes are displayed to indicate the problem. You can find a list of all the error codes along with their meanings/descriptions here which help you to correct them.

You can check the errors of the failed WhatsApp messages in the logs and failed logs section of the Whatsapp section.


Error codes by Meta 

​If your WhatsApp vendor is Meta, please check its error codes here -

https://developers.facebook.com/docs/whatsapp/on-premises/errors


Error codes by 360 Vendor

If your WhatsApp vendor is 360, please check its error codes here -

https://docs.360dialog.com/whatsapp-api/api-error-message-list


Check your Error Codes

https://developers.facebook.com/docs/whatsapp/cloud-api/support/error-codes/


Error codes generated by MSG91 side -

1. 400 - Invalid Request Error

  • Invalid JSON in request

  • Integrated number not found in request

  • Content type not found in request

  • There is no subscription assigned to this number

  • Payload not found in request

  • The recipient number is not found in the request

  • Text not found in request

  • The attachment URL is not found in the request

  • File format not supported

  • Invalid content type in the request

  • Key is missing

2. 404 - Not Found Error

  • Whatsapp not integrated

3. 500 - Internal Server Error


Error Codes for What...

December 3, 2024

MSG91 Introducing, the latest innovation in WhatsApp's interactive messaging feature! 

WhatsApp offered several interactive messaging features designed to enhance business communication and customer interactions. In this article, we’ll show you how you can engage with your customers in a more personalized and efficient manner.

The best thing is that you don't require the WhatsApp template for this feature.

If your account is registered with Meta/FB Cloud, then only these messages will function. You can send these messages during a 24-hour session window.

Here are some of the interactive messaging features available in WhatsApp for Business: 

  • Buttons: Businesses can use buttons in their messages to provide a more interactive experience for users. These buttons allow users to choose from a predefined set of options, making it easier for them to respond to or interact with the business. For example, a business might send a message with buttons for "Yes" and "No" options, allowing the user to respond with a single tap.

    Here is the API documentation for this.


  • Quick Replies: Quick Replies enable businesses to create pre-set responses to commonly asked questions or queries. When a customer sends a message with a specific keyword or question, businesses can use quick replies to provide instant and relevant responses without typing the same message repeatedly.



  • List View Message: The List View Catalog feature simplifies the shopping experience for customers and facilitates seamless communication between businesses and their potential buyers on the WhatsApp platform. If any business wants to showcase its product offerings without the need for a separate website or online store.   - API Documentation



  • Single Product catalog: Businesses could create a catalog containing multiple products, each with its own image, name, description, and price. Customers could then view the entire catalog and add the product to the cart without browsing the website.  - API Documentation




WhatsApp Interactive...

November 10, 2024

Step 1: First understand how to create the template by visiting the link mentioned below.  

https://msg91.com/help/how-to-create-a-template-for-whatsapp


Step 2: Click on the add button and select the visit website button after filling up all the required details like template name, category, and template language.


Step 3: Name the button as per your requirement. 

Step 4: Enter the website URL in the URL Column. 

Step 5:  Add variables in the URL as click count will only be counted on the dynamic website URL. 


Step 6: Click on add sample and enter the full website URL. 


Step 7: Go to the logs section and there in the clicked column the counts will be showcased for the times the users have clicked on the website. 


Step 8: Go to Reports for a more detailed description of the clicks. 

Click Count Function...

January 9, 2025

What is prepaid limit:
Prepaid balance is the balance reserved for WhatsApp usage only. This can be recharged from wallet to a particular subscription and is non refundable to wallet. This balance gets carry on to the next month, if not used. This balance will be used for your whatsApp usage before any consumption.

Once you subscribe to WhatsApp services you will be able to see the option of adding the prepaid balance there. Find below the screenshot where you can add the prepaid balance by clicking on sign +. 


Once you click on + sign popup like this will appear and you will be able to add the amount you dedicatedly want to use for WhatsApp services, which will be non refundable to wallet.

How does auto renewal works:
To avoid any failure issues due to low prepaid balance, you can setup Auto-Recharge setting for that subscription. We will automatically then recharge your prepaid balance with the specified amount remaining prepaid balance goes below the threshold amount specified in the auto recharge setting.

Click on the pen icon besides the auto recharge option to turn the auto renewal on and to also add threshold limit.

What is threshold limit

The threshold amount is the minimum balance required in a prepaid account. If the remaining balance drops below the limit, the account automatically recharges with a set amount to ensure its stays funded enough, This prevents any problem caused by running out of balance.

​From the options given below, you can add the threshold amount which will be the minimum amount and recharge of amount which you will add to "recharge amount "
and this is how you can add prepaid balance to the wallet.

WhatsApp Prepaid Bal...

January 9, 2025


1. Open MoEngage and click on settings.



2. Choose WhatsApp and select “add connector” and search for MSG91



3. Enter these details - 


    1. Sender Name - Any name you want to give to this sender

    2. WhatsApp business number - enter your integrated number with country code (do not add the + sign)

    3. API URL - https://control.msg91.com/api/v5/whatsapp/whatsapp-outbound-message/

    4. Authkey - enter your MSG91 authkey


4. Click on Save.

5. Copy the Webhook URL shown in Step 2



6. Open MSG91 Dashboard

7. Click on WhatsApp > Webhooks

8. Add the above mentioned URL in the “Outbound Message” webhook.



9. Now choose “Number” option in the left side panel. And click on this edit option.


10. Enable the MoEngage Toggle on the number which you are integrating with MoEngage.

Note: Quick Reply button click tracking is not functional at the moment but will be supported soon.

MoEngage WhatsApp In...

Invalid Date

WhatsApp Authentication Templates, commonly referred to as WhatsApp OTP (One-Time Password), present a highly economical solution for OTP delivery, being priced at one-third of the cost of other service and utility categories. These templates are specifically designed for authentication purposes, ensuring secure and reliable delivery of one-time passwords. With built-in support for both Android and iOS, they feature autofill capabilities, significantly enhancing the user experience by streamlining the authentication process. Additionally, WhatsApp OTP boasts a higher delivery rate compared to other categories, making it a preferred choice for businesses seeking efficient OTP solutions.

For detailed pricing information, you can visit the MSG91 pricing page here. This page provides a comprehensive overview of the costs associated with WhatsApp Authentication Templates, allowing you to make an informed decision based on your specific needs and budget.

The MSG91 platform facilitates seamless integration with the WhatsApp API, enabling direct access to these authentication templates. Additionally, MSG91 offers a user-friendly UI/OTP widget that enhances functionality and user experience. The OTP Widget is packed with features designed to boost security and flexibility, including:

  • IP Limitation: This feature allows you to restrict OTP delivery to specific IP addresses, enhancing the security of your OTP system by preventing unauthorized access and potential attacks.

  • Country-Specific Targeting: With this feature, you can tailor your OTP delivery channels according to the recipient's country. Whether you prefer SMS, voice messages, or WhatsApp, you can easily configure the delivery method based on the geographical location of your users.

  • Bot Protection: The OTP Widget comes equipped with built-in bot protection mechanisms, safeguarding your system against automated bot attacks. This ensures that your OTP delivery remains secure and reliable, protecting both your users and your system from potential threats.

By leveraging these advanced features, you can significantly enhance the security and efficiency of your OTP delivery process through WhatsApp. The seamless integration with the WhatsApp API and the robust capabilities of the MSG91 OTP Widget ensure that your authentication process is not only secure but also user-friendly and reliable.

For more information on how to implement WhatsApp OTP and explore the various features offered by MSG91, you can visit the following links:

These resources provide valuable insights and detailed guidelines to help you set up and optimize your WhatsApp authentication system, ensuring a smooth and secure user experience. Whether you are a small business or a large enterprise, MSG91’s WhatsApp Authentication Templates offer a scalable and effective solution for all your OTP needs.

WhatsApp Authenticat...

November 27, 2024

Login to Your MSG91 Panel - Go to the WhatsApp channel from the dashboard.



Navigate to Opt-Out Rules - After opening the WhatsApp channel, click on "Opt-Out Rules" from the left-side menu.
Select the number for which you want to set the opt-out rule.




Create a New Rule - Click on "Create New Rule" located at the top-right corner. A pop-up will open where you can add keywords such as STOP, UNSUBSCRIBE, etc.

-These keywords can be set for Marketing, Utility, and Authentication messages.


Screenshot (19).png



Select Specific Templates - You can also choose a particular template to which you want to apply the opt-out rule

Screenshot (20).png

Blacklist Numbers: The numbers that opt out will be shown in the blacklist section of WhatsApp.

Screenshot (21).png

Edit : Click on the three dots beside each number, you can edit the template category- so they can also be blocked or unblocked from certain category.

You can also block that particular number for other channels as well, like RCS …

Screenshot (24).png

Unblock Number: Click on the three dots beside each number, you can unblock the number.

Screenshot (25).png

How to Set Opt-Out R...

December 26, 2024

Introduction

WhatsApp is a powerful tool for businesses to connect with their customers. However, some users encounter a common and frustrating error when sending marketing template messages via live chat or bulk broadcasting:

"This message was not delivered to maintain a healthy ecosystem engagement."

If you've faced this issue, it's likely due to WhatsApp's Per-User Marketing Template Message Limits. This system is designed to enhance user experience by limiting the number of marketing messages a person can receive within a specific time frame.

This blog will help you understand the error, its causes, and strategies to avoid it effectively.

Why the Error Occurs

WhatsApp enforces these restrictions to prevent users from being overwhelmed by excessive or irrelevant messages, thereby maintaining a positive user experience. When this error occurs, it typically means:

  • The recipient has already reached the maximum allowable limit for marketing messages within a specific time frame.

  • WhatsApp has opted not to deliver your message to protect user engagement and sustain a healthy messaging ecosystem.

This error is often accompanied by specific error codes, which vary depending on the API you are using:

  • 131049: For businesses utilizing the Cloud API.

  • 1026: For businesses using the On-Premises API.

Understanding these codes and their implications can help you address the issue more effectively.

The Purpose of WhatsApp's Per-User Marketing Limits

WhatsApp implements these limits to achieve the following goals:

  • Improve User Engagement: By reducing message fatigue, users are more likely to read and engage with messages.

  • Enhance User Experience: Limiting excessive messaging helps maintain a positive sentiment toward business communications.

  • Ensure Relevance: Businesses are encouraged to send messages that are timely, valuable, and relevant to their audience.

WhatsApp's data indicates that fewer, well-timed messages result in higher user satisfaction and better engagement rates. These limits help create a balanced ecosystem that benefits both users and businesses.

Tips to Prevent This Error

If you’re facing this issue, here are some strategies to optimize your approach:

1. Space Out Marketing Messages

  • Avoid sending multiple marketing messages to the same user within a short timeframe.

  • Allow users time to engage with the first message before sending another.

2. Encourage User Engagement

  • Motivate users to respond to your messages, as a response opens the opportunity to send additional marketing messages within the same conversation window.

  • Use interactive elements like quick replies or buttons to prompt user interaction.

3. Make Use of Active Conversations

  • Leverage existing open marketing conversations with users by nurturing them.

  • Send follow-ups or additional messages within the same conversation window to maximize impact.

4. Segment and Prioritize Your Audience

  • Focus on users who have shown previous engagement with your messages.

  • Tailor your messages to align with user preferences, making them more relevant and increasing the likelihood of engagement.

By following these practices, you can minimize errors and improve the effectiveness of your messaging strategy.

How to Handle This Error

If you encounter this error, follow these steps to resolve it:

1. Check the Error Code

  • Review the API or webhook response to identify the specific error code.

  • The codes 131049 (for Cloud API) and 1026 (for On-Premises API) indicate that the per-user limit has been reached.

2. Evaluate Your Messaging Approach

  • Analyze the frequency and content of your messages to ensure they are not overwhelming.

  • Target the right audience and deliver messages that are relevant, valuable, and engaging to improve user experience.

By taking these actions, you can minimize the occurrence of this error and maintain a better communication flow with your users.

Best Practices for Optimizing Your Messaging Strategy

1. Leverage Personalization

  • Personalize your messages by addressing users by their name or referencing past interactions. This creates a more meaningful and engaging experience for your audience.

2. Deliver Value-Driven Content

  • Ensure your messages offer real value to users, such as exclusive promotions, useful tips, or updates that align with their interests. This enhances the relevance of your communication.

3. Respect User Preferences

  • Allow users the option to opt out of marketing messages if they no longer wish to receive them. This shows respect for their preferences, builds trust, and helps prevent delivery failures.

By incorporating these best practices, you can improve user engagement, reduce errors, and ensure a more effective messaging strategy.

Set Up OPT-OUT WhatsApp Massages - https://msg91.com/help/whatsapp/How-to-Set-Opt-Out-Rules-in-WhatsApp-Channel

Conclusion

WhatsApp's Per-User Marketing Template Message Limits are not obstacles, but rather tools designed to help businesses improve communication quality. By understanding the underlying reasons for this error and applying the best practices outlined above, you can achieve better engagement, reduce delivery issues, and foster stronger relationships with your customers.

If you need support in optimizing your WhatsApp campaigns or resolving such errors, don't hesitate to reach out to us. Together, we can ensure the success of your WhatsApp marketing strategy.

WhatsApp Error - Hea...

January 8, 2025

We allow the use of the Whatsapp Business Service for messaging about the Regulated Verticals, in limited countries, and pursuant to applicable law.

Additional Requirements for messaging about Regulated Verticals -

  • You must ensure - through technical and organizational measures - that messages are gated per legal age, geographic requirements, and regulatory requirements.

  • You must comply with all applicable laws, including but not limited to local laws and industry codes.

  • You must not use the WhatsApp Business Platform to send messages about Regulated Verticals outside of the allowed countries.

  • You must ensure that you have all required licenses, notices, permits and registrations.

  • You must immediately stop sending messages to users in the allowed country if your required license expires, is modified, or is terminated.

  • WhatsApp Business messaging that promotes alcohol must comply with all applicable local laws, required or established industry codes, guidelines, licenses, and must comply with age and country requirements consistent with applicable local laws.

  • Messaging about any Regulated Vertical using the WhatsApp Business Platform may not be sent to people under 18 years of age.

  • Within Real Money Gambling and Gaming, if your country/region prohibits certain activities such as gambling, games of chance, and/or any other related activities (i.e. India), then your use of business messaging should not include such prohibited activities and should only include those activities which are lawful.

Exceptions to Regulated Verticals – Allowed Countries

WhatsApp Business messaging that promotes for online gambling and gaming, Over-the-Counter Drugs, alcohal must follow all local laws, industry codes, guidelines, and licensing requirements. Messages cannot be sent to anyone under 18 years old and must meet the age and country-specific rules of the applicable laws.

To view the complete list of regulated verticals and allowed countries, please refer to the document.

Note - If your country is listed under your preferred category, you must follow the guidelines and fill the application form for verification first, after the verification by facebook only, you will be able to send whatsapp under preferred category.



Additional Requirements for Messages Promoting Online Gambling and Gaming using the WhatsApp Business Platform

To message users to promote online gambling and gaming (a subset of real money gambling and gaming), organizations will need to:

Request permission from Meta Platforms, Inc. using this application form. Note that businesses can only apply to message people in certain countries.

Provide evidence that the online gambling and gaming activities are appropriately licensed by a regulator, or otherwise established as lawful in the countries listed that the business wants to send messages to.

We define online gambling and gaming as any product or service where anything of monetary value is included as part of entry or prize. Monetary value includes, but is not limited to, cash or digital currencies like Bitcoin.

Online gambling and gaming activities include:

  • All forms of online gambling. Some common types of gambling include betting, lotteries, raffles, casino games, fantasy sports, bingo, poker, skill game tournaments, and sweepstakes.

  • Games where anything of monetary value is part of entry, and games where anything of monetary value is part of the prize. This includes games that require purchases to continue gameplay or to provide an advantage in winning prizes (in cases where the prize is of monetary value).

  • Promotions for online gambling or games, even if there is no opportunity to gamble or game directly within the WhatsApp chat.

  • Physical, real money gambling activity, or establishments like “brick and mortar” casinos, entertainment events at casinos, or the streaming of offline poker tournaments.

  • State or government lotteries, as long as the business is directly or exclusively responsible for running the lottery.

  • Prize promotions that involve purchasing a product at the usual retail price, so long as online gambling isn’t the primary business model of the business or any featured brand.

  • Entirely free-to-play games.

Guidance on Regulate...

January 23, 2025