1. What Is Meta Business Agent?

Meta Business Agent is a configurable AI assistant connected to a business messaging account. Instead of building a chatbot completely from scratch, a business can configure an agent with its own information, policies, FAQs, website content, files, and behavioral instructions.

For customers, the experience is simple: they send a message and receive a helpful response. For the business, the agent works as an automated first-line assistant that can answer common questions, reduce repetitive support work, and improve response time.

Simple Example

Customer:
What are your working hours?

Meta Business Agent:
We are open Saturday to Thursday from 9:00 AM to 6:00 PM. If you need help outside working hours, you can leave your message here and our team will follow up.

2. How Meta Business Agent Fits Into WhatsApp Business

To understand Meta Business Agent, it helps to understand the main WhatsApp Business Platform building blocks.

Technical Structure

Meta Business Portfolio
        |
        v
WhatsApp Business Account, WABA
        |
        v
WhatsApp Business Phone Number
        |
        v
Meta Business Agent
        |
        v
Knowledge, FAQs, Files, Websites, Skills, Settings, Events, Tests, Evaluations

In Meta documentation, the WhatsApp Business Platform is described as an API-based platform for businesses that communicate with customers at scale. It is different from the regular WhatsApp app and the WhatsApp Business mobile app. The platform is designed for integration with systems, automation, support tools, CRMs, and business workflows.

Plain-English Meaning of Important Meta Terms

3. Technical Dashboard Map

A complete Meta Business Agent management system usually has four main areas: Discover, Onboard, Configure, and Operate.

Dashboard Map Overview

1. Discover
   - Sync business accounts
   - Sync WhatsApp Business Accounts
   - Sync phone numbers
   - Review phone number quality and verification status

2. Onboard
   - Check agent eligibility
   - Start agent onboarding
   - Fetch current settings
   - Manage allowlist
   - Enable or disable rollout

3. Configure
   - Add business information
   - Add FAQs
   - Add websites
   - Upload knowledge files
   - Create skills and instructions
   - Configure connectors, if available

4. Operate
   - Run agent tests
   - Send business events
   - Run evaluations
   - Check event status
   - Pass or release thread control
   - Review logs and results

This map is useful because it separates setup into clear stages. Many businesses make the mistake of jumping directly to launch. A better approach is to discover assets first, onboard carefully, configure knowledge, then test and operate.

4. Discover: Finding Business Assets

Before configuring an agent, a system needs to know which Meta business assets are available. This usually means retrieving businesses, WhatsApp Business Accounts, and phone numbers.

Example: Retrieve WhatsApp Phone Numbers

GET https://graph.facebook.com/v21.0/{whatsapp-business-account-id}/phone_numbers
Authorization: Bearer {system-user-access-token}

In plain English, this request asks Meta:

“Show me the WhatsApp phone numbers connected to this WhatsApp Business Account.”

The response usually includes phone number IDs, display phone numbers, verified names, and quality ratings.

Why Phone Number ID Matters

In the Meta API, many actions are performed using the phone number ID, not just the visible phone number. For example, customers may see +1 555 123 4567, but the API may use an ID like 1906385232743451.

That ID becomes the technical target for configuring the agent.

5. Onboard: Preparing the Agent

Onboarding means checking whether a phone number can use Meta Business Agent and then creating or activating the agent configuration for that number.

Eligibility Check

GET https://api.facebook.com/{phone_number_id}/agent_eligibility
Authorization: Bearer {access_token}
X-API-Version: 2.0.0

Plain-English meaning:

“Is this WhatsApp phone number allowed to use Meta Business Agent?”

Start Onboarding

POST https://api.facebook.com/{phone_number_id}/agent_onboarding?channel=whatsapp
Authorization: Bearer {access_token}
X-API-Version: 2.0.0

Plain-English meaning:

“Create or start the AI business agent setup for this WhatsApp phone number.”

6. Configure: Teaching the Agent About the Business

Configuration is the most important part of the process. The agent can only be useful if it has accurate business information.

Configuration Map

