{"id":319572,"date":"2026-06-04T15:01:54","date_gmt":"2026-06-04T15:01:54","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/ipira-ai-chat-widget\/"},"modified":"2026-10-02T16:42:36","modified_gmt":"2026-10-02T16:42:36","slug":"ipira-ai-chat-widget","status":"publish","type":"plugin","link":"https:\/\/ml.wordpress.org\/plugins\/ipira-ai-chat-widget\/","author":23507715,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"2.2.1","stable_tag":"2.2.1","tested":"7.0.7","requires":"5.8","requires_php":"7.4","requires_plugins":null,"header_name":"Ipira AI Chat Widget","header_author":"GoDev Technologies","header_description":"Add the Ipira AI-powered chat widget to your WordPress site. Automatically answers customer questions 24\/7 using your knowledge base.","assets_banners_color":"9facb5","last_updated":"2026-10-02 16:42:36","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/ipira.io","header_author_uri":"https:\/\/godev.net","rating":5,"author_block_rating":0,"active_installs":0,"downloads":555,"num_ratings":1,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.1.0":{"tag":"1.1.0","author":"godevtechnologies","date":"2026-06-04 15:00:41","revision":3561184},"1.2.0":{"tag":"1.2.0","author":"godevtechnologies","date":"2026-06-04 15:44:13","revision":3561247},"2.1.1":{"tag":"2.1.1","author":"godevtechnologies","date":"2026-06-04 23:03:26","revision":3561655},"2.1.2":{"tag":"2.1.2","author":"godevtechnologies","date":"2026-06-04 23:04:16","revision":3561656},"2.2.0":{"tag":"2.2.0","author":"godevtechnologies","date":"2026-09-30 15:44:34","revision":3721600},"2.2.1":{"tag":"2.2.1","author":"godevtechnologies","date":"2026-10-02 16:42:36","revision":3725149}},"upgrade_notice":{"2.2.1":"

Updates the settings page with the new Ipira logo and a quick "Start free" panel for new users.<\/p>","2.2.0":"

Adds Free plan support: a no-credit-card signup link, clearer Test Connection messages for accounts waiting on email verification, and updated Widget Key instructions.<\/p>","2.1.2":"

Adds IpiraChat.capture() \u2014 a new JavaScript API method that opens the widget and jumps straight into lead capture with a single button click.<\/p>","1.2.0":"

Adds custom lead questions, a visitor confirmation step, custom trigger keywords, and access to the new analytics dashboard with date-range charts and CSV export.<\/p>","1.1.0":"

Adds JavaScript API so you can open the chat widget from any button or link on your site.<\/p>","1.0.1":"

Security and compatibility fixes. Recommended for all users.<\/p>","1.0.0":"

