Description
Costello is an AI receptionist that qualifies leads and answers questions in real time via a chat widget on your site.
This plugin injects the Costello widget script on every page of your site. No coding required — click Connect to Costello, approve, and you’re live.
Features:
- One-click connect — link your Costello account with a single button, no copy-pasting.
- Enable / disable toggle without touching any code.
- Works with any theme.
- No build step, no dependencies.
Getting started:
- Install and activate this plugin.
- The Settings → Costello Chat page opens automatically.
- Click Connect to Costello and approve the connection. Your widget goes live instantly on every page.
Prefer to do it by hand? You can paste your Agent ID manually instead — find it in your Costello dashboard under Integrations → Chat Widget.
External services
This plugin connects your site to Costello, an external AI chat service operated by Costello, to provide the live chat widget. A Costello account is required to use the plugin.
The plugin relies on the Costello service in two ways:
- Loading the chat widget. On every front-end page, the plugin loads the widget script from
https://platform.costellohq.com/widget/v1.js, tagged with your Agent ID. When a visitor opens the chat, their messages are sent to Costello to generate replies. The conversation data visitors enter (such as their questions, name, or contact details) is processed by Costello. - Connecting your site. When you click “Connect to Costello”, the plugin sends your site’s URL to
https://platform.costellohq.com/connect/wordpressso you can approve the connection and receive your Agent ID. No data is sent to Costello until you actively connect or a visitor uses the widget.
Use of the Costello service is governed by Costello’s Terms of Service (https://costellohq.com/terms) and Privacy Policy (https://costellohq.com/privacy).
Installation
- In your WordPress dashboard, go to Plugins → Add New and search for “Costello”. Click Install Now, then Activate. (Or upload the
costello-ai-chatfolder to/wp-content/plugins/manually.) - The Settings → Costello Chat page opens automatically after activation.
- Click Connect to Costello and approve — your widget goes live instantly. Prefer to do it by hand? Paste your Agent ID into the manual field instead.
FAQ
Where do I find my Agent ID?
Log in to platform.costellohq.com, go to Integrations → Chat Widget, and copy the Agent ID shown on the page.
Can I disable the widget without uninstalling the plugin?
Yes. Go to Settings → Costello Chat and uncheck the Widget status checkbox, then save.
Does the widget load on every page?
Yes. The script is injected into wp_footer globally so it appears on all front-end pages.
Changelog
1.0.0
- Initial release.