Agent Configuration
   |
   |-- Business Info
   |-- FAQs
   |-- Websites
   |-- Knowledge Files
   |-- Skills
   |-- Settings
   |-- Allowlist
   |-- Handoff Rules
   |-- Follow-up Rules

7. Business Information

Business information contains stable facts about the company. This should be used for information that does not change every day.

Example Fields

• Business description
• Payment methods
• Return policy
• Purchase process
• Delivery and shipping information
• Contact email
• Hours of operation
• Address

Example API Request

PUT https://api.facebook.com/{phone_number_id}/agent_config/business_info
Authorization: Bearer {access_token}
X-API-Version: 2.0.0
Content-Type: application/json

{
  "business_description": "We provide WhatsApp Business API setup, automation, customer support, and messaging solutions.",
  "payment_method": "Customers can pay by bank transfer, cash, or approved online payment links.",
  "return_policy": "Refunds are reviewed according to the service agreement.",
  "purchase_info": "Customers can request a quote by sending their requirements through WhatsApp.",
  "delivery_and_shipping": "Digital services are delivered remotely after onboarding is completed.",
  "contact_email": "[email protected]",
  "hours_of_operation": "Saturday to Thursday, 9:00 AM to 6:00 PM",
  "address": "Business address here"
}

Plain-English meaning:

“Save these official business details so the agent can use them when answering customers.”

8. FAQs: Exact Answers for Common Questions

FAQs are best for questions that need direct and reliable answers. They are especially useful for pricing, policies, onboarding steps, requirements, and support instructions.

Example FAQ Request

POST https://api.facebook.com/{phone_number_id}/agent_config/faq
Authorization: Bearer {access_token}
X-API-Version: 2.0.0
Content-Type: application/json

{
  "question": "How long does onboarding take?",
  "answer": "Most onboarding requests are completed within 1 to 3 business days after all required documents and account details are ready.",
  "metadata": {
    "source": "official-business-faq"
  }
}

Plain-English meaning:

“When customers ask this question, use this answer as the trusted response.”

Good FAQ vs Weak FAQ

9. Website Knowledge

Website knowledge allows the agent to use information from business web pages. This is helpful when your website already contains product pages, service pages, pricing information, terms, or support content.

Example Website Request

POST https://api.facebook.com/{phone_number_id}/agent_config/websites
Authorization: Bearer {access_token}
X-API-Version: 2.0.0
Content-Type: application/json

{
  "url": "https://example.com/pricing"
}

Plain-English meaning:

“Use this web page as a knowledge source for the agent.”

Best Pages to Add

• Pricing pages
• FAQ pages
• Product pages
• Service pages
• Terms and policy pages
• Support documentation

Avoid adding outdated pages, temporary campaign pages, or pages with conflicting information.

10. Knowledge Files

Knowledge files are useful when business information exists in documents rather than web pages.

Useful File Types

• PDF catalogs
• DOCX service documents
• TXT knowledge files
• CSV price lists
• XLSX product sheets

Example File Upload Request

POST https://api.facebook.com/{phone_number_id}/agent_config/files
Authorization: Bearer {access_token}
X-API-Version: 2.0.0
Content-Type: multipart/form-data

file_name: services.pdf
file: services.pdf

Plain-English meaning:

“Upload this document so the agent can use it as a knowledge source.”

11. Skills: Controlling Agent Behavior

Skills are instructions that tell the agent how to behave in specific situations. Business information gives the agent facts. Skills give the agent behavior.

Example Skill Request

POST https://api.facebook.com/{phone_number_id}/agent_config/skills
Authorization: Bearer {access_token}
X-API-Version: 2.0.0
Content-Type: application/json

{
  "title": "pricing-questions",
  "description": "Use when customers ask about service pricing or quotes.",
  "skill": "Answer pricing questions clearly. Explain that final pricing depends on service type, country, volume, and setup requirements. If the customer wants an exact quote, ask for monthly volume, target country, and service type."
}

Plain-English meaning:

“When this type of situation happens, follow these instructions.”

