A WhatsApp chatbot helps when it completes a defined customer task, preserves context, and knows when to give the conversation to a person. It does not need to pretend to be a human or answer every question. For a small business, a reliable first flow might identify a service request, collect the minimum details, create a CRM record, and tell the customer when staff will respond. This guide explains how to design, connect, test, and supervise such a flow before expanding it.

What counts as a WhatsApp chatbot?

A chatbot is a set of rules, menus, or AI responses that conducts part of a conversation. It may provide an approved answer, collect information, look up an authorized status, or route a case. A greeting or quick reply in the WhatsApp Business App is useful automation, but it is not the same as a bot that handles a multi-step task. An AI model adds language flexibility; it does not remove the need for rules, data ownership, and human review.

The business should define an observable finish line. “Answer customers with AI” is too broad. “Collect a quote request for website maintenance, check required fields, create one lead record, and assign it to a specialist” can be tested. The narrower definition makes failure visible and keeps the first version maintainable.

Choose a supported connection

RouteTypical roleWhat to check
WhatsApp Business AppNative greeting, away message, and quick repliesManual ownership and limited integration
Official Business PlatformAPI-backed messaging and system integrationEligibility, templates, pricing, provider, and policy
WhatsApp Web session automationThird-party session controlTerms, reliability, account risk, and support

For an operation that depends on the number, start with Meta’s Business Messaging Policy and official platform documentation. A QR-code bridge can appear cheap while depending on a web session and carrying policy or continuity risk. Do not assume that a project called an “API” is Meta’s official API. Confirm which transport mode and authorization a proposed connector actually uses.

1. Define one task the bot should finish

Look at recent conversations. Group them into information requests, appointments, quotes, order status, support, complaints, and sensitive issues. Choose a repeated, low-risk task with a clear answer or output. Write a one-sentence acceptance criterion and name the system where the result must appear. For a quote request, the output may be a lead with service, city, brief, and owner.

Set what the bot must not do. It should not invent prices, promise appointments it cannot reserve, change an order without authorization, or handle a clinical or legal decision. A customer asking for a person should have a short route to one. The limit is part of the design, not an embarrassing exception.

2. Map the conversation before choosing a platform

Draw the entry point, first question, needed data, approved response, possible branch, human transfer, and resolution. Include failure states: missing answer, invalid phone, duplicate contact, unavailable calendar, API timeout, and after-hours message. Decide what the customer sees and what staff see in each case.

Keep the number of questions small. If a person only wants the office address, do not force them through a qualification form. If a quote needs three facts, collect those and stop. The conversation should adapt to what the customer already provided. Test whether a customer can change topic without being trapped in the original menu.

3. Select integrations by the workflow

Typebot can provide a structured conversational form; Manychat is a platform with channel connection and flow tools; n8n can orchestrate system steps; and Evolution API is an open-source integration project with multiple transport possibilities. They play different roles. Manychat’s current connection guide says WhatsApp number connection requires a paid plan, so a free Manychat account is not proof of a free WhatsApp operation.

The Evolution API repository describes the project, but its use does not by itself establish that your setup uses Meta’s official Business Platform. Verify its selected mode, provider terms, hosting, maintenance, and account risk before using it for a commercial number. n8n is an orchestrator, not a substitute for a supported messaging connection.

Map credentials and owners. The WhatsApp account, integration service, CRM, and knowledge base may have different administrators. Keep API keys in a secrets manager, restrict permissions, and document how the team can pause a workflow. Test recovery from a provider outage before telling customers the system is always available.

4. Prepare a trustworthy knowledge base

Collect approved answers about services, hours, location, pricing rules, support process, and exclusions. Give each document an owner, version, and review date. Remove expired offers and duplicated policy files. A retrieval system that sees two contradictory versions may return the wrong one even when the model writes fluent prose.

Use direct answers for stable facts and links to maintained pages for details that change. If the source does not answer a question, say what is known and route the case. Do not let the bot fill gaps with plausible promises. Test paraphrases, misspellings, and two similar services to see whether the right source is used.

When an answer requires a CRM lookup, separate public policy from private account data. Verify the customer’s identity and authorization before returning a personal order or billing status. Log the lookup purpose and minimize what is shown in a chat.

