Ipira AI Chat Widget

常見問題

Where do I find my Widget Key?

Log in to your Ipira dashboard at ipira.io, select your website, and click Embed Code in the sidebar. You will see a copy button to grab just the Widget Key.

Do I need an Ipira account?

Yes. The plugin connects your WordPress site to your Ipira AI assistant. Start a free 14-day trial — credit card required, no charge until after the trial ends.

Does the chat automatically hand off conversations to a live person?

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.

Will the widget slow down my site?

No. The widget script loads asynchronously and has no impact on your page load speed or Core Web Vitals.

Can I disable the widget without deactivating the plugin?

Yes. In your WordPress admin dashboard, click Ipira Chat 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.

How do I know my Widget Key is working?

Use the Test Connection button on the settings page. It will confirm your key is valid and show you which website and company it is connected to.

Can I open the widget from a button on my site?

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

IpiraChat.open() opens the widget from a button or link, with an optional pre-filled message:

<button onclick="window.IpiraChat?.open({ message: 'I need a free estimate' })" style="cursor: pointer;">
  Get a Free Estimate
</button>

IpiraChat.capture() opens the widget and immediately starts lead capture — 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:

<button onclick="window.IpiraChat?.capture()" style="cursor: pointer;">
  Get a Free Estimate
</button>

<a href="#" onclick="window.IpiraChat?.capture(); return false;" style="cursor: pointer;">
  Book a Consultation
</a>

Both methods work on buttons and links. The safe window.IpiraChat?. version prevents errors if the widget script has not fully loaded yet.

Can I place the widget on specific pages only?

The widget loads on all pages by default. To limit it to specific pages, go to your WordPress admin dashboard, click Ipira Chat 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.

Can I ask my own questions during lead capture?

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 — not in the WordPress plugin settings.

What happens after the AI collects a visitor’s contact details?

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 — 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.

Can the AI detect when someone is ready to buy?

Yes. Ipira automatically detects buying signals in visitor messages. You can also add your own custom trigger keywords — phrases specific to your industry (like “get a quote” or “book a consultation”) that immediately activate lead capture the moment a visitor uses them.

Can I control which documents the AI uses on each website?

Yes. In your Ipira dashboard you can organize documents into folders and set each folder’s scope: shared across all websites, assigned to specific sites only, or hidden from the AI entirely (useful for staging content or internal reference documents).

Where is my customer data stored?

All data is stored securely in your Ipira account. See ipira.io/privacy for details.