Script Tag

Script Tag installation

The Script Tag is the fastest browser-first path and sits second after the Server API in the integration priority.

Install

Add wavebird.js and at least one data-wavebird-slot element to the page. Use a publishable key and client_id from the dashboard.

index.html

<script
  src="https://wavebird.ai/wavebird.js"
  data-client-id="wbproj_demo_8jK42"
  data-publishable-key="pk_test_wavebird_demo_publishable"
  data-job-type="chat">
</script>

<div
  data-wavebird-slot
  data-wavebird-formats="banner,native"
  data-wavebird-position="between">
</div>

Allowed origins

Every browser origin must be configured for the publishable key. Localhost, staging, and production are separate origins.

Debug mode

Append ?wavebird-debug=1 to the page URL to surface initialization, activation, consent, render, decision, and beacon diagnostics in the console.

Errors

Configuration

Code

Install wavebird.js

Browser-first install with publishable-key activation.

index.html

<script
  src="https://wavebird.ai/wavebird.js"
  data-client-id="wbproj_demo_8jK42"
  data-publishable-key="pk_test_wavebird_demo_publishable"
  data-job-type="chat">
</script>

<div
  data-wavebird-slot
  data-wavebird-formats="banner,native"
  data-wavebird-position="between">
</div>

Need rollout review?

Contact the team

Start in the dashboard, choose Script Tag or Server API, and use contact only when you need rollout review, enterprise coordination, or non-standard integration help. Billing beacon rules live in the API concepts guide.