5. Design the transfer to a human

Transfer on an explicit request, a complaint, repeated failure, an unapproved topic, uncertain account match, or an action needing authorization. The bot should stop proposing answers after transfer. Create a case with the customer’s request, relevant prior answers, identifiers, and last action. Assign it to a monitored queue and state a realistic reply expectation.

A queue entry is not the same as a person accepting the case. Track assignment, acceptance, first reply, and resolution. Staff should be able to inspect the source conversation and correct a bad summary. During an outage or outside staffed hours, tell the truth about availability and preserve the request for follow-up.

6. Respect messaging rules and consent

Meta’s Business Messaging Policy sets requirements for quality, business identity, and authorized messaging. The current pricing page distinguishes message categories and no-charge cases. Templates, service windows, and market rates should be checked in the official console for the specific campaign. Do not assume that an inbound conversation authorizes unrelated promotional messages.

Store the customer’s communication preference and opt-out status where the workflow can actually use it. Prevent a marketing follow-up from firing after a person opts out or a case closes. Review business hours and time zones before scheduling messages. A technically valid API call can still create a poor or noncompliant experience.

7. Collect less data and control access

Ask only for fields the task needs. A quote request may need a name, contact route, service, and short description. Do not gather identification documents, medical history, or payment details through a generic flow for convenience. Map each field to its destination, purpose, staff role, and retention period. Remove unnecessary data from model prompts and logs.

Keep test data fictional. Encrypt or protect stored conversation records according to the system’s role. Review vendor contracts and subprocessors where customer data moves. Provide staff with access appropriate to their job, not administrator rights simply because the bot uses an integration account.

8. Test the whole flow, including exceptions

Create a small acceptance set before a live rollout. Include a simple question with an approved answer, a quote request, an existing customer, a repeated message, a request for a person, an ambiguous subject, and a service outage. Verify what the customer sees, which record is created, whether an owner is assigned, and what the staff can do next. Do not call the bot complete because its first greeting works.

Test the same customer through two entry points. A visitor may fill a site form and then send a WhatsApp message. Decide how the CRM matches them without merging unrelated people. If a lookup times out, retry safely and show the case in an exception queue. Duplicate webhooks, delays, and messages arriving out of order are normal engineering cases, not rare surprises.

Check the link between the bot and the live system. If it offers an appointment, confirm the slot in the actual calendar. If it says a quote request was received, confirm a CRM record with the correct details and owner. If it hands off, confirm a staff member can see and accept the conversation. A response in a testing console is not evidence of business delivery.

9. Measure resolution and staff effort

Track correct resolution, handoff rate, time to first useful response, wait for a human, repeat contacts, abandonment, complaints, and staff correction time. A high percentage of conversations “handled by the bot” can hide people who gave up. Sample complete chats and ask whether the customer’s original task was actually finished.

Compare similar request types and periods. A bot answering office hours should not be judged by the same criteria as an agent handling billing disputes. Record maintenance effort: updating policy documents, reviewing errors, and fixing integrations costs staff time. Do not promise savings from fewer messages until the complete process is measured.

A simple architecture for a first project

A useful starting design has a supported WhatsApp connection, an intake webhook or platform flow, a small approved knowledge base, a CRM record, and a human queue. One component receives the message, checks customer and conversation IDs, chooses a bounded path, writes the result once, and records status. Staff can override or pause the path. Monitoring flags failed messages and unowned cases.

Keep the architecture as small as the chosen task. A business that only needs appointment requests may not need a vector database or autonomous agent. A rules-based form with a calendar check and staff handoff can be easier to audit. Add AI when it demonstrably handles varied language or summarization better than simpler routing without increasing errors or maintenance beyond the benefit.

Document the boundaries: the messaging platform carries the conversation, the CRM owns customer and case status, the calendar owns availability, the knowledge base owns approved facts, and staff own exceptions. This prevents the bot’s memory from becoming an undocumented second source of truth.

Give staff a runbook, not just a dashboard

Write a short procedure for opening a case, taking ownership, correcting a wrong answer, changing a knowledge-base fact, pausing the bot, and escalating an integration failure. Name who monitors the queue on weekdays and outside normal hours. If an operator cannot tell whether a case was accepted or merely created, the technical dashboard is not enough. Give staff a safe way to mark a conversation resolved and to reopen it when the customer replies.

