Giizo AI
Ready-made platform plugins

Platform plugin

Installing the Giizo AI widget on your WordPress site

Ready-made plugin for WordPress 5.0 and above: installation, where to find your Agent ID and API key, the settings screen and the test step.

Version: 1.0.1Size: 7 KBRequirements: WordPress 5.0+ · PHP 7.4+
Download plugin

This plugin adds the chat widget to your WordPress site without writing code. The signed URL generation you would otherwise have to build yourself is handled by the plugin on the server side — that is the real convenience here.

Requirements

  • WordPress 5.0 or above
  • PHP 7.4 or above
  • An assistant created and set to active in the dashboard

Step 1: Prepare your Agent ID and API key

Installation asks for two values; get both ready first.

API key. Generated on theSettings screen in the dashboard. Copy it somewhere.

Agent ID. It appears as agent-id="..." inside the embed snippet on the assistant's Access Channels → Widget screen. There is no field in the dashboard that shows the Agent ID on its own, so you have to copy it out of the snippet.

Step 2: Install the plugin

Download the ZIP with the button at the top of this page, then:

  1. In the WordPress admin panel go to Plugins → Add New
  2. Click Upload Plugin
  3. Select the ZIP file you downloaded and upload it
  4. Activate the plugin once the upload finishes

This is WordPress's ordinary plugin installation flow; there is no special step.

Step 3: Enter the settings

  1. Open Settings → Giizo AI Widget
  2. Enter your API key in the Giizo API Key field
  3. Enter your assistant's identifier in the Agent ID field
  4. Tick Enable Widget
  5. Click Save Changes

The Test Widget button on the settings screen checks whether the connection is established. If the test fails, compare the API key and Agent ID character by character first — the most common cause is a stray space picked up while copying.

Step 4: Verify on your site

Open the front end of your site. The chat button should appear in the bottom-right corner, and clicking it should open the window with the assistant sending its first message.

If the widget does not appear, check in this order:

  1. Is the assistant active? Widget configuration is not served for inactive assistants.
  2. Is the allowed domain list populated? If the list on the assistant'sSecurity tab is empty every domain is allowed; if it is populated your domain has to be in it.
  3. Is there an error in the browser console? Connection problems are logged there.

Changing the appearance

Colours, button size, window variant and copy are configured in the dashboard, not in the plugin: the assistant'sAccess Channels → Widget screen. When you save, the change takes effect on your site without touching the plugin, because the widget fetches its appearance configuration from the server on every load.

The full list of configurable fields is on website chat widget.

Things to know

  • Only one widget runs per page.
  • Voice conversation requires the visitor to grant microphone permission and the page not to block microphone access.
  • Version updates require downloading and installing the plugin again; there is no automatic update.