Agentsia Agents

Апісанне

Agentsia Agents connects your WordPress site to your Agentsia application (app.agentsia.fr). In a few minutes you can:

  • Display the Agentsia chatbot as a floating bubble across the whole site, as a modal, or full-page inside a post.
  • Embed a public appointment booking form on any page.
  • Add a call-to-action button that links to your demo funnel.

Three integration methods are available: global settings, shortcodes and Gutenberg blocks.

This plugin is a client for the external Agentsia service and requires an Agentsia account. See the “External services” section below for details about the data exchanged.

Shortcodes

  • [agentsia_chatbot] — Full-page chatbot (configurable via attributes).
  • [agentsia_chatbot mode="bubble"] — Force the floating bubble from a specific page.
  • [agentsia_chatbot scenario="sos" context_hint="AC emergency page"] — Scenario + page context.
  • [agentsia_chatbot hide_bubble="1"] — Hide the bubble, open via JavaScript.
  • [agentsia_booking] — Booking form using the default calendar slug.
  • [agentsia_booking slug="sales-demo" height="780"]
  • [agentsia_demo label="Book my demo"] — Button linking to /demo.

Gutenberg blocks

  • Agentsia Chatbot
  • Agentsia Booking
  • Agentsia Demo button

External services

This plugin is a connector for the Agentsia service (operated by Agentsia, https://agentsia.fr). It only works with an Agentsia account and communicates with the services described below. By installing and configuring this plugin, you — and your site visitors — exchange data with these services.

1. Agentsia application — https://app.agentsia.fr

  • From your WordPress server (admin): when you save the settings and to populate the dropdowns, the plugin calls https://app.agentsia.fr/api/public/wp/me, /api/public/wp/chatbots and /api/public/wp/booking-calendars. Data sent: your Agentsia API key (Authorization header) and your site URL (User-Agent header). Data received: your account name, the list of your chatbots and your calendars.
  • From your visitors’ browser: the chat widget script is loaded from https://app.agentsia.fr/chatbot/embed.js; the appointment booking form is displayed in an iframe https://app.agentsia.fr/book/<slug>; the “demo” button is a plain link to https://app.agentsia.fr/demo.

2. Agentsia agent backend — https://agent-backend-production-311267441656.europe-west1.run.app

  • From your visitors’ browser: once the chat widget is loaded, the messages typed by your visitors (and the optional page context) are sent to this service to generate the AI agent’s replies. No data is sent until a visitor opens and uses the chat.

No data is transmitted until the plugin has been configured with a valid API key (server side) or the chatbot has been loaded and used (visitor side).

  • Terms of use: https://www.agentsia.fr/conditions-dutilisation/
  • Privacy policy: https://www.agentsia.fr/privacy-policy/

Important (GDPR): the chatbot sends your visitors’ messages to a third-party service. Mention this in your site’s privacy policy and, where applicable, obtain the required consent (cookie / consent banner).

Блокі

Гэты плагін прадастаўляе 3 блокі.

  • Chatbot Agentsia
  • Rendez-vous Agentsia
  • Bouton démo Agentsia

Ўсталёўка

  1. Upload the agentsia-agents folder to /wp-content/plugins/.
  2. Activate the plugin from the WordPress “Plugins” page.
  3. Generate an API key in your Agentsia account: My account › API keys › New key. Copy the key (agsk_…) — it is shown only once.
  4. Open Settings › Agentsia Agents and paste the key into the “API key” field. Save.
  5. Select the default chatbot and calendar from the dropdowns (populated automatically from your account).
  6. Enable (or not) the global bubble loading, then save again.
  7. Use the shortcodes or Gutenberg blocks in your pages.

Часта задаваныя пытанні

Where do I get my API key?

Sign in to app.agentsia.fr, then open My account › API keys and click “New key”. Give it a descriptive name (e.g. “WordPress site agentsia.fr”). The full key is shown only once — copy it into WordPress immediately.

What if my key is lost or compromised?

From My account › API keys on app.agentsia.fr, revoke the existing key and create a new one. Paste the new key into the WordPress plugin. Integrations using the old key will stop working immediately.

Does it work with Divi / Elementor / Avada?

Yes. The shortcodes work in any text module. The Gutenberg blocks work in the native WordPress editor.

Can I disable the chatbot on specific pages?

Yes. On the settings page, enter the paths to exclude (one per line).

The chatbot / calendar list is empty, why?

Make sure your API key is valid (a “Connected” badge appears at the top of the settings page). If it is valid but no chatbot is listed, create one from your Agentsia dashboard. The plugin caches the lists for 5 minutes.

Водгукі

На гэты плагін няма водгукаў.

Удзельнікі і распрацоўшчыкі

“Agentsia Agents” is open source software. The following people have contributed to this plugin.

Удзельнікі

Перакласці “Agentsia Agents” на вашу мову.

Зацікаўлены ў распрацоўцы?

Праглядзіце код, праверце SVN рэпазітарый, або падпішыцеся на журнал распрацоўкі па RSS.

Журнал змяненняў

1.1.0

  • New: Custom open/close trigger — bind any page element (CSS selector) to toggle the chatbot, with automatic grey-out or hide while the assistant is unavailable.
  • New: Default scenario at the global level — applies a named scenario (defined in the chatbot config on the Agentsia side) on all public pages.
  • New: Hide bubble at the global level — hides the floating bubble and only opens the chatbot via window.agentsia.open().
  • New: Extended shortcodescenario, context_hint, hide_bubble available on [agentsia_chatbot].
  • New: Documentation of the JavaScript methods setWelcomeMessage, setQuickReplies, setTeaserMessage, setAutoOpenDelay, setScenario, setContext, setAppearance, apply().

1.0.0

  • First public release.
  • Personal API key authentication (generated from app.agentsia.fr).
  • Chatbot and calendar selection via dropdowns (automatic sync from the Agentsia account).
  • Global chatbot (bubble, modal, full-page).
  • Shortcodes and Gutenberg blocks for chatbot, booking and demo button.
  • Complete settings page (API, appearance, exclusions).