Good Skill Categories

• Pricing questions
• Human handoff
• Complaint handling
• Order status questions
• Appointment booking
• Technical support
• Refund requests
• Lead qualification

12. Settings: Rollout, Audience, Handoff, and Follow-Up

Settings control how and when the agent is active.

Example Settings Request

PUT https://api.facebook.com/{phone_number_id}/agent_config/settings
Authorization: Bearer {access_token}
X-API-Version: 2.0.0
Content-Type: application/json

{
  "rollout": {
    "enabled": true
  },
  "ai_audience": "ALLOWLISTED_ONLY",
  "handoff": {
    "enabled": true,
    "message": "Connecting you to a human support agent."
  },
  "followup": {
    "enabled": true,
    "followup_interval_in_seconds": 900,
    "message": "Is there anything else I can help with?"
  }
}

Settings Explained

13. Allowlist: Safe Testing Before Launch

The allowlist is a controlled list of phone numbers that can test the agent before it is available to everyone.

Add a Test User

POST https://api.facebook.com/{phone_number_id}/agent_config/allowlist
Authorization: Bearer {access_token}
X-API-Version: 2.0.0
Content-Type: application/json

{
  "consumer_phone_number": "+9647700000000"
}

Plain-English meaning:

“Allow this customer phone number to test or access the agent.”

Phone numbers should normally be written in E.164 format, including the country code.

14. Operate: Testing, Events, Evaluations, and Thread Control

Operation begins after configuration. This is where teams test responses, trigger events, evaluate quality, and control live conversations.

Operation Map

Operate
   |
   |-- Agent Test
   |-- Agent Event
   |-- Event Status
   |-- Agent Evaluation
   |-- Thread Control
   |-- Logs and Monitoring

15. Agent Test

Agent testing lets teams send test messages without waiting for a real customer.

POST https://api.facebook.com/{phone_number_id}/agent_test
Authorization: Bearer {access_token}
X-API-Version: 2.0.0
Content-Type: application/json

{
  "user_msg": "What payment methods do you accept?",
  "conversation_id": "test-conversation-001"
}

Plain-English meaning:

“Pretend a customer asked this question and show me how the agent would reply.”

16. Agent Events

Agent events allow a business system to notify the agent that something happened. For example, an order was paid, a delivery was shipped, or an appointment was confirmed.

Example Event

POST https://api.facebook.com/{phone_number_id}/agent_event
Authorization: Bearer {access_token}
X-API-Version: 2.0.0
Content-Type: application/json

{
  "to": "+9647700000000",
  "event": {
    "type": "purchase_completed",
    "description": "Customer completed payment for order ORDER-1001",
    "payload": {
      "order_id": "ORDER-1001",
      "amount": "25.00",
      "currency": "USD",
      "status": "paid"
    }
  }
}

Plain-English meaning:

“Tell the agent that this customer completed a purchase, and provide the order details.”

17. Evaluations

Evaluations help teams measure answer quality. Instead of testing one message manually, evaluations allow repeated checks against predefined cases.

POST https://api.facebook.com/{phone_number_id}/agent-eval/run?eval_case_ids=case_123,case_456
Authorization: Bearer {access_token}
X-API-Version: 2.0.0
Content-Type: application/json

{}

Plain-English meaning:

“Run these test cases and report how well the agent performs.”

18. Thread Control

Thread control manages who is responsible for the conversation: the AI agent, another automation system, or a human support system.

Pass Conversation to Agent

POST https://api.facebook.com/business/whatsapp/phone_numbers/{phone_number_id}/thread_control
Authorization: Bearer {access_token}
X-API-Version: 1.0.0
Content-Type: application/json

{
  "messaging_product": "whatsapp",
  "action": "pass",
  "to": "+9647700000000"
}

Release Conversation Control

POST https://api.facebook.com/business/whatsapp/phone_numbers/{phone_number_id}/thread_control
Authorization: Bearer {access_token}
X-API-Version: 1.0.0
Content-Type: application/json

