UCal
  • Welcome
  • 🚀Getting Started
    • Quick Start
      • What is IS-Messenger?
      • Setting Up an Account
      • Connecting Channels
      • Inviting Your Teammates
      • Getting Contacts to Message You
      • Automated Welcome and Away Messages
      • Responding to Messages
      • Glossary of Terms
    • Connecting a Channel
    • Invite your teammates
    • Getting Contacts to Message You
    • Automated Welcome and Away Messages
    • Responding to messages
    • Glossary of Terms
    • Creating a Chatbot
  • ⚙️Workspace Modules
    • Dashboard
    • Inbox
      • Inbox Overview
      • Assignment and closing a conversations
      • Custom Inboxes
      • Interacting with Respond AI Prompts
      • Using AI Assist
    • Contacts
      • Contact Details
      • Contacts Overview
      • Merge Suggestions
      • Contact Activity
      • Contact Channels
      • Contact Import
      • Segments
    • Broadcast
      • Broadcast Overview
      • Managing Broadcasts
    • Workflow
      • Triggers
      • Workflow Step
        • Step: Send a Message
        • Step: Ask a Question
        • Step: Assign To
        • Step: Branch
        • Step: Update Contact Tag
        • Step: Update Contact Field
        • Step: Open Conversation
        • Step: Close Conversation
        • Step: Add Comment
        • Step: Jump To
        • Step: Wait
        • Step: Date & Time
        • Step: HTTP Request
        • Step: Trigger Another Workflow
        • Step: Add Google Sheets Row
        • Step: AI Agent
      • Workflow Templates
    • Reports
      • Reports: Conversations
      • Reports: Responses
      • Reports: Resolutions
      • Reports: Messages
      • Reports: Contacts
      • Reports: Assignments
      • Reports: Leaderboard
      • Reports: Users
      • Reports: Broadcasts
  • ⚙️Workspace Setting
    • Managing a Workspace
    • General
    • Users
      • Access Levels
    • Teams
    • Channels
      • Chat Menus
    • Contact Fields
    • Growth Widgets
      • Website Chat Widget Quick Start
      • Website Chat Widget Overview
      • Workspace Settings: Growth Widgets
      • Install Website Chat Widget on Squarespace
      • Install Website Chat Widget on Joomla
      • Install Website Chat Widget on Wix
      • Install Website Chat Widget on Shopify
      • Install Website Chat Widget on WordPress
      • How to Track Conversation Source from Multiple Websites
    • Respond AI
    • Integrations
      • Dialogflow
        • Dialogflow: Connecting to Dialogflow
        • Dialogflow: Creating a Chatbot
        • Dialogflow : Managing Intents
        • Dialogflow: Parameters
        • Dialogflow: Events
        • Dialogflow: Response Templates
        • Dialogflow: Custom Payloads
        • Dialogflow: Fulfillment Webhook Request
      • E-Commerce & CRM Integrations
        • E-Commerce Integration: Shopify
        • E-Commerce Integration: BigCommerce
        • E-Commerce Integration: WooCommerce
        • E-Commerce Integration: Magento
        • CRM Integration: HubSpot
        • CRM Integration: Salesforce
        • CRM Integration: Pipedrive
        • CRM Integration: ActiveCampaign
      • Zapier
      • Developer API
      • Webhooks
      • Make (formerly Integromat)
    • Closing Notes
    • Snippets
    • Files
    • Data Export
    • Data Import
  • ⚙️User Account
  • Profile
  • User Activity Status
  • Notifications
  • Resetting your Passwords
  • 👨‍👧‍👦CONTACT AND MESSAGES
    • Dynamic Variables
      • Dynamic Variables Overview
      • How to Use Dynamic Variables
    • Contact Search and Custom Inbox
    • Conversations
  • ⚙️MESSAGING CHANNELS
    • Channel Overview
    • Facebook Messenger
      • Facebook Messenger Quick Start
      • Facebook Chat Plugin
      • Private Replies
      • Message Tag
    • Instagram
      • Instagram Overview
      • Instagram Quick Start
    • WhatsApp
      • WhatsApp Business API Quick Start
      • Getting Ready for Inbound Conversations
      • Getting Ready for Promotional Messaging
      • WhatsApp Official Business Account (Green Tick)
      • Grow your WhatsApp Audience by Maximizing Entry Points
      • Get WhatsApp API Account for Government Agencies
      • Meta Business Verification
      • WhatsApp Message Templates
      • WhatsApp Pricing
      • WhatsApp Business Platform (API) Channel Configuration
      • WhatsApp Messaging Limits
      • Meta Product Catalog
      • Change Your WhatsApp Business Display Name
      • Phone Number Migration to IS-Messenger WhatsApp Business API
      • Turn-off WhatsApp Number Two-Step Verification
      • WhatsApp Cloud API
        • Migrating from On-Premises API to Cloud API
        • Migrating from Cloud API to On-Premises API
        • Set up the WhatsApp Echo Bot
        • Load Testing on Cloud API
        • Experiments
        • Webhooks Setup
      • 360Dialog WhatsApp
      • Twillio WhatsApp
      • MessageBird WhatsApp
      • Vonage WhatsApp
      • Phone Number Migration to WhatsApp Cloud API
    • Website Chat Widget
      • Install on WordPress
      • Install on Shopify
      • Install on Wix
      • Install on Squarespace
      • Install Website Chat Widget on Joomla
    • LINE
      • LINE Overview
      • LINE Quick Start
    • Telegram
      • Telegram Overview
      • Telegram Quick Start
    • Viber
      • Viber Overview
      • Viber Quick Start
    • SMS Overview
      • Twilio SMS Quick Start
        • Importing Contacts to Twilio SMS
      • MessageBird SMS Quick Start
      • Vonage SMS Quick Start
    • Twitter Overview
      • Twitter Quick Start
    • WeChat
      • WeChat Overview
      • WeChat Quick Start
    • Google Business Message
    • Email
      • Google Workspace Quick Start
      • Other Email
    • Custom Channel
      • Custom Channel Overview
      • Custom Channel Quick Start
  • New Release Update
  • Support Use Cases
    • How to Identify Contacts by Email and Phone NumberI
    • How to Enrich Customer Data from a CRM or other Business Software
    • How to Route Customers to the Right Team Automatically
    • How to Auto-Assign Customers to a Team or Dedicated Agent
    • How to Send Outbound Support Messages
    • Support: Closing Conversations
    • How to Supervise Your Support Agents
    • How to Analyze Reports for Support
    • How to Send CSAT to Customer and Save Data in Google Sheets or CRMs
  • Handling Inbound Conversations
    • Managing Spam
    • Create Automated Welcome and Away Messages
    • Get Contacts’ Consent for Personal Data Collection
    • Create Automated Chat Menus
    • Collect Contacts’ Emails and Phone Numbers
    • Route Contacts by Shifts
    • Route Contacts by Team Functions
    • Route New & Returning Contacts
    • Route VIP Contacts
    • Assignment Strategy: Automatic Contact Distribution & Load Balancing
    • Assignment Strategy: Unassign Agents after Conversations Closed
  • Capture Conversations
    • How to Streamline Meeting Scheduling via CTC Ads
    • How to Automate Product Info Sharing in Conversations Initiated via CTC Ads
    • How to Track Conversation Source from Multiple Websites
    • How to Route Contacts from CTC Ads to Agents
  • Automate Conversations
    • How to Maximize Customer Service Potential with AI Agent
    • How to Automate Contact Information Collection with AI
    • How to Route Contacts to Preferred AI Agent
    • How to Automatically Qualify Contacts Based on Budget Using AI Agent
    • How to Route Contacts by their Preferred Language
    • How to Create Automated Chat Menus
    • Assignment Strategy: How to Automate Contact Distribution & Load Balancing
    • Assignment Strategy: Unassign Agents after Conversations Closed
    • How to Create Automated Welcome and Away Messages
    • How to Block Contacts and Manage Spam
    • How to Route New and Returning Contacts
    • How to Collect Contacts’ Emails and Phone Numbers
    • How to Route New and Returning Contacts
    • How to Route Contacts by Team Functions
    • How to Route Contacts by Shifts
    • How to Get Contacts’ Consent for Personal Data Collection
    • How to Route VIP Contacts
  • How to Promptly Transfer Conversation Between Agents
  • How to Guide Customers from Exploration to Purchase with Engaging Menus
  • How to Optimize Customer Onboarding with Automated & Customized Welcome Messages
  • Converse with Customers
    • How to Get a Complete View of the Customers
    • How to Simplify Customer Escalation with Automation
    • How to Transfer Contacts to the Next Shift Automatically
    • How to Optimize Agents’ Productivity in the Messages Module
    • How to Align AI Conversations with Your Brand Voice
    • How to Draft Customer Replies with AI
    • How to Convert Image to Text Using AI
    • How Automate Calculations Using AI
  • Broadcasts Use Cases
    • How to Sending a Simple Broadcast
    • How to Start a Workflow Based on Broadcast Response
    • How to Import to Broadcast via WhatsApp
    • How to Troubleshoot a Failed Broadcast
  • Sales Use Cases
    • How to Collect Leads' Email and Phone Number
    • How to Enrich Contact Data and Qualify Leads
    • How to Route Leads
    • How to Auto-Assign Leads to Sales Agents
    • How to Send Outbound Sales Messages
    • How to Track Productivity by Closing Conversations
    • How to Supervise Sales Agents
    • How to Analyze Reports for Sales
  • Accessing Help Menu
