Documentation

Integrate VolaCRM widgets with Astro or Vite

Use the current workspace-generated Chat and Contact Us embed codes, publish your website, and verify delivery to the correct VolaCRM workspace.

Before you start

Choose the VolaCRM workspace that will receive messages, generate the appropriate embed code, and save your website domain in its configuration. Copy the complete generated code; do not enter guessed identifiers or expose account passwords in your website.

Platform steps

In Astro, place the generated Chat code in a shared layout and the Contact Us code in the relevant page section. Preserve external script attributes using the framework’s appropriate unprocessed or inline-script option. Do not replace the generated identifiers with placeholders from older examples.

For a Vite application, install site-wide code in the HTML entry or a persistent browser layout. Keep page-specific forms in their intended containers. If client-side navigation replaces that section, verify the widget is available after navigation as well as on the initial page load.

Verify the published integration

  1. Open the published website in a fresh browser session and check that the intended form or chat appears.
  2. Send a clearly labeled test inquiry or chat message.
  3. Open the receiving workspace and confirm that the test appears there.
  4. If delivery fails, check the saved domain, generated identifiers, browser console, and network response before changing the code.

Use the illustrated setup guide for the current configuration screens. Existing embed URLs can continue to work, but old sample attributes should not replace newly generated code.

Setup guide