WhatsApp Business API | Account Information & Get Started

With more than 1.5 billion people using WhatsApp around the world to send 60 billion messages every day, the chat app has revolutionized the way we communicate. With an enterprise-grade API, companies can now send notifications and provide customer service through WhatsApp in a secure, reliable, and customer-friendly way.

WhatsApp Business API Overview

Thanks largely to WhatsApp’s encryption technology and advertising-free user experience, WhatsApp has become today’s most popular way for consumers to have private conversations with their friends and family.  Building on that consumer trust, WhatsApp has launched its Business API to provide the same level of security and experience to their users even when they choose to chat with businesses right on the same channel.

For businesses, the WhatsApp Business API presents a unique opportunity to engage and help customers with relevant notifications, updates, confirmations and support communications in a secure and familiar environment. Furthermore, with WhatsApp, businesses can also automate responses and integrate into their existing customer engagement systems (CRM, contact center, etc.) to speed up problem resolution – and keep customers happy.

At the same time, there are businesses that prefer handling WhatsApp conversations differently, or perhaps do not have developer resources to handle an integration. When this is the case, tyntec's Support Inbox may be a better fit. As a web-based User Interface, the Support Inbox enables you to orchestrate and manage chat conversations in a simple inbox.

WhatsApp and tyntec Infrastructure

tyntec’s customers can access the WhatsApp Business API via tyntec’s Conversations API – a powerful and simple way to access multiple messaging services when needed, including WhatsApp, Facebook Messenger, Viber, and SMS.

With tyntec’s Conversations API, businesses can send conversational notifications and support messages — and receive replies — without switching to a new software solution or UI.

 

WhatsApp Architechture

 

 

WhatsApp API Client Hosting

As an official WhatsApp Business solution provider, we eliminate the operational overhead of running your own WhatsApp network integration, which would require hosting, scaling, maintaining, monitoring, and troubleshooting WhatsApp software, clients, and third party databases into your own cloud infrastructure. With tyntec you’ll have access to:

  • tyntec’s REST API for WhatsApp Business
  • Value-added features for security and more
  • Hosting and scaling
  • Maintenance and updates
  • Business-to-consumer communications know-how
  • Access to other chat channels (Viber, Facebook Messenger, SMS)

 

WhatsApp Client Hosting

 

How you integrate the WhatsApp Business API depends heavily on your customer touchpoint strategy and technology resources. Explore your options by getting in touch with tyntec, an official WhatsApp Business Solution provider.

WhatsApp Business Account

Create your tyntec account

To make is simpler for enterprises to use the WhatsApp Business API, WhatsApp has chosen to work through authorized solution providers instead of direct integration. Therefore, the process starts with requesting the access to one of the authorized providers like tyntec.

You can get started by creating your tyntec account here.

Once you create your tyntec account, you can get your API key name under 'API settings' at your left-side menu, which should be added on your setup form (see next step).

TIP: If you’re a technology provider/ISV requesting the access on behalf of your enterprise customers, note that each of your enterprise customers will need an individual WABA. Most technology providers get started by registering their own company to test the product and showcase it to their customers. If your enterprise customers are ready to get started, you can itemize each customer on your form for WhatsApp approval.

Also, the onboarding and billing processes for ISVs are different from a direct enterprise. Please contact us at onboarding@tyntec.com for more information.

Setting Up and Activating Your Account

Once you have setup your tyntec account, it’s time to set up your WhatsApp Business Account, and complete the activation — and get ready to exchange messages on WhatsApp!

tyntec guides you through the entire WhatsApp Business Account process and makes it even easier for you with a comprehensive checklist.

Prep your Setup (incl. free trial)

Before you fill out the WhatsApp setup form. let's have a look at the prerequisites you need to prepare:

API key name

You need a tyntec API key name to associate your future WhatsApp Business Account (WABA) with tyntec. As already mentioned in 'Create account', this is how you can get your API key name:

  1. Create an account in tyntec’s customer portal
  2. Check “API settings” at the left side menu
  3. Simply copy the API key and your API key name (e.g. abccpaas)

Facebook Business Manager ID

  1. Go to Facebook Business Settings
  2. Click on Business Info (in the left navigation)
  3. Find your FB Business Manager ID at the top (just below your business name)

Check here detailed instructions on how to get your Facebook Business Manager ID.