Initial release.<\/p>"},"ratings":{"1":0,"2":0,"3":0,"4":0,"5":1},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3721632,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3721632,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3561194,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772-250.png":{"filename":"banner-772-250.png","revision":3561194,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.1.0","1.2.0","2.1.1","2.1.2","2.2.0","2.2.1"],"block_files":[],"assets_screenshots":{"screenshot-1.jpg":{"filename":"screenshot-1.jpg","revision":3561194,"resolution":"1","location":"assets","locale":"","width":1200,"height":608},"screenshot-2.jpg":{"filename":"screenshot-2.jpg","revision":3561194,"resolution":"2","location":"assets","locale":"","width":1200,"height":632},"screenshot-3.jpg":{"filename":"screenshot-3.jpg","revision":3561194,"resolution":"3","location":"assets","locale":"","width":1200,"height":611},"screenshot-4.jpg":{"filename":"screenshot-4.jpg","revision":3561194,"resolution":"4","location":"assets","locale":"","width":1200,"height":694}},"screenshots":{"1":"The Ipira Chat settings page in the WordPress dashboard sidebar","2":"The Test Connection button confirming a valid Widget Key","3":"The chat widget on a live website","4":"Lead capture in action"}},"plugin_section":[],"plugin_tags":[2353,5707,2364,2369,337],"plugin_category":[41],"plugin_contributors":[265848],"plugin_business_model":[],"class_list":["post-319572","plugin","type-plugin","status-publish","hentry","plugin_tags-ai","plugin_tags-chat","plugin_tags-chatbot","plugin_tags-customer-support","plugin_tags-lead-generation","plugin_category-communication","plugin_contributors-godevtechnologies","plugin_committers-godevtechnologies"],"banners":{"banner":"https:\/\/ps.w.org\/ipira-ai-chat-widget\/assets\/banner-772-250.png?rev=3561194","banner_2x":"https:\/\/ps.w.org\/ipira-ai-chat-widget\/assets\/banner-1544x500.png?rev=3561194","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/ipira-ai-chat-widget\/assets\/icon-128x128.png?rev=3721632","icon_2x":"https:\/\/ps.w.org\/ipira-ai-chat-widget\/assets\/icon-256x256.png?rev=3721632","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/ipira-ai-chat-widget\/assets\/screenshot-1.jpg?rev=3561194","caption":"The Ipira Chat settings page in the WordPress dashboard sidebar"},{"src":"https:\/\/ps.w.org\/ipira-ai-chat-widget\/assets\/screenshot-2.jpg?rev=3561194","caption":"The Test Connection button confirming a valid Widget Key"},{"src":"https:\/\/ps.w.org\/ipira-ai-chat-widget\/assets\/screenshot-3.jpg?rev=3561194","caption":"The chat widget on a live website"},{"src":"https:\/\/ps.w.org\/ipira-ai-chat-widget\/assets\/screenshot-4.jpg?rev=3561194","caption":"Lead capture in action"}],"raw_content":"\n

Ipira is an AI-powered chat assistant that learns from your knowledge base and answers customer questions automatically \u2014 24 hours a day, 7 days a week. It captures and qualifies leads conversationally, so your team wakes up to warm contacts instead of cold traffic numbers.<\/p>\n\n

Start free \u2014 no credit card.<\/strong> The Free plan includes 1 AI agent, 10 documents, and 100 AI answers a month, with lead capture included. Upgrade any time for higher limits.<\/p>\n\n

How it works:<\/strong>\n* Upload your documents, FAQs, and website content to Ipira\n* Your AI assistant learns from your knowledge base\n* Visitors ask questions and get instant, accurate answers\n* High-intent visitors are automatically identified as leads\n* The AI collects contact info and your custom qualifying questions \u2014 all in natural conversation\n* Leads land in your Ipira dashboard with full conversation transcripts<\/p>\n\n

Features:<\/strong><\/p>\n\n

AI Chat<\/em>\n* Answers questions using your own documents, website content, and uploaded files\n* Understands images, PDFs, and Word documents\n* Suggests related pages when relevant, plus YouTube videos on paid plans\n* Privacy mode option for sensitive industries<\/p>\n\n

Lead Capture<\/em>\n* Automatic lead detection \u2014 recognizes buying signals and high-intent phrases in real time\n* Custom trigger keywords \u2014 add industry-specific phrases (e.g. \"free estimate\", \"book a call\") that instantly activate lead capture\n* Custom lead questions \u2014 ask your own follow-up questions after collecting name, email, and phone to qualify leads the way your business needs\n* Lead confirmation step \u2014 visitors review their info and custom answers before submitting, with an edit flow so the data you receive is accurate\n* Leads emailed to you instantly with full answers to your custom questions\n* Session-smart deduplication \u2014 the same visitor can submit a new lead in a future session without being silently dropped<\/p>\n\n

Widget Customization<\/em>\n* Colors, position, size, welcome message, and FAQ quick questions\n* Fully customizable per AI agent\n* Use one AI agent on as many websites as you like\n* Works on all pages automatically\n* Enable\/disable toggle without deactivating the plugin\n* Shortcode support [ipira_chat] to embed on specific pages<\/p>\n\n

Developer Tools<\/em>\n* JavaScript API \u2014 open, close, pre-fill, or instantly trigger lead capture from any button, link, or marketing CTA on your site\n* IpiraChat.open() \u2014 opens the widget, optionally with a pre-filled message\n* IpiraChat.capture() \u2014 opens the widget and jumps straight into lead capture \u2014 no visitor message required\n* Test Connection button verifies your Widget Key and shows the connected AI agent instantly<\/p>\n\n

Analytics (Ipira Dashboard)<\/em>\n* Conversations and leads over time with 7 \/ 30 \/ 90 day and custom date range charts\n* \"What Visitors Are Asking\" \u2014 ranked top-10 topic analysis from real visitor messages\n* Conversation search \u2014 find any past conversation instantly (Pro)\n* Export Conversations and Leads as CSV for your CRM or reporting (Pro)\n* Recent conversations table with lead indicators and full message transcripts<\/p>\n\n

Knowledge Base Management<\/em>\n* Upload PDF, DOCX, TXT, and Markdown files\n* Scrape website content automatically\n* Edit documents directly in the dashboard \u2014 no re-uploading needed\n* Folder visibility controls \u2014 share documents across all AI agents or assign them to specific agents\n* Hide folders from the AI entirely for staging or internal content<\/p>\n\n

No coding required<\/em><\/p>\n\n

Requirements:<\/strong>\n* An Ipira account \u2014 create a free account, no credit card<\/a>\n* Your Widget Key from your Ipira dashboard<\/p>\n\n\n

    \n
  1. Upload the plugin files to \/wp-content\/plugins\/ipira-chat-widget\/<\/code> or install through the WordPress plugin screen<\/li>\n
  2. Activate the plugin through the Plugins screen in WordPress<\/li>\n
  3. Go to Ipira Chat<\/strong> in your WordPress dashboard sidebar<\/li>\n
  4. Log in to your Ipira dashboard<\/a>, open AI Agents<\/strong> \u2192 your agent \u2192 Get Embed Code<\/strong>, and click Copy Widget Key<\/strong><\/li>\n
  5. Paste your Widget Key into the settings page and click Test Connection<\/strong> to verify<\/li>\n
  6. Click Save Settings<\/strong><\/li>\n
  7. Visit your website \u2014 the chat widget will appear automatically on every page (on the Free plan, once you've verified your Ipira email address)<\/li>\n<\/ol>\n\n\n
    \n

    Where do I find my Widget Key?<\/h3><\/dt>\n

    Log in to your Ipira dashboard at ipira.io, click AI Agents<\/strong> in the sidebar, open your agent, and click Get Embed Code<\/strong>. Use the Copy Widget Key<\/strong> button to grab just the key.<\/p><\/dd>\n

    Do I need an Ipira account?<\/h3><\/dt>\n

    Yes. The plugin connects your WordPress site to your Ipira AI agent. Create a free account<\/a> \u2014 no credit card required.<\/p><\/dd>\n

    Is there a free plan?<\/h3><\/dt>\n

    Yes. The Free plan costs nothing, needs no credit card, and doesn't expire. It includes 1 AI agent, 10 documents, 100 AI answers a month, and lead capture. Free widgets show a small \"Powered by Ipira\" badge. Paid plans raise the limits, remove the badge, add YouTube video suggestions, and start with a 14-day free trial.<\/p><\/dd>\n

    What happens when I use up my 100 free AI answers?<\/h3><\/dt>\n

    The widget stays on your site and never shows an error. Visitors see your business phone and email and can still leave their contact details, so you keep getting leads. AI answers start again at your next monthly reset, or right away if you upgrade.<\/p><\/dd>\n

    Why doesn't my widget appear yet?<\/h3><\/dt>\n

    On the Free plan, the widget turns on once you verify your Ipira email address. Click the link in the verification email we sent when you signed up. The Test Connection button tells you if your key is valid but still waiting on verification.<\/p><\/dd>\n

    Can I use one AI agent on more than one website?<\/h3><\/dt>\n

    Yes. Install the plugin on each WordPress site and paste the same Widget Key. All sites share that agent's knowledge base and settings, and count toward your account's monthly AI answer limit. Create a separate agent in Ipira if a site needs a different profile or look.<\/p><\/dd>\n

    Does the chat automatically hand off conversations to a live person?<\/h3><\/dt>\n

    No. The Ipira Chat Widget is an AI-only assistant and does not include built-in live agent transfer or escalation. If a visitor needs human support, you can guide them with custom FAQ quick questions or messaging in your welcome text to contact your team by phone, email, or your existing support channel.<\/p><\/dd>\n

    Will the widget slow down my site?<\/h3><\/dt>\n

    No. The widget script loads asynchronously and has no impact on your page load speed or Core Web Vitals.<\/p><\/dd>\n

    Can I disable the widget without deactivating the plugin?<\/h3><\/dt>\n

    Yes. In your WordPress admin dashboard, click Ipira Chat<\/strong> in the left sidebar menu, then uncheck \"Show the chat widget on all pages.\" This is your WordPress site's dashboard (wp-admin), not the Ipira portal at ipira.io.<\/p><\/dd>\n

    How do I know my Widget Key is working?<\/h3><\/dt>\n

    Use the Test Connection button on the settings page. It will confirm your key is valid and show you which AI agent and company it is connected to.<\/p><\/dd>\n

    Can I open the widget from a button on my site?<\/h3><\/dt>\n

    Yes. Once the plugin is installed, go to your WordPress admin dashboard, click Ipira Chat<\/strong> in the left sidebar, and scroll down to the JavaScript API section \u2014 it shows copy-paste examples ready to drop into any page or theme.<\/p>\n\n

    IpiraChat.open()<\/strong> opens the widget from a button or link, with an optional pre-filled message:<\/p>\n\n

    <button onclick=\"window.IpiraChat?.open({ message: 'I need a free estimate' })\" style=\"cursor: pointer;\">\n  Get a Free Estimate\n<\/button>\n<\/code><\/pre>\n\n
    IpiraChat.capture()<\/strong> opens the widget and immediately starts lead capture \u2014 no message required from the visitor. Use this on high-intent CTAs like estimate requests or booking buttons where the visitor's goal is already clear:<\/p>\n\n
    <button onclick=\"window.IpiraChat?.capture()\" style=\"cursor: pointer;\">\n  Get a Free Estimate\n<\/button>\n\n<a href=\"#\" onclick=\"window.IpiraChat?.capture(); return false;\" style=\"cursor: pointer;\">\n  Book a Consultation\n<\/a>\n<\/code><\/pre>\n\n
    Both methods work on buttons and links. The safe window.IpiraChat?.<\/code> version prevents errors if the widget script has not fully loaded yet.<\/p><\/dd>\n
    Can I place the widget on specific pages only?<\/h3><\/dt>\n
    The widget loads on all pages by default. To limit it to specific pages, go to your WordPress admin dashboard, click Ipira Chat<\/strong> in the left sidebar, and use the enable\/disable toggle to turn it off site-wide. You can then manually add the widget to specific pages using the [ipira_chat] shortcode, your theme, or a page builder.<\/p><\/dd>\n
    Can I ask my own questions during lead capture?<\/h3><\/dt>\n
    Yes. Log in to your Ipira account at ipira.io, go to Widget Configuration > Behavior, and add custom lead questions that the AI asks after collecting name, email, and phone. Each question can be marked Required or Optional. Required questions are re-asked once if skipped; optional questions move on immediately if the visitor skips them. This is configured in the Ipira portal \u2014 not in the WordPress plugin settings.<\/p><\/dd>\n
    What happens after the AI collects a visitor's contact details?<\/h3><\/dt>\n
    The visitor sees a confirmation summary showing their name, email, phone, and all custom question answers before the lead is submitted. They can request changes \u2014 the AI will ask for the corrected value, update the summary, and re-show it. You receive an email notification with the complete lead including all custom answers. All captured leads are also stored in your Ipira account at ipira.io, where you can view contact details, conversation transcripts, lead quality scores, and pipeline status from the Leads page.<\/p><\/dd>\n
    Can the AI detect when someone is ready to buy?<\/h3><\/dt>\n
    Yes. Ipira automatically detects buying signals in visitor messages. You can also add your own custom trigger keywords \u2014 phrases specific to your industry (like \"get a quote\" or \"book a consultation\") that immediately activate lead capture the moment a visitor uses them.<\/p><\/dd>\n
    Can I control which documents each AI agent uses?<\/h3><\/dt>\n
    Yes. In your Ipira dashboard you can organize documents into folders and set each folder's scope: shared across all AI agents, assigned to specific agents only, or hidden from the AI entirely (useful for staging content or internal reference documents).<\/p><\/dd>\n
    Where is my customer data stored?<\/h3><\/dt>\n
    All data is stored securely in your Ipira account. See ipira.io\/privacy<\/a> for details.<\/p><\/dd>\n\n<\/dl>\n\n\n
    2.2.1<\/h4>\n\n