> ## Documentation Index
> Fetch the complete documentation index at: https://docs.satyakod.com/llms.txt
> Use this file to discover all available pages before exploring further.

# WhatsApp verify bot

> Let people check a code by sending it to your WhatsApp Business number.

People send your WhatsApp Business number a code, the 16-character serial or a verify link, and
get the verdict back in seconds:

> ✅ Genuine: Brake pad set BP-220 · Batch B-1045, Lot A2410\
>
> This code was issued by Acme Auto Parts and passed every check.

Other replies are **Check this one** (suspicious) and **Not genuine** (counterfeit), with the
same plain-language reason as the [scan page](https://docs.satyakod.com/guides/consumer-scan-page.md). Anything else gets a
short help message. Every check counts as a scan on the WhatsApp channel, so it feeds
[Scans](https://docs.satyakod.com/guides/overview-and-scans.md) and [alerts](https://docs.satyakod.com/guides/alerts.md).

## Languages

The bot answers in the scan page's eight languages. WhatsApp doesn't tell Satyakod the sender's
phone language, so the bot goes by the message: one written in Hindi, Marathi, Gujarati, Bengali,
Tamil, Telugu or Kannada script is answered in that language, one in English words in English.
Sending just a language's name (*Tamil* or *தமிழ்*) switches to it. A bare code or link is
answered in the sender's last language, or for someone new in the scan page's **Default
language** (**Settings → Scan page**), else English.

## Connect your number

You need a WhatsApp Business number on Meta's WhatsApp Cloud API, in your own Meta app.

**1. Copy the details from Meta**

In your Meta app: **WhatsApp → API setup** gives the **Phone number ID** and an
**access token** (use a permanent system-user token); **App settings → Basic** gives the
**App secret**.

**2. Enter them in Satyakod**

**Settings → Integrations → WhatsApp Business → Connect** (admins). Satyakod checks the token
with Meta when you save. Tokens and secrets are stored encrypted.

**3. Point Meta's webhook at Satyakod**

Satyakod then shows a **Callback URL** and a **Verify token**. In Meta, open
**WhatsApp → Configuration → Webhook**, enter both, and subscribe to **messages**.

**4. Test it**

Send a serial from any phone to your number.

A number can be connected to one workspace only.

The bot is separate from WhatsApp notifications (alerts, distributor notices and trade sign-in
codes), which we set up with you at onboarding: see [Notifications](https://docs.satyakod.com/concepts/notifications.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.