Phone number

You have to provide a new, valid phone number at this stage. You also need to identify whether this phone number is capable of receiving SMS or whether it’s associated with an IVR.

Please do NOT use a personal phone number for the API.

Display information

Define your business name, business description, address, brand image and more. This is the information shown in your WhatsApp Business Profile.

Pricing plan

Define your package according to your needs. Check our available pricing packages.

NOTE: If you're starting with the free trial, your setup will grant you 30-days access to WhatsApp and Support Inbox. Just select 'free trial' in your setup form.

A few days prior to the free trial expiration date, you can decide whether to continue with WhatsApp + Support Inbox, WhatsApp Business API or discontinue the service.

Set Up Your WhatsApp Business Account (WABA)

You will receive an email with instructions on how to set up your WhatsApp Business Account and how to configure your WABA.

Upon submission, you’ll receive a confirmation that the information has been received by tyntec and submitted to WhatsApp. In case there’s any issue, we’ll inform you accordingly.

Approve tyntec on your Facebook Business Manager

Once approved, please accept the approval for "message on behalf of" on your Facebook Business Manager.

Please note you need admin access to see the “message on behalf of” and accept this request on your Facebook Business Manager.

This is how it looks like:

message on behalf request large

Business verification

Business verification allows Facebook/WhatsApp to identify real businesses on the platform and give them access to the features they need, as the WhatsApp does not have visibility to business-to-user conversations due to encryption. Hence, it’s important to make sure all companies are verified, making sure Facebook/WhatsApp remains a safe space for businesses and users alike.

In this step, Facebook/WhatsApp look at authenticity (is the business legally registered?) and association (does the person requesting verification work for the business?).

You have to proceed to business verification directly on your Facebook Business Manager. Here are the steps you need to follow to get your business verified.

For more information on business verification, check our comprehensive FAQs on business verification.

 

Phone verification

As your WABA needs to be associated with a phone number, your phone number must be verified. To do this, tyntec will perform two-factor authentication by sending a verification code to the number you provided. Upon verification, your account will be activated — and ready for your deployment!

To ensure that the verification process goes smoothly, tyntec will contact you in advance to make sure that your team is ready to respond to the verification.

 

Your WhatsApp Business Account is ready!

After your phone number has been verified, your WhatsApp Business Solution is ready! If you haven't yet integrated our API, check out our API reference and start deploying with ease.

It's highly recommended to test internally before rolling out to your customers, and of course making sure your opt-in policy in place.

But wait, have you collected opt-ins yet? If you haven’t, let’s get going. Would you like to learn how other brands are doing it? Some inspirations here

Send your first message

Check here instructions on how to send your first message.

Build Two-Way WhatsApp Interaction Tutorial

Check instructions how to handle two-way communications on WhatsApp. Check the tutorial.

 

Message Templates

You can add your first message templates after receiving the instructions via email after your setup for your WABA. You can always submit new Message Templates via your my.tyntec.com account or via the Message Templates API.

When using your my.tyntec.com account, please refer to this Message Template Manager overview for instructions on how to create new message templates.

You’ll also receive a confirmation from tyntec that your message templates have been approved. In case they are rejected by WhatsApp, we will guide you on how to create messages that are compliant to WhatsApp policies.