Keep an audit record of major configuration changes: which rule changed, who approved it, when it became active, and which test cases passed. The team should know how to return to a previous working version without reactivating an unsafe connection. Rotate access when a vendor or employee leaves. An automation that no one can supervise is a fragile part of customer service.

Review accessibility and language too. A customer may use voice notes, short messages, or a language the bot handles poorly. Define whether the system can process those formats and route unsupported input to a person. Do not silently discard a voice note because the first version only handles text. Tell the customer what the channel can do and preserve a human alternative.

Example: connect an intake flow to n8n and staff

Imagine a small web agency asking a prospect which service they need, where the business operates, and when they hope to start. The supported WhatsApp connector passes an event to n8n. The workflow validates fields, matches an existing CRM contact, creates or updates one opportunity, and assigns it to a staff member. The prospect receives an acknowledgment with actual business hours. No price or start date is promised automatically.

On the next message, the workflow retrieves the existing opportunity instead of creating another. If the customer asks about a specific quote, staff receives the case with the original brief and prior answer. If CRM access fails, the event enters a retry queue with a stable ID. Staff see the error; the bot does not claim that a proposal is being prepared when the record never arrived.

Evolution API can be part of a prototype in a selected mode, but the repository name alone does not establish a compliant commercial connection. If the business number is critical, confirm the actual transport and platform policy with the provider. The example describes a design pattern, not a claim that a particular installation was tested or that every vendor offers the same features.

Where can savings appear?

Time may be recovered when staff no longer copy form data into a CRM, answer the same approved question, or search several inboxes for context. A shorter response can prevent a lead from waiting overnight. But each benefit is conditional. The business may spend new time maintaining sources, correcting classifications, or troubleshooting integrations. Count those costs.

Measure a baseline before launch: average response time, number of requests per category, manual steps, errors, and unresolved cases. Run a limited pilot and compare the same measures. If the flow only moves work to a different screen, simplify it. Do not call a sample with a few easy conversations a universal productivity benchmark.

Common mistakes when building a WhatsApp chatbot

Starting with a platform demo instead of a customer task: the team buys features but cannot say what completion looks like. Write the acceptance criterion first.

Hiding the person: the bot keeps offering menu choices after a complaint. Add explicit transfer triggers and verify an agent accepts the case.

Using outdated answers: the bot quotes a retired offer or policy. Assign document owners and remove superseded versions from retrieval.

Collecting more data than needed: a long intake form increases abandonment and exposure. Ask only what the task requires.

Ignoring duplicates and failures: webhook retries create repeated contacts or messages. Use stable identifiers, idempotent writes, monitoring, and a visible exception queue.

Confusing a third-party session with Meta’s platform: a connector label does not prove official access. Verify the actual transport and commercial support.

Measuring only bot containment: a customer who leaves without help can appear “resolved.” Read complete conversations and check real outcomes.

Frequently asked questions

Do I need AI? Not necessarily. A structured menu, approved answers, CRM lookup, and human queue may solve the first use case more reliably. Use AI where language variability or summarization creates a measured benefit.

Can I build a WhatsApp bot for free? The Business App has basic free tools; full integrations can involve Meta message charges, platform subscriptions, hosting, development, and support. Check the current plan and rate card for the intended market.

Can the bot message any contact? Follow Meta’s current policy, consent, template, and conversation rules. Having a phone number in the CRM is not permission for any automated campaign.

When should the bot transfer? On request, uncertainty, repeated failure, complaints, sensitive topics, or actions requiring authorization. The team should be able to adjust these triggers from observed cases.

How do we stop wrong answers? Use a maintained knowledge base, narrow scope, source checks, negative tests, human escalation, and regular conversation review. No prompt alone guarantees correctness.

Start with a flow your team can supervise

Build one customer journey, connect it through an authorized channel, and verify the outcome in the systems staff use. Let a person take over quickly and keep the context intact. Expand only after the first flow works through common requests, exceptions, and outages. The next step may be native Business App settings for a solo owner, a shared inbox for a small team, or the official platform with CRM and automation for a larger operation. Choose by the task, not by the promise of an all-knowing chatbot.

Sources and references