{
  "messaging_product": "whatsapp",
  "action": "release",
  "to": "+9647700000000"
}

Plain-English meaning:

“Give the conversation to the agent” or “release the conversation so another system or person can handle it.”

19. Recommended Launch Workflow

Businesses should not launch an AI agent without testing. A safe rollout process is:

1. Connect the business account and WhatsApp phone number.
2. Check agent eligibility.
3. Start onboarding.
4. Add business information.
5. Add FAQs.
6. Add important website links.
7. Upload accurate files.
8. Create focused skills.
9. Set audience to allowlisted users only.
10. Add internal testers to the allowlist.
11. Run test messages.
12. Run evaluation cases.
13. Fix bad or unclear answers.
14. Enable rollout for a small audience.
15. Monitor conversations and logs.
16. Launch to everyone only when answers are reliable.

20. Sample Test Requests

These sample messages help test whether the agent is configured correctly.

Business Information

What does your company do?

Where are you located?

What are your working hours?

Pricing

How much does your service cost?

Can I get a custom quote?

Do you have monthly plans?

Purchasing

How can I place an order?

What payment methods do you accept?

Can I pay by bank transfer?

Support

I paid but did not receive confirmation.

I need help with my order.

Can I speak with a human?

Policy

What is your refund policy?

Can I cancel my order?

How long does delivery take?

21. Common Technical Mistakes

• Using an expired or incorrect access token.
• Using the visible phone number instead of the phone number ID.
• Forgetting required permissions for WhatsApp Business Management.
• Launching with EVERYONE before testing with an allowlist.
• Adding outdated website pages as knowledge sources.
• Uploading files with conflicting prices or policies.
• Writing vague FAQs that do not answer the actual question.
• Not configuring human handoff.
• Not reviewing failed API responses or logs.

22. Best Practices for High-Quality Answers

• Use FAQs for exact answers.
• Use business info for stable company details.
• Use files for long documents and catalogs.
• Use websites only when pages are accurate and updated.
• Use skills to control tone and behavior.
• Keep answers short and clear.
• Tell the agent what to do when it does not know.
• Always provide a path to human support.
• Test after every major configuration change.

23. Example of a Good Agent Response

Customer:

How can I get pricing?

Good Agent Answer:

To prepare an accurate quote, please share the service you need, your expected monthly volume, and your target country. Once we have those details, our team can provide the correct pricing and setup requirements.

This is a good response because it does not guess. It explains what information is needed and moves the customer toward the next step.

24. Security and Privacy Considerations

Meta Business Agent should be configured carefully because it may interact with real customers and business data.

• Never expose access tokens publicly.
• Use secure server-side API calls.
• Limit dashboard or admin access to trusted users.
• Do not upload sensitive internal documents unless they are intended for customer-facing answers.
• Do not let the agent provide legal, financial, or medical advice unless properly controlled and reviewed.
• Review Meta and WhatsApp policies before launch.
• Use human handoff for sensitive or account-specific cases.

25. Who Should Use Meta Business Agent?

Meta Business Agent is useful for businesses that receive repeated customer questions through WhatsApp or Meta messaging channels.

• E-commerce stores
• Service providers
• Clinics and appointment-based businesses
• Delivery companies
• Education centers
• Travel agencies
• Real estate companies
• Customer support teams
• WhatsApp Business API providers

26. Final Summary

Meta Business Agent is not just a simple chatbot. It is a configurable AI business assistant that can understand business information, answer customer questions, follow instructions, use knowledge sources, respond to events, and support human handoff.

The most important part is configuration quality. A well-configured agent can improve customer response time, reduce repetitive support work, and create a better WhatsApp experience. A poorly configured agent can confuse customers, give incomplete answers, or create extra work for the support team.

The best approach is simple: start with accurate business information, add strong FAQs, connect reliable knowledge sources, create focused skills, test with an allowlist, review results, and launch gradually.

Official Meta References

• WhatsApp Business Platform Overview
• WhatsApp Business Management API: Retrieve Phone Numbers
• Meta WhatsApp Business Platform Documentation