DocumentationWhatsApp & 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.