Powered by GitBook
On this page
  • Configuring WhatsApp Channel Name
  • Managing Profile for WhatsApp Business Platform (API)
  • Phone Number Information
  • Metadata Received by Channel
  • Supported File Type
  • Rate Limits
  • Limitations
  • FAQ and Troubleshooting
  • Unable to Receive Read Receipts
  • Can I view my conversation insights for my WhatsApp Business Account?
  • Why do I see duplicate Contacts from the same WhatsApp channel?
  • How do I get my business name to be shown to my contacts on WhatsApp rather than my business number?
  • What is WhatsApp Catalog and how can I use it?
  • Can a subsidiary company or an agency register a WhatsApp Business Account on behalf of another company?
  • How many phone numbers can a business register when signing up for a WhatsApp Business API account and How can I Increase that limit?
  • How can I check my WhatsApp conversation consumption?
  • Why does the message enter as an unsupported message with error code: 131051?
  • Why am I receiving an error message stating "Undefined: Receiver is incapable of receiving this message" when trying to send messages?
  • Can I sign up for a WhatsApp API account with a Turkish number (+90) to send messages?
  • I’ve lost credentials for my Meta Business Manager account. What should I do?
  • I’ve lost credentials for my Meta Business Manager account. What should I do?
  • Why has my WhatsApp Business Account been disabled?
  • Why did I receive this error "Business eligibility payment issue" when sending a message?
  1. MESSAGING CHANNELS
  2. WhatsApp

