⚙️Installation

Install your chatbot on any website

Use the secure WordPress connection, popup snippet, inline embed, or direct link and verify that Pivra can see the widget.

Updated 23 July 2026

Before you install

Choose the chatbot in the dashboard, then confirm these three items:

Open Chatbot → General, choose Published, and save.
Add at least one useful source under Knowledge and wait until it is ready.
Open Chatbot → Install and review the activation checks.

A draft chatbot is available in the authenticated Test screen, but it is intentionally blocked from public websites.

Popup widget for HTML and website builders

Open Chatbot → Install → HTML / any site and copy the generated snippet. It uses your chatbot ID and, when enabled, a public embed key:

<!-- Pivra chatbot popup -->
<script>
  window.AIchatConfig = {
    chatbotId: 'YOUR_CHATBOT_ID',
    apiKey: 'YOUR_PUBLIC_EMBED_KEY'
  };
</script>
<script src="https://embed.pivra.ai/popup.js" defer></script>

Paste it immediately before </body> in the shared layout or footer. Use the exact snippet from your dashboard rather than copying the placeholders above.

WordPress (recommended)

The Pivra WordPress plugin avoids editing theme files and uses a one-time connection code.

Open Chatbot → Install → WordPress.
Download the official Pivra AI Chatbot ZIP, then in WordPress go to Plugins → Add New → Upload Plugin and activate it.
Confirm the chatbot is Active/Published in Pivra.
In Pivra, click Generate setup code. The code expires after 30 minutes, works once, and is stored hashed.
In WordPress, open Settings → Pivra AI Chatbot, paste the code, and connect.
Return to Pivra and confirm that the site appears as healthy.

You can revoke an unused code or disable a connected site from the same Pivra screen. Use Check connection now in WordPress after a remote disable. The manual popup snippet is a fallback for developers when plugins cannot be installed.

Next.js

Open Chatbot → Install → Next.js and copy the generated client component. Add <PivraChat /> inside the <body> in your root layout. The supplied component sets window.AIchatConfig before loading popup.js with next/script.

Inline embed

Use Embed inline when the conversation should sit inside a page rather than open from a floating button. Copy the generated iframe from the Install screen; it includes the correct chatbot ID and public key.

Direct link

Use the generated direct link in email, SMS, a QR code, or a call-to-action button. Do not construct the URL manually because keyed chatbots require the key query parameter.

Confirm the installation

Reload the customer website, then return to Chatbot → Install. Pivra should show:

Widget detected with the first and latest load times
the detected website domain
a recent live signal
a healthy WordPress heartbeat when the plugin is used

The activation score also checks publishing, business instructions, trained knowledge, lead capture, and lead-delivery routes. Warnings recommend improvements; failed required checks need attention.

Troubleshooting

No bubble: confirm the chatbot is Published, the snippet appears once, and https://embed.pivra.ai/popup.js is not blocked by a content-security policy or optimisation plugin.
Draft or 404 response: publish and save the chatbot under Chatbot → General.
WordPress is stale: clear WordPress/server caches, update the plugin, and check that outbound HTTPS requests to Pivra are allowed.
Wrong chatbot: replace the old snippet or reconnect the plugin using a code generated for the intended chatbot.
Domain rejected: review the allowed-domain list under Chatbot → White Label.

Never paste a Pivra account password, private API key, or ServiceM8 key into website code. The embed key displayed in the Install screen is designed for the public widget.

Was this helpful?

If you have questions or suggestions, email us at support@pivra.ai .