Beskrivning
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/chatbotsand/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 iframehttps://app.agentsia.fr/book/<slug>; the ”demo” button is a plain link tohttps://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).
Block
Detta tillägg tillhandahåller 3 block.
- Chatbot Agentsia
- Rendez-vous Agentsia
- Bouton démo Agentsia
Installation
- Upload the
agentsia-agentsfolder to/wp-content/plugins/. - Activate the plugin from the WordPress ”Plugins” page.
- Generate an API key in your Agentsia account: My account › API keys › New key. Copy the key (
agsk_…) — it is shown only once. - Open Settings › Agentsia Agents and paste the key into the ”API key” field. Save.
- Select the default chatbot and calendar from the dropdowns (populated automatically from your account).
- Enable (or not) the global bubble loading, then save again.
- Use the shortcodes or Gutenberg blocks in your pages.
Vanliga frågor
-
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.
Recensioner
Detta tillägg har inga recensioner.
Bidragsgivare och utvecklare
”Agentsia Agents” är programvara med öppen källkod. Följande personer har bidragit till detta tillägg.
Bidragande personerÖversätt ”Agentsia Agents” till ditt språk.
Intresserad av programutveckling?
Läs programkoden, kika på SVN-filförvaret eller prenumerera på utvecklarloggen via RSS.
Ändringslogg
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 shortcode —
scenario,context_hint,hide_bubbleavailable 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).
