Skip to main content
The Brosbots Voice Agent plugin does what the web widget does, without pasting anything into a theme. One click, sign in to Brosbots, pick an agent, and you are back on your site with the widget live. The agent, its prompt, voice and knowledge base stay in the Brosbots panel. The plugin duplicates none of it: it only decides where the widget shows and what the agent knows about the visitor.

​
Installation

1

Download the plugin

In the Brosbots panel: Integrations → the WordPress tile → Download the plugin (.zip).
2

Install it

In WordPress: Plugins → Add New → Upload Plugin, pick the file you downloaded and activate it.
3

Open the settings

Settings → Brosbots.
4

Connect the site

Click Connect to Brosbots. You are sent to the panel to pick the agent that should answer here. No account yet? You can create one in the same step.
5

Authorize

Authorize brings you back to the site with the connection saved. The widget is live.
Nothing is installed before you authorize it, and the token only ever travels back to an address on the same domain the connection started from.

​
Requirements

  • WordPress 6.0 or newer, PHP 7.4 or newer.
  • The site must be served over https. A browser grants no microphone access otherwise, so an insecure site is refused during the connection.
  • A Brosbots account with at least one agent.

​
Where the widget shows

Under Settings → Brosbots you pick one mode: On top of that:
  • Cart and checkout (WooCommerce) are excluded by default. A floating widget over a payment form costs more orders than it wins.
  • wp-admin never loads the widget.
  • The [brosbots] shortcode renders the agent inside a page and ignores the rules above. It needs the agent’s embed mode set to inline in the Brosbots panel.

​
What the agent knows about the visitor

This is the difference between the plugin and a plain embed snippet: the agent opens the conversation already knowing what the visitor is looking at, instead of asking. Each group is its own checkbox. An anonymous visitor sends nothing about themselves.
Nothing reaches the agent until the visitor starts a conversation. Loading the page only requests the widget’s configuration.

​
Extending the plugin

The plugin exposes four filters:
Context variables are used in the agent’s prompt like any other, see Template variables.

​
Switching agent and disconnecting

  • Switch agent: the same button as the first connection. Pick another agent and the site gets the new embed.
  • Disconnect this site: the plugin forgets the token and the widget stops loading. The agent, its recordings and transcripts are untouched in Brosbots.
  • Uninstalling the plugin removes its settings from the WordPress database. The token itself is revoked in the agent’s embed settings.

​
Security

An embed token is public by nature: it sits in the page source of every page the widget loads on. What protects it is the domain allow-list, which the plugin sets during the connection. A token lifted from your site does not work on anyone else’s. The return from the panel is only accepted when it matches a one-time code the plugin generated before leaving, and the token is verified against the API on top of that. A hand-crafted return address cannot park someone else’s agent on your site.

​
Troubleshooting

The widget does not appear. Check that Show the agent on the site is ticked, that the page matches the display rules, and that the site is served over https. “That connection did not start here”. The one-time code expired (it lasts ten minutes) or the return happened in a different browser. Click Connect to Brosbots again. “Brosbots did not recognise that token”. The embed was revoked in the panel in the meantime. Connect the site again. The agent cannot see the cart. WooCommerce context is its own checkbox and needs WooCommerce active.