> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dealerfunnel.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Add the Dealer Funnel SMS Widget to Your Dealership Website

> The SMS widget embeds a text-us button on your website that routes visitors into your Dealer Funnel inbox — capture leads without a form.

The Dealer Funnel SMS widget turns your dealership website into a live text conversation starter. Instead of asking visitors to fill out a contact form and wait for a callback, the widget lets them tap a button and send a text message right from their phone or desktop — and that message drops directly into your Dealer Funnel inbox as a new lead. No forms, no friction, no leads falling through the cracks. The widget is a small JavaScript snippet that takes minutes to install and works on any website platform.

## How the SMS Widget Works

When a visitor lands on your website and clicks the widget button, a small prompt appears asking for their name and their question or message. When they submit, Dealer Funnel sends that visitor an SMS from your dealership's phone number and simultaneously creates a new lead record in your inbox. Your agents can pick up the conversation immediately, just like any other SMS lead. The entire interaction happens over standard text messaging — the customer doesn't need to download an app or stay on your website.

## Widget Configuration Options

Before copying your embed code, configure the widget to match your dealership's brand and routing preferences. All options are set in **Settings > SMS Widget**.

| Option              | Description                                                                                                                                     |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| **Button Text**     | The label displayed on the floating widget button (e.g., "Text Us", "Chat Now", "Ask a Question")                                               |
| **Prompt Text**     | The headline shown in the widget popup when a visitor clicks the button (e.g., "Have a question? Text us now!")                                 |
| **Brand Color**     | The background color of the widget button — use your dealership's primary brand hex code to match your site                                     |
| **Routing Number**  | The SMS number that incoming widget messages are delivered to — choose the number assigned to your main sales line or a dedicated web lead line |
| **Lead Source Tag** | The source label applied to leads created through the widget (e.g., "Website Widget") so they appear correctly in your Lead Sources report      |

## Installing the Widget on Your Website

<Steps>
  <Step title="Open the SMS Widget Settings">
    Click **Settings** in the left navigation menu, then click **SMS Widget**.
  </Step>

  <Step title="Configure Your Widget Options">
    Fill in the Button Text, Prompt Text, Brand Color, Routing Number, and Lead Source Tag fields. Preview how the widget will look using the live preview panel on the right side of the page.
  </Step>

  <Step title="Save Your Settings">
    Click **Save** to confirm your configuration. The generated JavaScript snippet below the form will update to reflect your saved settings.
  </Step>

  <Step title="Copy the JavaScript Snippet">
    Click **Copy Code** to copy the generated embed snippet to your clipboard. The snippet is pre-configured with your unique account key and is ready to paste.
  </Step>

  <Step title="Paste the Code into Your Website">
    Open your website's HTML editor or CMS. Paste the snippet just before the closing `</body>` tag on every page where you want the widget to appear. If you want the widget on all pages (recommended), paste it into your site's global footer template.
  </Step>
</Steps>

## Sample Embed Snippet

The example below illustrates what the generated snippet looks like. The actual snippet — with your unique account key already included — is available in **Settings > SMS Widget**. Always copy from there rather than using this example directly.

```html theme={null}
<script src="https://cdn.dealerfunnel.com/sms_widget/YOUR_ACCOUNT_KEY.js"></script>
```

<Note>
  Your account key is embedded directly in the script URL. This key tells Dealer Funnel which account to route conversations to and which phone number to use for replies. Always copy your snippet from the Settings page — it contains your real key pre-populated. Never share your widget key publicly or use it on a website that doesn't belong to your dealership. If you believe your key has been compromised, contact Dealer Funnel support to have it rotated.
</Note>

## Dealer Inspire and DDC Websites

If your website runs on **Dealer Inspire** or **Digital Dealer Cockpit (DDC)**, you don't need to manually paste the snippet into your site's HTML. Use the dedicated integration settings instead:

* **Dealer Inspire:** Contact your Dealer Inspire account manager and provide them with your widget key. They can push the widget to your site through their platform settings without requiring code access.
* **DDC:** Log in to your DDC dashboard, navigate to the plugin or widget management section, and enter your Dealer Funnel widget key. The widget activates site-wide automatically.

If you're unsure which platform your website uses, ask your website vendor or check with your agency admin.

## Testing the Widget

After installation, verify the widget is working correctly before considering it live:

1. Visit your dealership website in a browser. The floating widget button should appear in the lower-right corner of the page.
2. Click the widget button and submit a test message using a real mobile phone number.
3. Check your Dealer Funnel inbox — a new lead conversation should appear within a few seconds.
4. Reply to the test lead from within Dealer Funnel and confirm that the SMS is received on the mobile phone.

If the widget button doesn't appear, confirm the snippet was pasted correctly and that there are no JavaScript errors in your browser's developer console.