WhatsApp Business Platform (API) Channel Configuration

PreviousWhatsApp PricingNextWhatsApp Messaging Limits

Last updated 1 year ago

Configuring WhatsApp Channel Name

A WhatsApp Business API channel can be configured with a unique channel name.

Step 1: Navigate to Settings module > Click Channels.

Step 2: Locate the WhatsApp Business API channel > Click Configure.

Step 3: Configure the channel name, which is the name that is used internally to identify the account.

Step 4: Click Done to update the channel configuration.

Managing Profile for WhatsApp Business Platform (API)

If there is a need to make a change or check your WhatsApp Business API Profile, it can be done on the IS-Messenger platform.

Step 1: Navigate to Settings module > Click Channels.

Step 2: Locate the WhatsApp Business API channel > Click Profile.

Step 3: If the profile hasn't been synced, click Sync Profile to obtain the latest WhatsApp Business Profile information from WhatsApp.

Step 4: You may edit the following information as needed:

Fields

Description

Profile Photo

Image shown as the profile picture of the WhatsApp Business Account.

An image size of 640x640 is recommended.

About

The business's About text. This text appears in the business's profile beneath its profile image, phone number, and contact buttons - maximum of 139 characters.

Address

Address of the business. Maximum of 256 characters.

Description

Description of the business. Maximum of 512 characters.

Email

Email address (in valid email format) to contact the business. Maximum of 128 characters.

Vertical

Industry of the business. Must be one of these accepted values:

  • Automotive

  • Beauty, Spa and Salon

  • Clothing and Apparel

  • Education

  • Entertainment

  • Event Planning and Service

  • Finance and Banking

  • Food and Grocery

  • Public Service

  • Hotel and Lodging

  • Medical and Health

  • Non-profit

  • Professional Services

  • Shopping and Retail

  • Travel and Transportation

  • Restaurant

  • Other

