WhatsRB separates customer communication from business logic:
- Your code receives structured webhooks (orders, support tickets, bookings) and acts on them
- Your team uses the Widget to read and reply to WhatsApp conversations directly from your website
No need to build a messaging UI. Drop the Widget on your internal dashboard, admin panel, or support page — your team gets a real-time WhatsApp inbox, and your backend stays focused on what matters.
Installation
Add the script tag to your page and initialize:
The widget appears as a floating button in the bottom-right corner.
Get an embed token
- Go to the WhatsRB Dashboard
- Navigate to Embed Tokens
- Create a token — optionally restrict it to a specific origin (e.g.
https://yourdomain.com)
Embed tokens are meant for browser use. They have limited permissions (read conversations, send messages) and cannot access your API keys, agents, or billing.
Configuration
Floating mode (default)
When no container is provided, the widget renders as a floating button with a slide-up panel. Clicking outside closes it.
Embedded mode
Pass a container CSS selector to mount the widget inside a specific element:
Themes
Features
Conversations
- Browse all WhatsApp conversations
- View full message history with delivery statuses (sent, delivered, read, failed)
- Send text messages and WhatsApp templates (with variables)
- Start new conversations
AI suggestions
If an AI agent is active on a conversation, the widget displays suggested replies in real-time. Your team can accept, dismiss, or write their own response.
Real-time updates
The widget uses Server-Sent Events (SSE) for instant updates:
- New messages appear immediately
- Delivery status changes update in real-time
- AI suggestions pop up as soon as the agent completes
If SSE is unavailable (firewall, proxy), the widget falls back to polling automatically.
Origin restriction
For security, you can restrict an embed token to a specific origin. The widget will only work on pages served from that origin.
If no origin is set, the token works from any domain — useful for development, but not recommended for production.
Action confirmation
When an agent has confirmation_mode: "confirm", the widget automatically adapts its behavior:
- Instead of showing read-only action chips, the widget displays Accept and Reject buttons for each proposed action
- Your team can review AI-proposed actions and decide individually
- Once all actions are decided, a
agent_run.actioned webhook is sent
No widget configuration is needed — the behavior is driven entirely by the agent’s confirmation_mode setting. See Action Confirmation for the full guide.
Cleanup
WhatsRB.init() returns a destroy function: