Before you start connecting your WhatsApp channel read the necessary information and requirements on the links:
After paying for the WhatsApp module, you will be able to start the process of connecting WhatsApp Business API on your own via the Settings ➔ Integrations.
If the «Connect» button is inactive, please contact your account manager.
We recommend that you set up your account in the «Incognito» mode in your browser. This will allow you to avoid common problems with cookies and inability to log in to your Meta account
To work with WhatsApp Business API, we use the services of the official provider - 360dialog. The first step of connection is authorisation in the service.
In the opened modal window you can create a personal account with the provider using your personal/work Meta account or email. In addition, if you have already created an account in dialog360, you can login to it using the «Login» button.
The next step is to verify and confirm that:
If the number you have selected is already linked to your personal WhatsApp app, you need to delete it on the device with a logged in WhatsApp account. Press More options ➔ Settings ➔ Account ➔ Delete account. Enter the number to delete in international format with the country code and tap Delete Account. Select the reason for deleting the account from the drop-down menu. Confirm the deletion. The number is usually unlinked within a few minutes.
If you already have a business account registered and confirmed, please specify this additionally. We recommend that you register your business account in advance, as verification times vary depending on your business, country and other factors. You can find all the information you need about registering a business account here. Read more about verifying your business account here.
Create or log into a Meta business account to which WABA will be linked. Agree to the requirements.
If you experience an error at the Meta account login stage, please clear cookies in your browser settings.
Next, read the information about what permissions you grant and what features will be available to you after the integration is complete.
In the next step of onboarding, fill in the information about:
The name displayed should be related to your company, match the Display Name Guidelines and not violate the WhatsApp Business Messaging Policy.
Next, you need to select an existing or create a new WhatsApp Business account.
Fill in the required information about your organisation. It will be available for your customers to view, but it can be edited at any time.
Enter the phone number that will be used for WhatsApp Business (the number from which you will send messages to your customers). Confirm ownership of the number by SMS or call.
If this is the first time you are connecting WhatsApp Business API to this number, make sure that this phone is removed from your WhatsApp Personal App or WhatsApp Bussiness App. If your number has already been connected to another provider, port the number first.
Once you have linked the number to WhatsApp Business API, the previous history of dialogues will no longer be available and you will no longer be able to manage them from WhatsApp. Also, you won't be able to switch the number to use the app in the future. You will only be able to communicate with customers from that number through WhatsApp Business API.
After successful confirmation, review the basic features and click «Ok».
The next step is to automatically set up your WABA. Almost immediately you will see a blue notification that your number will be prepared in a few minutes.
We recommend that you do not close this window, even though you will be notified by email. Wait until the setup is complete (takes no more than a couple of minutes) to avoid possible failures in the setup process and re-registration.
Once you have finished setting up WhatsApp Business, select the number you have bound in the provider window and save the changes. Do not close the window while saving.
If the number you added does not appear in the selection list, go to the WhatsApp Manager and check the status of the number. The «Pending» number will not appear for selection in the integration window.
It may take some time to connect the number (from several hours to a day). You can track the status in WhatsApp Manager. As soon as the number is confirmed, proceed with the integration connection.
Within a few seconds, the browser window will close and the status of your integration in the enKod window will change to «Connected».
The 360dialog team will check your account for compliance within two hours and you can start sending messages to WhatsApp.
You can monitor the status of your account in the personal page .
Our integration works through an official Meta partner, so we meet all the requirements of the official WABA.
In WABA, two types of messages are available for communication - template and service messages. Each type is limited by its own rules and has different costs.
In addition, it is worth knowing about such a concept as the «24-hour window rule», which is a rule of the WhatsApp platform. All dialogues are measured by fixed 24-hour sessions (windows). A session opens as soon as the first message is delivered.
If a dialogue is initiated by a user and its purpose is to solve customer issues, the correspondence is categorized as Service conversations.
Additionally, a support window is a rolling 24-hour time period that is updated when a message is received from a customer.
An active dialogue (support window, active session) exists for 24 hours in all standard situations. A business can send free-form messages within the support window. But any message sent to a customer more than 24 hours after their last message must be with an approved template.
If a business sends a template message to a user, starting a dialogue or in response to a user's message, a session is automatically opened that is considered a dialogue initiated by the business.
Read more about dialogue-based billing in the official Meta documentation.
Template is a pre-created and validated Meta message content, which consists of fixed text in a specific language and dynamic variables in that you can substitute with personalized information (name, order number, account number, etc.).
You can create a template message in enKod. All templates belong to one of the categories:
The content of your message must match the template category, otherwise it will not pass moderation.
If a message template reaches the lowest quality rating (status Active - Low quality in your WA Business manager), it is automatically paused. The duration of the pause is as follows:
The quality score of a template depends on its usage, feedback and customer engagement. You can read more in Meta documentation.
Starting April 1, 2024, Meta will take template readability into account as a key factor determining the quality of Marketing templates, in addition to the existing metrics: number of blocks and spam complaints. Meta will now temporarily suspend mailings with Marketing templates when readability is low, giving you time to edit the templates with the lowest level of engagement.
To track metrics and template quality, you can:
• go to WhatsApp Business Manager ➔ Account Tools ➔ Message Templates.
• monitor the email notifications Meta sends, linked to the business account, detailing any changes to the status of the template or WhatsApp Business account.
If you receive a status_change notification for a template, you can:
As of April 1, 2024, Meta has set a limit on the number of “Marketing dialogs” (Marketing) a user can receive from any company within a certain period of time. The limitation only affects Marketing templates that start a new dialog. If a “Marketing dialog” is already open, the restriction will not apply to sending Marketing templates in it. You can read more in documentation 360dialog.
The limit is determined by Meta and is based on the number of marketing template messages a user has already received from any company, and is not specifically related to your business.
If a marketing template message is not delivered to a user due to a limit, the API will return an error code Message Undeliverable (“Unable to deliver message”), which you can view in the statistics. Note that this error code covers a wide range of issues that can cause a message to be undeliverable, and for privacy reasons Meta does not directly specify the limit restriction as the cause of undeliverability.
If you suspect that a message is not being sent due to a limit, do not resend immediately, instead try increasing the time interval until the message is delivered, as the limit may be in effect for different periods of time.
Businesses are limited to sending a maximum of two marketing template messages within a 24-hour conversation window without a customer response. If a marketing template message is not delivered to a given user due to the limit, Cloud API will return error code 131049 “This message was not delivered to maintain a healthy ecosystem engagement.”
Whether a WhatsApp Business API account can send a message depends on:
You can read more about the rules and features of sending messages at 360dialog.
Please also note that the phone number registered in WhatsApp Business API cannot be changed. It is allowed to delete and add a new one.
To delete a number, go to your personal 360 dialog, “Details” tab. Scroll down to the “Cancel payment” button. In the modal window that pops up when you click on it, confirm deletion of the number by clicking on “Cancel subscription”.
Add a number can be:
The number will not be permanently deleted immediately. Usually, it happens on the last day of the month.
You can read more about adding and deleting numbers in your WABA account here.
Limits on sending messages regulated by Meta
Meta allocates 5 levels of sending limits per day:
Moving from the first tier (250) to the next (1000) requires going through the process of verification of a WhatsApp business account. However, as of October 31, 2023, such a transition is available to all 360dialog customers without verification as long as the rules are followed:
As soon as the volume and quality targets are reached, Meta will automatically change the message limit to a higher level.
Thereafter, the limits change automatically depending on the status of the phone number (whether it is connected), its quality rating and how often you start correspondences with unique customers.
Automatic level increase
With the start of each new correspondence with a unique client, Meta checks if your limit needs to be increased. This depends on the following criteria:
If all requirements are met, Meta will increase the restriction by one level after 24 hours.
Automatic downgrade.
If your number has a “Marked” rating in the last 7 days, Meta will immediately lower your restriction by one level.
You can read more about posting restrictions at here.
In enKod, you will not be able to send more messages than are available to you under your current limit. Such messages will be listed as “Not Sent” in the WhatsApp template details with the appropriate error text. Attempting to exceed your sending limit does not affect the quality of your account, and messages beyond the allowed number will simply not be sent.
You can find out your current limit in the Meta Business Manager or your personal 360dialog account.
Familiarise yourself with the rules of creating templates in the official Meta documentation.
Please note, you will not be able to submit templates with invalid structure for moderation. Frequent causes of errors when creating a template:
To create a message template go to Mailings ➔ Messages and select «Create WhatsApp template».
Templates come in two types:
Text templates contain a title, body text and caption with the ability to personalise the text with variables.
Media and interactive templates can contain an image/video/document and quick reply/call/link buttons.
The template wizard consists of one step where you need to fill in all mandatory fields.
When sending marketing templates, pay attention to the number of text lines. If there are more than 5, Meta will truncate the message under the “Read more” button.
For now, this feature applies to media and interactive templates that have an image, text, and action buttons at the same time.
General settings
Message text
Fixed message content with variables in the form of {{user_guide:integrations:1}} {{user_guide:integrations:2}} ... {{user_guide:integrations:5}}. The variables can be further populated with content or personalisation tags. You can unify your template to use it in different scenarios and conversations by personalising the text with variables. But you can't put most of your content in variables or create a template that consists only of variables. If you do, it will not pass moderation.
Footer
If you wish, fill in the footer that will be displayed below the text of the message.
General settings
Header
You can use as a header:
Body
Fixed message content with variables in the form of {{user_guide:integrations:1}} {{user_guide:integrations:2}} ... {{user_guide:integrations:5}}. The variables can be further populated with content or personalisation tags. You can unify your template to use it in different scenarios and conversations by personalising the text with variables. But you can't put most of your content in variables or create a template that consists only of variables. If you do, it will not pass moderation.
Footer
If you wish, fill in the footer that will be displayed below the text of the message.
Buttons
A total of two categories of buttons are available:
Callback and/or link
You can add a maximum of 2 buttons, one of which will be a clickable link and the other a phone number. Or you can add only one link button or only one phone number button.
For each of the buttons you need to fill in the button text - maximum 20 characters.
For a button with a URL in the link, it is allowed to use one variable to personalise this link.
Quick Reply
You can add a maximum of 3 buttons, for each of which you fill in:
Link/call buttons cannot be used in conjunction with quick reply buttons.
Please note that all variables and media attachments filled in during template creation are used exclusively for template moderation. When you create a post, you will be able to upload and prescribe real DC methods, links and personalisation. But during moderation Meta algorithms should understand what kind of content you will send to users.
If you want to save a template while creating it, but you haven't filled in all the fields yet, you can save a draft, just like in the case of any other channel.
After creating a template, it will be sent to Meta for moderation. Moderation takes several minutes to a day, on average - 5-20 minutes. You can be guided by the status of the template in the list:
Please note that a confirmed or rejected template cannot be edited. If you want to change something, you need to create a copy, make changes and submit the new template for moderation.
Once your template has successfully passed moderation, you can create a scenario message based on it. To do this, go to Mailings ➔ Messages and select «Create scenario message».
In the scenario message wizard, you need to select a template, fill in the content variables and provide links to attachments.
When creating a message, fill in the three sections of the settings.
Message name
You can use any characters you like. The name is necessary so that you can find the desired message in the list or select it in the scenario.
Selecting a template
Only confirmed WhatsApp templates are available. After selection, you need to fill in the content variables if you used them when creating the template, as well as links to images, videos or document for media templates. In the variables you can substitute:
To use personalisation tags in variables, open the dynamic content manager, click on the required field and the DC will be inserted in the place where your cursor was.
Tags
A WhatsApp channel scenario message is a message just like an email, text or push. You can attach tags to it to use them to filter your list of messages.
To check if dynamic content is displayed correctly, you can test your post:
The test is available only after selecting the template and filling in the variables
If you have problems with test sending, make sure that:
After creating a WhatsApp message, you can select it in the message sending block in scenarios. Messages in «Active» and «Inactive» statuses are available for selection. Read more about scenarios in this section of the knowledge base.
When your template has been successfully moderated, you can also send WhatsApp messages off-scenario. To do so, go to Mailings ➔ Messages and select «Create message».
Currently available ways to send:
The process of completing the message is identical to the one described in section “Creating WhatsApp scenario messages”.
You can also send WhatsApp message templates to a specific contact:
Please note, if there are buttons in the template you send - they will be displayed unclickable for you in the dialogs, only the recipient can click on them.
enKod can receive incoming messages from your customers. They will be displayed in the «WhatsApp Dialogues» section of the Mailings menu. If the contact who wrote to you is not in the database, we will automatically add him/her when receiving a message and display correspondence with him/her in «Dialogues». An incoming message from a contact outside the window of one of the three categories or a free-form reply outside the category window opens the «service dialogue» - correspondence to solve a client request.
You can reply to customers on their free-form messages (replies within the 24th window will be free), but a business can not write a free-for message to a customer first. Each free-form message sent by enKod has a person icon. If you hover over it, you'll be able to see the login of the user who sent the message.
You can start a dialog with a contact through sending a WhatsApp message template in the available ways:
In the dialogue with the contact, the events of sending template messages will be displayed, so that you can put together the chain of communications in the correct chronological sequence when communicating.
In addition to message texts, enKod handles incoming attachments from a contact:
You will have access to:
You can use contact tags for easy navigation through correspondence or in case different managers are responsible for customers with different parameters. You can also go to the contact card from the correspondence.
You can attach files to the messages you send from Dialogs by clicking on the “paperclip”:
Files of other formats will not be displayed in Explorer. You can attach only 1 file per message. If you reattach a new file, the previous file will be overwritten by the new one.
You can send text along with a file:
Media attachments sent and received more than 30 days ago become unavailable for viewing in the dialog, but everything will continue to be displayed correctly in the user's application.
By clicking on the envelope, you can select and send one of the moderated WhatsApp message templates to the contact.
You can view the statistics of your WhatsApp channel:
General statistics on the channel is available in the section Reports ➔ Mailings with WhatsApp filter installed
Please note that we record test template sends in the statistics, as they are actually real billed sends, only to one specific number.
As the platform only integrates with WhatsApp and is not directly involved in its development and support, enKod cannot influence some processes from its side. You need to contact the technical support of 360dialog or WA Business Manager yourself. Below we will tell you about common issues and options for resolving them.
The situation | The solution |
---|---|
The WhatsApp account has been blocked | A business account is in violation of Meta rules. The reasons for violations can be viewed in WA Business Manager. If necessary, you can request account verification (by selecting it in WA Business manager). If everything is OK, the account will be unlocked in a few hours |
The template was rejected while in moderation | You can read about common causes of deviation and how to correct it here. Initial moderation of templates is performed by algorithms, so sometimes templates are rejected without reasons. Rejection can be appealed in WABA manager. If the rejection is overturned, the status of the template in enKod will change automatically |
The quality of the account has gone down | Meta writes more about the criteria affecting account quality scores and ways to improve quality here |
No confirmation codes (two-factor verification) are received from Meta during onboarding or logging in to the LC 360 via the built-in Meta login | The SMS service for confirmations from Meta is often overloaded and unstable, especially for users from the Russian Federation. In case you do not receive the required message with the code, we recommend you to use resend or try again the next day |
Account verification | More information about the verification process is written in the Meta Help Center at the link |
Can't change account name | A company may change the displayed name no more than 10 times within a 30-day period. You can read more about the process and limitations here |
Some scheduled messages were not sent | The text limit for sending messages has been exceeded. Meta introduces tiered limits on the number of messages sent daily. You can find out your current limit in 360dialog and WA Business Manager. You can read more here |
I can't link the number to my account | Check to see if the account has been blocked. The reasons for violations can be viewed in WA Business Manager |
The WhatsApp app does not display the account name but the phone number, even though the display name is set | You may notice that in the header of the chat with your WA account, the phone number is displayed, not the specified display name. The name, on the other hand, is in small print only in the account profile. Unfortunately, displaying the name in the chat header or in the chat list is available: - or for verified business accounts with a “green check mark” (getting a “green check mark” is a time-consuming process with many conditions), • or for accounts in the process of verification: who have passed the display name check and provided data on sending quality messages (have at least 1,000 messages in 30 consecutive days). You can read more about the display name here. |