The business vertical cannot be set back to an empty value after it is created.

Website

URLs (including http:// or https://) associated with the business (e.g., website, Facebook Page, Instagram). Maximum of 2 websites with a maximum of 256 characters each.

Step 5: Review the information and click Save.

Phone Number Information

  • Quality of the phone number: Quality Rating of the phone number.

  • Verified status of the phone number: ✓ icon will be shown if the phone number is verified.

Metadata Received by Channel

Different channels provide different sets of Contact’s metadata to IS-Messenger platform. You can obtain the following Contact's data from this channel:

  • Phone number

  • Phone number ID

  • Profile name

  • WhatsApp ID

Supported File Type

The file type supported by WhatsApp and the maximum file size for the type is as follows:

  • Audio & Video (16MB)

  • Document (100 MB)

  • Image (5 MB)

  • Sticker (100 KB)

Messages that are not supported will have a fallback display with Unsupported Message or Custom Payload text and Type (if available). For any unsupported file type or file that exceeds the maximum file size sent via WhatsApp Business Platform (API), the file will automatically be turned into a URL link on the IS-Messenger platform. For Custom Payload, you can click Show More to view the JSON payload of this message. Examples of unsupported messages for WhatsApp Business Platform (API) are: - Contact Card - Reactions - Deleted Message - Polls - Ephemeral Message

Rate Limits

Limitations

WhatsApp Groups

Group Messages are not supported by WhatsApp Business API. Facebook has deprecated the development of this feature.

Voice Calls

WhatsApp voice calls are not supported by WhatsApp Business API.

FAQ and Troubleshooting

What are the requirements for phone number to be used to sign up for WhatsApp Business API?

  • The phone number used for WhatsApp Business API can’t be used in the WhatsApp Personal or Business app. You'll have to delete the account on WhatsApp Personal or Business app before you can use the number to sign up for WhatsApp Business API.

  • You can still use the phone number for other purposes, such as calling and receiving SMS after registering it on the WhatsApp Business Platform.

Unable to Receive Read Receipts

When the user connected to WhatsApp Business API changes their Facebook password, the permissions will be outdated and need to be refreshed. Follow these steps to refresh the permissions:

Step 1: Navigate to Settings module > click Channels > locate WhatsApp Business API Messenger channel > click Troubleshoot.

Step 2: Click Refresh Permission to refresh WhatsApp permissions.

Step 3: Send a test message to the WhatsApp phone number and check if you're able to receive the read receipts.

Can I view my conversation insights for my WhatsApp Business Account?

Why do I see duplicate Contacts from the same WhatsApp channel?

How do I get my business name to be shown to my contacts on WhatsApp rather than my business number?

Standard WhatsApp Business API Accounts display the business number rather than the name. To display your business name to Contacts even if they haven't added your business to their address book, you will need a WhatsApp Official Business Account.

What is WhatsApp Catalog and how can I use it?

WhatsApp Catalog is a feature that allows you to create a catalog of your products and share it with your customers. We have a feature request for this to be implemented in our platform. If you think this feature is valuable to you, you can upvote the feature request here.

Can a subsidiary company or an agency register a WhatsApp Business Account on behalf of another company?

Yes, they can. However, the Meta Business Account and business information used to register the WhatsApp Business Account must belong to an entity that can be verified with the relevant legal documentation. Learn more about Meta Business Verification here.

How many phone numbers can a business register when signing up for a WhatsApp Business API account and How can I Increase that limit?

When a business signs up for a WhatsApp Business API account and is unverified, they can register up to 2 phone numbers only. Verified businesses have the ability to register more phone numbers. They may register up to 20 phone numbers for a single Business Manager.

If you are stuck at a lower number, such as 5 phone numbers, and are unable to register additional numbers, you can submit a ticket directly to Meta to request an increase in the phone number limit.

Steps:

  1. Go to Ask a Question > WABiz: Account & WABA > Request type > Increase Phone Number Limits

  2. Provide an explanation of why you want to increase the phone number limit.

  3. Submit your request.

How can I check my WhatsApp conversation consumption?

To check your WhatsApp conversation consumption, follow these steps:

  1. Click on Settings > Business Settings > WhatsApp Accounts

  2. Select your WABA and click on Settings > WhatsApp Manager.

  3. Under Account tools, click on Insight.

Why does the message enter as an unsupported message with error code: 131051?

Why am I receiving an error message stating "Undefined: Receiver is incapable of receiving this message" when trying to send messages?

This error message is passed by Meta. Here are a few steps suggested by Meta to troubleshoot the issue:

Ensure that the Contact receiving the message:

  • has an active WhatsApp account.

  • is using the latest version of WhatsApp.

  • has accepted the new Terms of Service and Privacy Policy.

  • is not banned on WhatsApp or from a country where WhatsApp is banned.

Can I sign up for a WhatsApp API account with a Turkish number (+90) to send messages?

I’ve lost credentials for my Meta Business Manager account. What should I do?

I’ve lost credentials for my Meta Business Manager account. What should I do?

Why has my WhatsApp Business Account been disabled?

Your WhatsApp Business API (WABA) account may be disabled for several reasons. Common issues include non-compliance with Meta's Commerce Policies and listing an invalid website. To appeal this decision, you should take the following steps:

Ensure Compliance with Meta's Commerce Policies: Review and align your business practices with Meta's guidelines. This is crucial for a successful appeal.

Ensure you have a Valid Website: Update your business information in the Meta Business Manager (MBM) to include a valid and clear website that showcases the nature and details of your business.

Prepare an Appeal: In the appeal dialogue, explain how your business uses WhatsApp for communication. Highlight that:

  • Messages are sent only to customers who have opted in.

  • All communications are relevant to your business and following WhatsApp's policies.

Why did I receive this error "Business eligibility payment issue" when sending a message?

This error may occur when you have recently deleted a Channel and tried to send a WhatsApp message template or start a new conversation using a different WhatsApp Business number. This is due to the credit line being released from your deleted Channel's phone number and redistributed to your remaining phone numbers. This process can take up to 5 minutes. We recommend waiting for 5 minutes before sending the message again.

This error will only occur if you have more than one number under the same Business Manager and those numbers are connected to the platform.

Can my WhatsApp API number connected to a WhatsApp Business Account (WABA) registered in Business Suite directly connect to IS-Messenger?

No, it is not possible for your WhatsApp API number that's connected to a WhatsApp Business Account (WABA) registered in Business Suite to directly connect to IS-Messenger.

Messaging limit of the phone number: The maximum number of you can initiate using each of your phone numbers in a rolling 24-hour period.

Learn more about .

Make sure that the file format of your file is supported; otherwise, the file may fail to send despite being within the size limit. This happens when the file is not converted properly. Learn more about the .

A rate limit is the number of API calls an app or user can make within a given time period defined by the channel. Learn more about the .

Yes, you can monitor your messaging and spending analytics in real-time for your WhatsApp Business Account in the Insights tab of your Meta WhatsApp Manager. Read more .

WhatsApp passes the Contact’s phone number in that IS-Messenger uses. This difference causes Contacts from certain countries to be duplicated.

Official Business Accounts have a green tick next to the business name, and usually only large, high-profile businesses will be given this status. Learn more about how to .

Click here for direct support.

Navigate to your .

One of the possible reasons is that WhatsApp API accounts are not designed to chat with other WhatsApp API accounts. This is a Meta restriction. Note that the error code: 131051 is used for multiple types of errors related to unsupported message types. If you are unsure about this error, you can .

Yes. However, app users in Turkey won’t be able to receive your messages. For businesses in Turkey who are looking to communicate with customers using a Turkish phone number, we recommend working with other WhatsApp BSP offering on-premise solutions like . Learn more about .

To regain access to your Meta Business Manager account, you can learn how to reset your password and recover your email address or phone number .

To regain access to your Meta Business Manager account, you can learn how to reset your password and recover your email address or phone number .

Learn how to request a review with Meta .

⚙️
business-initiated conversations
Phone Number Quality Rating and Messaging Limits here
supported media types here
rate limits for this channel here
here
a format that is different from the E.164 format
apply for an Official Business Account here
this link
Meta Business Manager
contact our support
360dialog
country restrictions here
here
here
here
Configuring WhatsApp Channel Name
Managing WhatsApp Business API Profile
Managing WhatsApp Business API Profile - Sync Profile
Unable to Receive Read Receipts