> For the complete documentation index, see [llms.txt](https://partners.botpenguin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://partners.botpenguin.com/partner-platform-guidelines/integration/setup-wordpress-integration.md). # Setup WordPress Integration #### What is WordPress Integration? WordPress is one of the world's most widely used website platforms. Integrating WordPress with your Agency Panel allows your customers to install their website chatbot directly on their WordPress site — without touching any code — through a dedicated plugin tied to your agency. *** #### Prerequisites The following prerequisites are required for the setup of the WordPress Integration: * Agency must have a WordPress plugin already published and active on WordPress. *** #### Benefits of WordPress Integration * 🔌 Enables your customers to install their chatbot on WordPress directly — no code required. * 🌐 Connects your agency's WordPress plugin to your platform, giving customers a seamless one-click install experience. * ⚙️ Lets customers link their website bot to their WordPress site from within their own panel. * 📦 Keeps the chatbot installation process self-serve — reducing onboarding effort for you and your team. * 🚀 Supports faster go-live for customers who already run their website on WordPress. *** #### How to Set Up WordPress Integration #### Section 1: Connecting WordPress from the Agency Panel 1. Log in to your Agency Panel. 2. From the left sidebar, click on Integrations. 3. Search for WordPress or scroll down to locate it. 4. Click Connect/Configure.
5. Click **Add Configuration**.
6. You will see two fields: 1. **Configuration Name** — Enter any name you'd like to identify this configuration (e.g., "Main WordPress Site"). 2. **WordPress Installation URL** — Copy and paste the URL of the page on your WordPress site where the plugin has been installed and is active.
6. Click **Add Configuration** to save. 7. Turn "Status" to ON to enable the configuration *** #### What Happens Next Once the configuration is saved, your customers will see your agency's WordPress plugin as an installation option when setting up a website bot. From their panel, they can navigate to their website bot's installation page and choose WordPress — which will connect directly to the plugin you've configured here. This means your customers can go live on WordPress without any manual steps from your side. *** #### Troubleshooting
The WordPress install option isn't appearing for customers. Verify that the WordPress integration has been configured and saved successfully in your Agency Panel. Also check that the integration is enabled and that a valid WordPress Installation URL has been provided.
Customers receive an error when installing through WordPress. Confirm that the WordPress plugin is installed and activated on the target WordPress site. Also verify that the Installation URL points to the correct page where the plugin is active.
The WordPress Installation URL isn't working. Open the URL in an incognito browser window to ensure it is publicly accessible. If the page returns an error or redirects unexpectedly, update the URL in the WordPress integration settings.
A customer completed installation but the bot isn't appearing on their website. Verify that the plugin is active on the customer's WordPress site and that the installation process completed successfully. If necessary, reconnect the bot and repeat the installation process.
Changes to the integration aren't visible to customers. After updating your WordPress integration settings, allow a few minutes for changes to propagate. Ask the customer to refresh their dashboard and retry the installation process.
*** #### WordPress Integration FAQs
Do I need a separate WordPress plugin for each customer? No. You configure the WordPress plugin once at the agency level. All your customers then access and use that same plugin to connect their individual website bots to their WordPress site.
Where do customers go to install via WordPress? Customers can find the WordPress installation option on the installation page of their website bot inside their panel. Once you've set up the integration, it will appear there automatically.
What URL should I enter as the WordPress Installation URL? Enter the URL of the specific page on your WordPress site where your WordPress plugin has been installed and is currently active. This is not your WordPress admin URL—it is the public-facing page where the plugin lives.
Can I add multiple WordPress configurations? Yes. You can add more than one configuration—for example, if you manage multiple WordPress sites. Each configuration should have a unique name and its own installation URL.
What happens if my WordPress plugin URL changes? You will need to update the WordPress Installation URL in your integration settings. Go to **Integrations → WordPress**, edit the existing configuration, and replace the URL with the updated one.
Can I disconnect the WordPress integration later? Yes. You can disconnect or remove any configuration at any time from the **Integrations** section in your Agency Panel. This will remove the WordPress install option for your customers.
{% hint style="info" %} **Tip:** Test the installation flow yourself as a customer before announcing WordPress as an available install option to your customer base. {% endhint %} *** If you still have questions for our team, write to us at ****. We'll get back to you within 48 hours. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://partners.botpenguin.com/partner-platform-guidelines/integration/setup-wordpress-integration.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.