When using Message Template API, you get the following benefits: 

  • The templates are synched with WhatsApp automatically (due to restrictions on the Facebook API this can't  be done synchronously)
  • The templates are pushed and pulled by two different jobs and both jobs are configured to run alternating every 5 minutes. This ensures that a template requested via our API is approved right after the submission.

This means, submitting message templates is faster and you get a quicker feedback for approved/rejected status (in 15 minutes latest). In contrast with the message template form, this can take 2-3 business days.

For more information on how to create message templates, have a look here.

Accounts

To run your customer interactions on WhatsApp Business API, you must be seen as a WhatsApp Business Account (also known as WABA). There are two types of WhatsApp Business Accounts:

Types of WhatsApp Business Accounts
Name Description
Official Business Account WhatsApp has verified that an authentic brand owns this account. An Official Business Account has a green checkmark badge in its profile and next to the header in the chat thread. The name of the business is visible even if the user hasn't added the business to their address book, and will be visible in the chat list, chat screens, chat groups, and contacts view instead of the phone number.
Business Account Any account that is using the WhatsApp Business API is by default a Business Account. The verified brand name will only be shown, in smaller text, in the contacts view; all other views will show the phone number. You can help customers learn more about your company by filling out your business info, including business website, address, and hours.

Depending on your WhatsApp Business Account type, end users will see your account differently. However for both types of accounts, if an end user has already saved the company’s number in their address book, the name from their address book will always be displayed — also, the company phone number will still be visible in their contact view. Please be prepared for any customers who may try to call this number and have a plan for how to handle these incoming calls.

While it’s not mandatory to have a verified WABA, this status provides an enhanced user experience and improves consumer trust. A verified WABA is marked by a green checkmark, and the company name will always be shown even if the customer did not save the brand’s phone number in their phonebook. A business can also provide useful information, including the purpose of the account, business hours, website, etc.

How to Request a Verified WhatsApp Business Account

You can request an “official business account” for your end clients, which triggers a review process. We review requests by verifying that a business is a real entity and evaluating a company’s notability.

Businesses that are approved for an “official business account” will receive a green, verified badge on their Business Profile. Please note that as a solution provider you’ll need to “message on behalf” of the client's Business Manager ID, to be able to request business verification through this process. Any WhatsApp Business Accounts which don't have an end client associated with it will not be reviewed as part of this request.

In case you want to apply for an official WhatsApp Business Account, you can apply with tyntec by filling out the Request Official Business Account form.

At the moment, there are no other benefits to having this verified badge, and companies that are not eligible after going through the review process can continue to run their business as usual on WhatsApp. 

Phone Numbers

A WhatsApp verified account is always linked to a phone number.

Here are a few tips and guides on how to select a phone number for your WhatsApp Business Profile.

Selecting a Phone Number

Here are a few guidelines to select a phone number associated with your WhatsApp Business Profile:

  • Your business must use a valid phone number.
  • Short codes are not allowed on the WhatsApp platform.
  • The number must include a country and area code.
  • Landline and cell phone numbers are acceptable phone numbers to use.
  • Since a phone number is tied to a WhatsApp account, you must own this number.
  • This phone number must be able to receive voice calls or SMS in order to complete registration.
  • This phone number must also not have been used with the WhatsApp Business API before.
  • To use a phone number already on WhatsApp (consumer or business app), refer to the instructions on how to migrate a phone number below.

You don’t have to buy a phone number from tyntec

If you have your own phone number and prefer to use it, you can certainly do so. Your phone number can be mobile, toll-free, or landline. In some countries, such as Germany, you can even add a two-way SMS and WhatsApp channel to your existing landline number.

Migrating a Phone Number

In order to migrate your existing number to WhatsApp, you would have to delete/deactivate your existing account through the business app. Follow the instructions here. 

Before deleting the account, you have to save the history on your end.

🚫 Please note that once you have deleted a phone number from the app and added to the API, this action cannot be reverted.

Using a Phone Number tied up to an IVR (1-800 and Toll Free)

Many businesses want to use phone numbers their customers already know such as their 1-800 or other toll free numbers. These type of numbers are usually behind an Interactive Voice Response (IVR) system, which a WhatsApp registration call cannot navigate. Instead, tyntec & WhatsApp are able to share with you 1 to 2 two sender IDs that the registration phone call will come from.

tyntec will provide you with two sender IDs upon request. You can use this information to create a whitelist for those numbers — so that once the call comes in, you can redirect it to an employee or mailbox where the registration code will be captured.

    Please request the sender IDs to onboarding@tyntec.com at least 48 hours before the verification code is scheduled to be sent out.

    The phone verification process for an IVR phone number requires that the verification code is sent via voice call. To make sure you get the verification code and your WABA is configured, schedule a 15-minute call with our Onboarding Team.

    IVR Deflection

    Known as 'call-to-messaging deflection', more and more brands are deploying IVR deflection to WhatsApp Business to enhance their customer support. This shift is increasing customer satisfaction rates and boosting operational efficiency.

    IVR deflection enables businesses to shift customer calls to WhatsApp where they may be able to:

    • Provide better service as WhatsApp enables customers to share photos, videos, and other media to share their customer issues
    • Improve agent efficiency by shifting customer issues to WhatsApp where agents can handle more conversations at once
    • Reduce overall costs of customer service phone operations.