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.
• Let your Agentsia SEO agent update the SEO title, meta description, noindex and canonical URL of your pages, in the fields of your SEO plugin (Yoast SEO, Rank Math, SEOPress, All in One SEO, The SEO Framework), fix the alternative text of their images, and edit one section of a page without rewriting it, including the text custom fields (ACF) of pages that keep their text there. Without any SEO plugin, Agentsia Agents prints these tags itself.

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_booking slug="my-workspace/sales-demo"]: the end of the calendar’s address (/book/my-workspace/sales-demo), for a calendar of another workspace or a site without an API key.
• [agentsia_demo label="Book my demo"] — Button linking to /demo.
• [agentsia_derniers_articles nombre="3" titre="Derniers articles" categorie="" auteur=""]: latest published posts of a category (slug or ID) or of an author (ID or login). Without category nor author, on a page: the category whose slug is the page’s slug (page /advisor/jane-doe/ and category jane-doe); nothing is shown when there is none.

Gutenberg blocks

• Agentsia Chatbot
• Agentsia Booking
• Agentsia Demo button
• Derniers articles (latest posts, same settings as the shortcode)

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 WordPress server (pages with a booking form): to get the address of the calendar, the plugin calls /api/public/wp/booking-calendars with the same data, at most once every 5 minutes for a calendar it does not know yet; the addresses are kept for a day.
• 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/<workspace>/<slug> (or https://app.agentsia.fr/book/<slug> when the address of the calendar is not known); 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.

3. One-click connection (« Connect to Agentsia » button)

• From the administrator’s browser: the button opens https://app.agentsia.fr/connect/wordpress with your site address, its REST address and a random one-time value; you log in to Agentsia there and choose a workspace, then come back to your site with a one-time code.
• From your WordPress server: the plugin creates a dedicated user « Agentsia » with a limited role (posts, pages, media) and an Application Password for it, then sends to https://app.agentsia.fr/api/public/wp/connect the one-time code, your site and REST addresses, a random site identifier, the dedicated user’s login and Application Password, and your administrator user ID (default author of articles). Agentsia calls your site back once (/wp-json/agentsia/v1/environment) to check the site holds that password, stores it encrypted, and returns the workspace API key.
• Afterwards, the Agentsia SEO agent uses that dedicated user to read and update your content through the WordPress REST API and the plugin’s routes. « Disconnect » revokes the Application Password and tells https://app.agentsia.fr/api/public/wp/disconnect.

No data is transmitted until the plugin has been configured with a valid API key or connected with the button (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).