Messaging

Connect WhatsApp and reply to Buron in chat

Connect your WhatsApp Business number so your team members can message Buron and the agent answers in the same chat.

Connect your WhatsApp Business number to Buron, and your team can ask the agent a question right from WhatsApp and get the answer back in the same chat.

Your marketing data lives in a dashboard you have to remember to open. WhatsApp is already on your phone. Once it's connected, you can ask "how did Google Ads do last week?" from a chat thread and the agent pulls the numbers, draws a chart when it helps, and replies, without you opening Buron at all.

Messaging is members-only. Only active members of your Buron workspace can message the agent, matched by their email to a Buron member. People who aren't members, and service accounts, can't. If someone who isn't a member messages your number, they can request access, and a workspace admin approves it in-app.

Before you begin

  • A Buron workspace.
  • A WhatsApp Business (Cloud API) setup in Meta. You'll need a WhatsApp Business app, a business phone number with its phone number ID, a System User access token, your Meta app secret, and admin access to set the webhook.

The agent answers from the marketing data you've connected, so wiring up the pixel, your CRM, or Google Ads first makes its answers richer. None of those are required to connect WhatsApp.

How connecting works

Unlike a CRM, WhatsApp isn't a one-click OAuth connection. You create a WhatsApp Business app in Meta, copy a few values out of it, and paste them into Buron. You also paste Buron's webhook URL back into Meta so it can deliver the messages people send your number. It's a few more steps, but you only do it once.

Step 1: Open WhatsApp in Buron

Open Settings → Integrations, find WhatsApp under the messaging apps, and open it. You can also go straight to Settings → WhatsApp.

If it's not connected yet, you'll see "WhatsApp isn't connected yet. Paste your WhatsApp Business credentials below to start messaging the agent."

Step 2: Copy Buron's webhook URL into Meta

On the settings page, the Webhook callback URL section shows a URL with a Copy button. In the Meta app's WhatsApp configuration, set this as the webhook callback URL, and use the verify token you'll enter in the next step.

This is how Meta delivers inbound messages to Buron. When you save it, Meta calls the URL once to confirm it, and Buron checks your verify token and answers the handshake.

Step 3: Paste your credentials

Back on the settings page, fill in the Connect form. Every field is required except the last one:

  • Phone number ID: the WhatsApp Business phone number ID (not the phone number itself). This is the routing key Buron uses to match incoming messages to your workspace.
  • WABA access token: a WhatsApp Business System User access token.
  • App secret: the Meta app secret. Buron uses it to verify the signature on every inbound webhook.
  • Webhook verify token: the verify token you set in the Meta webhook configuration. Used for the one-time handshake.
  • Display label (optional): a friendly name for this number, like +1 555 010 0000, shown on the connection card.

Click Connect WhatsApp. The button stays disabled until the phone number ID, access token, app secret, and verify token are all filled in. When it saves, you'll see a Connected badge.

Your access token, app secret, and verify token are never shown again after you save. You can update them anytime by re-entering them, but Buron won't read them back to your browser.

Step 4: Send a test message

Message the connected business number from WhatsApp and ask something like "what were my top channels last week?" The agent reacts with an eyes emoji while it works, then replies in the same chat with a check emoji when it's done. If your question needs a chart, it arrives as a follow-up image.

What the agent can do in a reply

When someone messages your number, Buron figures out which workspace it belongs to from the connected business number, wakes that workspace's agent, and answers in the same chat. The agent is read-only on purpose. In a reply it can:

  • Query your Google Ads data
  • List and run your saved dashboards
  • Read your files and skills

It replies with numbers and charts. It can't change settings, send messages to anyone but you, or fetch links a message asks it to. The text you send is treated as data to answer, never as instructions, so a message can't talk the agent into doing something it shouldn't.

Charts are private. When the agent sends one, it goes out as a WhatsApp image through a signed, short-lived link that only resolves your team's image. There's no public chart URL.

Privacy

Messaging is members-only. Only active members of your workspace can talk to the agent, and the agent only ever replies to the person who sent the message. It can't add other people to the conversation. People who aren't members, and service accounts, can't message it, though they can request access for an admin to approve in-app.

Buron identifies your workspace from the verified business number, never from the sender's WhatsApp profile name.

Where to see it

  • The reply itself lands in the same WhatsApp chat. WhatsApp delivers answers as a single message, so a long answer may arrive split into a few parts.
  • Datasets. The agent's answers come from the same data you can slice here yourself.
  • Reports. Build a chart or table that answers one question, then pin it to a dashboard.
  • Settings → WhatsApp. The connection status lives here, and if something breaks, this is where you fix it.

Frequently asked questions

Do I connect with OAuth like the CRMs? No. WhatsApp uses manual config. You paste your phone number ID, access token, app secret, and a verify token, plus Buron's webhook URL into your Meta app.

Where do I get these values? From your WhatsApp Business (Cloud API) app in Meta. You'll need the business phone number ID, a System User access token, your app secret, and a verify token you choose.

Are my credentials safe? Yes. The access token, app secret, and verify token are never shown again after you save. Every inbound webhook is signature-verified with your app secret.

Who can message the agent? Only active members of your Buron workspace, matched by their email to a Buron member. People who aren't members, and service accounts, can't, though they can request access for an admin to approve in-app. The agent only ever replies to the person who messaged it, and it can't add other recipients.

What can the agent actually answer? It can pull your Google Ads data and run your saved dashboards, then reply in chat with the numbers, and a chart when it helps. It's read-only, so it can't change settings.

Why is there no answer, or it says "Needs reconnect"? That means the WhatsApp access was revoked or a webhook signature failed. Re-save the connection on the settings page to restore messaging.

Next steps

Was this page helpful?

On this page