Documentation WhatsApp & Bot

How the bot works

What happens under the hood when a customer messages your WhatsApp number.

The flow

  1. Message received: a customer texts your connected WhatsApp number. Meta's Cloud API forwards it to Gravote's webhook.
  2. Intent detection: Gravote analyses the message and identifies what the customer wants: a new order, a price query, payment confirmation, or something else.
  3. Action taken: if it's an order, Gravote logs it in your dashboard and stores the customer record. If it's a price query, it looks up your product list.
  4. Reply sent: the bot replies to the customer naturally, in English or Nigerian Pidgin depending on how they wrote.
  5. You're notified: for new orders, Gravote sends you a WhatsApp summary to your owner number.

What the bot knows

The bot only knows what you've told Gravote: your product names and prices, and any optional description. It will not invent information. If a customer asks something outside the product catalogue, the bot politely says the shop owner will follow up.

White-label by default

The bot never mentions Gravote to customers. It presents itself as your shop's assistant. You can give it a name (e.g. "Ada") in Settings, and that name appears in the bot's replies.

Owner vs customer

The bot recognises you as the owner by your phone number, the one you registered with. Messages from that number are treated as management commands, not customer orders. Any other number is treated as a customer.