Skip to main content
The nao WhatsApp bot brings your analytics agent directly into WhatsApp, allowing your team to ask questions and get insights without leaving their workspace.
nao WhatsApp Bot Interface
When configured, the nao WhatsApp bot:
  • Responds to messages in WhatsApp conversations and group chats
  • Processes questions using the same agent as the web chat interface
  • Returns answers with SQL queries, data tables, and visualizations
  • Maintains conversation context within threads
The WhatsApp bot uses the same agent context, rules, and capabilities as your web chat interface. Any improvements to your agent automatically benefit WhatsApp users.

​
Setup

​
Step 1: Create a Meta App

  1. Go to developers.facebook.com/apps
  2. Click “Create App”
  3. Fill in your app name and contact email
  4. Select “WhatsApp” as the use case
  5. Link a business portfolio to the app
  6. Click “Review and Create”

​
Step 2: Open the WhatsApp Integration in nao

  1. In nao, click on your profile → “Project” → “WhatsApp”
  2. Keep this page open — you will paste your credentials here in the next steps

​
Step 3: Get App Credentials

  1. From your app dashboard, click “Personalize WhatsApp”
  2. Go to “API Configuration”
  3. Click “Generate access token” — copy it and paste it as Access Token in nao
  4. Copy the Phone Number ID and paste it in nao
The default access token expires in 24 hours. For production, generate a permanent System User Token via Meta Business Settings.
  1. Go to App Settings → “General”
  2. Copy the Secret Key and paste it as App Secret in nao
  3. In nao, fill in a Verify Token of your choice, then click “Save”

​
Step 4: Configure the Webhook

  1. Go back to “Personalize WhatsApp” → “Configuration”
  2. Paste the Webhook URL and Verify Token from nao, then click “Verify and Save”
  3. Subscribe to the messages webhook field
  4. Open WhatsApp and send /login <linking_code> to your bot’s phone number — you can find your Linking Code in the project settings page

​
Usage

Ask Questions Message the bot directly: 
What were our top 5 products by revenue last month?
The bot will:
  1. Process your question using the same agent as the web interface
  2. Generate SQL queries based on your context
  3. Execute queries against your connected databases
  4. Return results in a formatted WhatsApp message
  5. Send you the link to the full conversation to open it in the browser UI
Thread Conversations Follow-up questions maintain context within the same conversation: 
What were our top 5 products by revenue last month?
# ... bot responds ...

Can you break that down by region?
# ... bot responds with regional breakdown ...
What’s Next?

Chat Overview

Learn about the web chat interface

Self-Hosting Guide

Deploy nao with Docker or on your own Cloud Run instance