How can we help you today?
Search our knowledge base for guides, tutorials, and API documentation.
The QuickMessage Help Center is where businesses, marketers, and support teams find answers on working with the WhatsApp Business API. Browse our comprehensive guides below to master everything from setting up your shared inbox to building advanced automation flows.
Browse by Category
Everything you need to master the QuickMessage platform.
Getting Started
Meta Business Manager verification and connecting your WhatsApp number.
Connecting your WhatsApp Business number
Go to Settings > WhatsApp Setup in your dashboard. Click "Connect", log into your Facebook account, select your Meta Business profile, and verify your phone number via OTP.
Understanding Meta Business Manager setup
Meta Business Manager is required to verify your business identity. You need to provide legal business details and a working website to get approved for full API access and higher messaging limits.
Dashboard overview & widgets
The dashboard is your central command center. It gives you a real-time overview of your wallet balance, total contacts, active campaigns, and daily messaging volume (Sent vs. Received messages).
Sending your first message
Navigate to the "Inbox" tab. Click on "New Chat", enter the customer's phone number with the country code (e.g., 91 for India), select an approved template, and click send.
Shared Team Inbox
Route, assign, and resolve WhatsApp conversations as a team with private notes and tags.
Assigning conversations to agents
Open any conversation in the Inbox. Look for the "Assignee" dropdown at the top right corner. Select the specific agent from your team, and they will be notified immediately to take over the chat.
Using private internal notes
In the chat typing area, toggle the input mode from "Reply" to "Note" (highlighted by a different color). Messages typed as notes are strictly internal and will only be visible to your team members, not the customer.
Adding and using conversation tags
Use tags to categorize chats (e.g., VIP, Hot Lead, Support). You can apply existing tags or create custom ones directly from the right-hand sidebar menu within any active conversation.
Setting up auto-resolve rules
Navigate to Settings > Inbox Settings > Auto Resolve. Here, you can configure the system to automatically close and mark conversations as "Resolved" if a customer hasn't replied within a specific timeframe (like 24 or 48 hours).
Campaigns & Broadcast
Build segmented audiences, send compliant broadcasts, and read delivery reports.
Creating your first campaign
Go to the Campaigns module and click "Create Campaign". Name your campaign, select your target audience list, choose a pre-approved Meta template, map any dynamic variables (like {{1}} for Name), and choose to Send Now or Schedule for later.
Building an audience & segments
Navigate to Contacts > Lists to create categorized groups (e.g., "Existing Customers" or "New Leads"). You can further refine your audience by applying custom tags to contacts and using those tags as filters when launching a campaign.
Reading analytics & delivery reports
After launching a campaign, click on it to view real-time performance analytics. The dashboard will show exact counts for messages Sent, Delivered, Read, and Failed, giving you complete visibility into your campaign's success.
Troubleshooting low delivery rates
Low delivery rates usually happen if you are sending messages to invalid numbers, numbers not registered on WhatsApp, or if your Meta account quality rating has dropped. Check your campaign's failed message logs to identify the exact error codes.
Message Templates
Marketing, Utility, and Auth templates, Meta's approval process, and fixes.
Marketing vs. Utility vs. Auth
Marketing: Used for promotions, offers, or broad announcements. Utility: Used for specific transactional updates like order confirmations or shipping alerts. Auth: Used strictly for sending OTPs and secure account passcodes.
Submitting for Meta approval
Go to the Templates module and click "Add New". Choose the correct category, language, and name. Add your header, body text, footer, and interactive buttons, then click "Submit". Meta's AI usually reviews and approves it within a few minutes.
Common rejection reasons & fixes
Templates are often rejected for using promotional language in a Utility category, having mismatched or floating variables (like {{1}} without proper context), or violating Meta's commerce policies. Fix the content to match the correct category and resubmit.
Supported formatting & variables
Use *text* for bold, _text_ for italics, and ~text~ for strikethrough. You can use dynamic variables like {{1}}, {{2}} in your message body to automatically insert customer names or order details when sending campaigns.
Flow Builder (Automation)
Drag-and-drop no-code flows for lead routing, order updates, and customer support.
Flow Builder basics: nodes & triggers
A Trigger is what starts your flow (like a customer sending the keyword "Hi"). Nodes are the actions that follow, such as sending a text, asking a question, or providing interactive buttons. Simply drag a line from one node to another to build the customer journey.
Building a lead-qualification flow
Start with a keyword trigger. Add a "List Message" or "Buttons" node asking the customer what service they need. Based on their selection, route them to different nodes that collect their email, or use an "Assign to Agent" node to hand the qualified lead over to your sales team.
Building an order-status flow
Create a flow triggered by the keyword "Track" or "Status". Add an "Ask Question" node to request their Order ID. You can then use the API/Webhook node to fetch data from your CRM or Shopify store, and reply automatically with their real-time shipping details.
Testing your flow before publishing
Always test your automation before making it live. Click the "Test Flow" button in the top right corner of the builder. Enter your own WhatsApp number to simulate the experience and ensure all buttons and routing logic work exactly as expected.
Bot Replies
Keyword-based auto-replies, welcome messages, and human handoff rules.
Setting up keyword auto-replies
Go to Bot Replies > Add New. Define your keyword (e.g., "pricing"), choose the match type (Exact Match, Contains, or Starts With), and type out your automated response. You can also attach images, documents, or interactive buttons.
Configuring a welcome message
You can set up a default auto-reply that triggers whenever a new customer sends their very first message. Craft a friendly greeting and provide menu options using interactive buttons (like "Shop Now", "Support", "Offers") to guide their journey.
Building an FAQ auto-responder
Create multiple keyword rules for common queries like "location", "timing", or "refund". Assign specific textual answers or document attachments to each keyword so customers get instant resolutions 24/7 without waiting for an agent.
Handoff rules: Escalate to a human
When a customer selects "Talk to Human" or types keywords like "support", you can configure the rule to stop the bot from replying further and automatically assign the conversation to an active human agent in the Shared Inbox.
Contacts & Lists
Import via CSV, tag and segment contacts, and manage targeted audience lists.
Importing contacts (CSV formatting)
Navigate to Contacts and click "Import". Download the sample CSV file provided. Fill in your customers' details, ensuring phone numbers include the correct country code (without the '+' sign). Save the file and upload it back to the platform.
Tagging and segmenting users
Tags are flexible attributes (like "VIP" or "Cold Lead"). You can assign tags manually inside a chat, during a CSV import, or via automated flow rules. Use these tags in your Contacts database to easily filter and segment your audience.
Building a targeted campaign list
Unlike tags, Lists are specific audience groups (e.g., "Diwali Sale Audience" or "Premium Members"). Go to Contacts > Lists to create a new group. When creating a broadcast campaign, you will select this List as your recipient audience.
Bulk actions (delete, tag, move)
In the Contacts module, use the checkboxes on the left side to select multiple customers at once. Once selected, a top menu will appear allowing you to apply a tag, assign them to a list, or delete them in one single bulk action.
CRM & Integrations
Connect WhatsApp conversations to HubSpot, Salesforce, Zoho, and other business tools.
Connecting HubSpot or Salesforce
Go to Settings > Integrations. Click on the HubSpot or Salesforce card and hit "Connect". Authorize the application to map your WhatsApp contacts directly to your CRM leads and log chat history inside the CRM platform.
Connecting Zoho CRM
Navigate to the Integrations tab and select Zoho CRM. You will need to paste your Zoho API credentials. Once authenticated, choose which modules (like Leads or Contacts) should sync automatically with your QuickMessage database.
Connecting Shopify & Pipedrive
Connect your Shopify store to automatically trigger WhatsApp messages for order confirmations and abandoned carts via Flow Builder. Link Pipedrive to track all your WhatsApp sales conversations directly within your deals pipeline.
Using Webhooks (Events & Payloads)
For custom integrations, go to Developer Settings > Webhooks. Enter your server's endpoint URL. QuickMessage will instantly push HTTP POST payloads to your system whenever an event occurs, like an incoming message or a delivery status update.
Wallet & Billing
Wallet recharge, understanding conversation charges, invoices, and plan upgrades.
Recharging your wallet balance
Go to the Wallet module and click "Top Up" or "Recharge". Enter the desired amount and choose your preferred payment method. This wallet balance is used exclusively to pay for Meta's per-conversation charges and updates instantly.
Understanding conversation charges
Meta bills for conversations in 24-hour sessions. The cost depends on the category of the template used to start the conversation (Marketing, Utility, or Authentication). These charges are automatically deducted from your QuickMessage wallet.
Downloading invoices & history
Navigate to Settings > Billing. Here you can view your entire transaction history, track detailed wallet messaging deductions, and download PDF invoices for both your platform subscription and wallet recharges for accounting.
Upgrading or downgrading plans
Go to the Billing section to view your current active subscription tier. Click "Change Plan" to upgrade to a higher tier for more contacts/features, or downgrade if you need less. Changes are applied based on your billing cycle.
Troubleshooting
Quick fixes for common issues like undelivered messages and pending templates.
Message not delivered Checklist
Check if the recipient's number includes the correct country code. Ensure the 24-hour service window hasn't expired (if sending a normal text instead of a template). Also, verify in your Meta dashboard that your account quality rating hasn't dropped, which restricts sending limits.
Template stuck in "pending" status
While Meta's AI approves most templates in minutes, manual reviews can take up to 24-48 hours. Please be patient. Do not delete and resubmit the same template immediately, as this resets your place in the queue and delays it further.
Number disconnected from WhatsApp
This usually happens due to a Meta policy violation, a business verification failure, or if someone tried to log into the normal WhatsApp App with your API number. Log into Meta Business Manager immediately to check for restriction notices and submit an appeal.
Team member permissions issues
If an agent cannot access certain features like Campaigns or Settings, ask your workspace Admin to go to the "Staff Management" module. They need to verify that the agent's role is granted the correct permission level and their status is marked as "Active".
Security & Compliance
Two-factor authentication, data encryption, role-based access, and Meta policies.
Meta compliance overview
To use the WhatsApp API, your business must comply with Meta's Commerce and Business Messaging Policies. You cannot send spam, offensive content, or sell prohibited items (like weapons, tobacco, or medical drugs). Violations will result in a lowered quality rating or a permanent ban of your number.
How QuickMessage encrypts data
We use the official Meta Cloud API infrastructure, ensuring end-to-end encryption between the customer's device and the API server. Furthermore, the QuickMessage dashboard and all your customer data are protected with enterprise-grade SSL/TLS encryption.
Setting up role-based access control
As an Admin, navigate to "Staff Management" to invite team members. You can assign roles like "Agent" (access only to Inbox and Contacts) or "Admin" (full access to Billing, Campaigns, and Settings) to ensure data privacy and prevent unauthorized actions.
Enabling Two-Factor Authentication (2FA)
Go to Settings > Security to enable 2FA. Once turned on, logging into your QuickMessage account will require both your password and a unique OTP code. We also highly recommend enabling 2FA on your Meta Business Manager account to secure your WhatsApp number.
Media & Staff Rules
File size limits for media, reusing assets, and setting team permissions and roles.
Supported file types & size limits
WhatsApp API supports standard media formats. Max size limits are generally: 5MB for images (JPG, PNG), 16MB for video and audio (MP4, MP3, AAC), and up to 100MB for documents (PDF, DOCX, XLSX).
Reusing media across campaigns
Instead of uploading the same image multiple times, you can upload it once to the QuickMessage Media Library. You can then quickly select these saved assets from the library whenever you are creating a new template, campaign, or automation flow.
Setting up departments
In the Staff Management module, you can group your agents into specific departments (like 'Sales', 'Support', or 'Billing'). This makes it easy to automatically route customer queries to the right department using Flow Builder's "Assign" node.
Admin vs. Agent permission levels
Admins have full control over the workspace, including Billing, Wallet Recharges, Templates, Campaigns, and adding/removing staff. Agents have restricted access; they can only view the Shared Inbox to chat with customers and manage the Contacts list.
Developer API & Webhooks
Build custom integrations, automate workflows, and connect external systems.
REST API Reference
Detailed endpoints for sending messages, managing contacts, and authentication.
Authentication & API Keys
All API requests must be authenticated using a Bearer token. Include Authorization: Bearer YOUR_API_KEY in your request headers. You can generate, revoke, and manage your API keys from the Developer Settings in the QuickMessage dashboard. Always keep your keys secure and server-side.
Rate Limits & Best Practices
QuickMessage scales with Meta's official tier limits (e.g., 1K, 10K, 100K messages/day). If you exceed your limit, the API will return a 429 Too Many Requests error. We recommend implementing an exponential backoff retry logic in your code to handle bulk messaging smoothly.
Sending Template Messages
Make a POST request to /api/v1/messages. Set type: "template" in your JSON payload. You must include the template_name, language_code, and a components array mapping your dynamic variables (like order IDs or customer names) to the template placeholders.
Sending Media & Documents
You can send media by passing a direct public URL (e.g., link: "https://...") or by uploading the file to the Media Library first to get a Media ID. Set the message type to image, video, or document in your API payload.
Webhook Events
Listen to real-time events for message delivery, read receipts, and inbound replies.
Delivery & Read Receipts
When you send a message, we fire a POST request to your webhook URL with a statuses array. You can track the exact lifecycle of the message by listening for status values: sent, delivered, read, or failed (which includes the specific error code).
Inbound Customer Replies
Whenever a customer replies, your endpoint receives a payload containing a messages array. This array identifies the message type (text, image, interactive, etc.), the sender's WhatsApp number, their profile name, and the actual content of the message.
Understanding Payload Schemas
All webhook events are sent as HTTP POST requests with a JSON body. The root object contains an entry array, which houses the changes array. Your system should be programmed to parse this nested structure to extract the relevant message or status objects.
Securing your Webhooks
To prevent spoofing, we recommend setting up a Verify Token in your dashboard. Before processing any incoming payload, your server should validate the request signature in the HTTP headers to ensure the data is genuinely originating from QuickMessage servers.
Developer Tools
Resources to build faster, test effectively, and handle API errors like a pro.
Sandbox / Test Number Setup
Before taking your app live, use our Sandbox environment to send free test messages to a pre-registered phone number. This allows you to safely test your webhooks, logic, and API payloads without incurring Meta conversation charges.
Download Postman Collection
Jumpstart your development by downloading our pre-configured Postman Collection. It includes all our REST API endpoints, sample JSON payloads, and authentication headers ready to test out of the box with a single click.
Error Codes Dictionary
When an API request fails, it returns a specific error code (e.g., 131009 for an invalid recipient or 132000 for template parameter mismatch). Consult our complete dictionary to quickly diagnose and fix formatting issues or rate limit hits.
Client Libraries (SDKs)
Speed up your integration using our official SDKs available for Node.js, Python, and PHP. They handle authentication, payload structuring, and webhook parsing natively so you can focus entirely on your core business logic.
How WhatsApp API integration works, at a glance
Authentication & API keys
Requests to the QuickMessage API are authenticated with an API key tied to your account. Treat it like a password: keep it server-side, never expose it in client code, and rotate it if compromised.
Rate Limits & Tier Scaling
Sending capacity scales with your WhatsApp Business account's quality rating. Accounts that maintain good delivery and low block rates automatically unlock higher throughput over time.
Webhooks Architecture
Webhooks push real-time events (delivery status, inbound replies) directly to an endpoint you control. This means your system doesn't need to constantly poll our API for updates.
Error Handling
Failed sends usually happen due to: invalid recipient number, expired 24h session, unapproved template, or Meta restrictions. Always log the specific error code from our API response to diagnose issues instantly.
WhatsApp Business API Pricing & Billing
How WhatsApp API costs work, and where to find current rates.
Platform Fee vs. Meta Fee
WhatsApp Business API cost has two separate parts. There's a Platform Fee — what you pay QuickMessage for dashboard access, the shared inbox, chatbot builder, and automation tools. Then there are Meta Conversation Charges, which are set by Meta and billed per conversation based on the message category and destination country. QuickMessage doesn't mark up Meta's rates; you are billed exactly what Meta charges, plus your chosen platform plan.
Meta Conversation Categories
Every business-initiated message falls into one of these categories, which determine the per-conversation price:
Promotions, offers, and broad announcements you initiate. (Standard cost)
Transactional updates like shipping alerts and order confirmations. (Lower cost)
OTPs, passcodes, and account security alerts. (Lowest cost)
Replies within the free 24-hour customer-initiated support window. (No per-message cost)
Estimating your monthly cost
Your monthly WhatsApp API cost is roughly: Platform Plan Fee + (Expected conversations per category × Meta's rate for that category). Utility and Authentication conversations are priced lower than Marketing conversations, so a support-heavy use case (order updates, OTPs) typically costs less per message than a marketing-heavy one.
Meta sets and periodically updates conversation rates, so exact current pricing — along with QuickMessage's platform plans, contact limits, and features — lives on our Pricing page. For billing mechanics like wallet recharge and invoices, see the Wallet & Billing category above.
Troubleshooting Guides
Fast checklists for the issues we hear about most.
Message not delivered Checklist
What it means: The message left QuickMessage but never reached the recipient, or shows as failed/undelivered in your dashboard.
Common causes: The recipient's number isn't on WhatsApp, the 24-hour customer service window has closed (and the message wasn't an approved template), the recipient has blocked your business number, or your account's message quality rating has temporarily reduced your sending capacity.
What to check: Confirm the number format (with country code), check whether the conversation window was still open, and check your account's current quality rating in the Meta Business dashboard.
Still stuck? Contact our support with the message ID and timestamp so we can trace the delivery status directly on Meta's side.
Template stuck in "pending" status
What it means: Your template has been submitted to Meta but hasn't yet been approved or rejected.
Common causes: Review times vary based on Meta's current queue and your account's history. Most templates are reviewed within minutes to a couple of hours, but occasionally it can take up to 24-48 hours.
What to check: There's usually nothing to fix while a template is genuinely pending. Avoid resubmitting duplicate templates, as that can reset the queue and add to the review time.
WhatsApp number disconnected
What it means: Your WhatsApp Business number has lost its active connection to the API, meaning sending and receiving messages will completely stop.
Common causes: A policy violation flagged by Meta, a business verification issue in Meta Business Manager, or the number being registered on the normal WhatsApp app somewhere else.
What to check: Log in to Meta Business Manager and check for any account restriction notices before doing anything else. This tells you whether it's a policy issue or a technical setup issue.
Still stuck? Contact QuickMessage support immediately. Number disconnections directly affect your customers and are always treated as a high priority.
Why was my WhatsApp template rejected?
What it means: Meta reviewed your submitted template and declined to approve it for sending.
Common causes: Promotional language in a "Utility" category template, missing or mismatched variable placeholders (like `{{1}}`), incomplete sentences, or content that reads as generic/spammy rather than specific to a real customer interaction.
What to check: Match your template's category to its actual content. Utility templates must read as transactional (not promotional). Also, make sure every variable placeholder is used naturally in a complete sentence.
Still stuck? Resubmit with the specific issue addressed. If the rejection reason is unclear, drop the template text to our support for a quick review before resubmitting.
Frequently Asked Questions
Quick answers to what people ask us most before and after signing up.
What is the WhatsApp Business API?
It's Meta's official, verified way for businesses to send and receive WhatsApp messages at scale. Unlike the standard WhatsApp Business App on your phone, the API is built for integration with a CRM, Flow Builder chatbots, and multi-agent shared inboxes. QuickMessage provides you direct access to this infrastructure as an official Meta Business Tech platform.
Is the WhatsApp Business API free?
No. While replying to a customer within a 24-hour service window does not incur a new conversation charge, all business-initiated conversations (Marketing, Utility, and Authentication messages) are billed directly by Meta per conversation. Additionally, platforms like QuickMessage charge a subscription fee for providing the dashboard, automation tools, and team inbox features.
How long does WhatsApp template approval take?
Most templates are reviewed and approved by Meta's AI systems within a few minutes to a couple of hours. However, in some cases where manual review is required, it can take up to 24 hours. The review process is controlled entirely by Meta, not QuickMessage.
Can't find what you're looking for?
Our support team is ready to help you get the most out of QuickMessage.
Contact Support