Build a WhatsApp Chatbot for a Nigerian Business: Developer Guide

Walk into any Nigerian business and ask how they communicate with customers. The answer is WhatsApp. Restaurants take orders on WhatsApp. Tailors schedule fittings on WhatsApp. Real estate agents share property listings on WhatsApp. Schools send updates on WhatsApp. The platform is not just a messaging app in Nigeria. It is the primary business communication channel.

The problem: most of this communication is manual. A restaurant owner in Lagos spends hours every day replying to the same messages: "What's on your menu?", "Do you deliver to Lekki?", "How much is jollof rice?" Every reply is typed by hand. Every order is tracked in a notebook or a WhatsApp group.

This is the opportunity. A developer who can automate even the basic parts of this workflow creates immediate, visible value. A chatbot that sends the menu, confirms the order, provides a Paystack payment link, and notifies the kitchen saves hours of manual work daily. The business owner understands the value because they feel the pain every day.

For your career, WhatsApp chatbot development is a differentiator. Most bootcamp graduates can build a React app. Very few can build a working WhatsApp automation. Nigerian businesses will pay for this skill because the ROI is obvious and immediate.

A WhatsApp chatbot is not a standalone app. It is a server that receives messages from WhatsApp, processes them, and sends responses back. Here is the flow:

1. A customer sends a message to the business's WhatsApp number
2. WhatsApp forwards the message to your server via a webhook (an HTTP POST request to your URL)
3. Your server reads the message, decides what to do (using code logic), and sends a response back via the WhatsApp API
4. The customer sees the response in their WhatsApp chat

The components you need:

• WhatsApp Business API access. You apply through Meta's Cloud API (free tier available). This gives you the ability to send and receive messages programmatically.
• A web server. Node.js with Express is the most common choice. This server listens for incoming messages and sends responses.
• Webhook endpoint. A URL on your server that WhatsApp sends messages to. Needs to be publicly accessible (deployed, not localhost).
• Business logic. The code that decides what to reply. This can be simple (keyword matching) or complex (AI-powered conversation).
• Optional: Database. To store orders, customer information, or conversation history.
• Optional: Payment integration. Paystack payment links sent directly in the chat for order payment.

Step 1: Create a Meta Developer account

Go to developers.facebook.com and create an account. This is free. You need a Facebook account (personal is fine).

Step 2: Create an app and add WhatsApp

In the Meta Developer dashboard, create a new app (type: Business). Add the WhatsApp product. Meta will provide you with a test phone number and temporary access tokens.

Step 3: Configure your webhook

You need a publicly accessible URL for WhatsApp to send messages to. During development, use ngrok (a tool that exposes your localhost to the internet). For production, deploy your Node.js server to Railway, Render, or a similar platform.

Step 4: Verify your webhook

WhatsApp sends a verification request to your webhook URL. Your server needs to respond correctly to this challenge. The Meta documentation provides the exact verification logic.

Step 5: Send a test message

Using the Meta dashboard, send a test message to your own WhatsApp number. Then have your server respond automatically. When you see the automated reply in your WhatsApp, the basic pipeline is working.

The setup takes 1 to 2 hours if you follow the documentation carefully. Most of the time is spent on Meta's dashboard configuration, not on writing code.

Let us build a specific, useful chatbot: an order-taking bot for a Nigerian restaurant.

The conversation flow:

1. Customer sends "Hi" or any greeting
2. Bot responds with a welcome message and the menu (as a numbered list with NGN prices)
3. Customer replies with a number (e.g., "1" for Jollof Rice)
4. Bot confirms the item and asks for quantity
5. Customer provides quantity
6. Bot asks if they want to add more items or checkout
7. On checkout, bot sends the total in NGN and a Paystack payment link
8. After payment confirmation, bot sends an order receipt with estimated delivery time

Implementation approach:

• Store conversation state per user (using their phone number as the key). This tracks where each customer is in the ordering flow.
• Use a simple state machine: GREETING > MENU_SHOWN > SELECTING_ITEMS > CHECKOUT > PAYMENT_SENT > ORDER_CONFIRMED.
• Parse incoming messages: if the user is at MENU_SHOWN state and sends "1", add item 1 to their order.
• For Paystack integration: generate a payment link using Paystack's API and send it in the WhatsApp message. When payment is confirmed via Paystack webhook, update the order status.

This is not a toy project. This is a real system that Nigerian restaurants would pay money for. Building it teaches you APIs, state management, webhooks, payment integration, and server-side logic all in one project.

Restaurants are just the beginning. WhatsApp automation applies to dozens of Nigerian business types:

• Appointment booking: Barber shops, salons, clinics. Customer selects a service, picks a date and time, receives a confirmation. Reduces phone calls by 80%.
• Order status tracking: E-commerce or logistics companies. Customer sends their order number, bot replies with current status (processing, shipped, out for delivery, delivered).
• Customer FAQ automation: Any business. The bot answers the 10 most common questions (pricing, location, hours, delivery areas) instantly, freeing the business owner from repetitive replies.
• School communication: Exam results, fee reminders, event announcements sent automatically to parents. Reduces the school admin's WhatsApp workload significantly.
• Real estate listings: Customer specifies budget and location preference, bot sends matching properties with images and prices.

Each of these is a potential freelance project or product opportunity. A Nigerian developer who can build WhatsApp automations has a direct line to business revenue that most developers do not.

Start with the simplest version: a bot that receives a message and sends back a fixed menu. Do not try to build the full ordering system on day one. Get the basic message-in, message-out pipeline working first, then add features one by one.

Prerequisites:

• JavaScript/Node.js fundamentals (see our JavaScript guide)
• Basic Express.js knowledge (building a simple server with routes)
• A GitHub account and basic Git skills (see our Git guide)

If you are still building your JavaScript foundation, that comes first. This project requires intermediate skills. But keep it as a goal. It is one of the strongest portfolio projects you can have as a Nigerian developer.

For structured learning that takes you from JavaScript basics through server-side development and API integration, create a free McTaba Academy account and explore the full-stack curriculum.