Connect the Zotaro chat widget to your website

Overview

The widget on your site calls Zotaro's Chat API, which answers using whatever you've configured in your dashboard — your knowledge base, your functions, and the widget's look and feel. The steps below take you from signup to a live chat bubble, then cover installing that same snippet on WordPress, Blogger, and other site builders.

Just want a contact form, not the full chatbot? Skip straight to the free contact form widget

Installing on WordPress, Blogger, and other platforms

The script tag from Step 03 works anywhere you can add custom code to a page — you're just placing it somewhere platform-specific instead of directly editing an HTML file.

Contact form widget

Separate from the chat widget above, Zotaro also gives out a free embeddable contact-form widget. Any business can use it — you don't need a Zotaro account, a Wizard ID, or a paid plan.

<script
  src="https://www.zotaro.xyz/contact-widget.js"
  data-key="wk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
  data-title="Contact us"
  data-button-text="Send message"
  data-primary-color="#14453D"></script>

Save the page and reload your site — the form should appear, and submissions will start landing in the inbox you registered.

Contact form widget attribute reference

Widget attribute reference

Function examples

call_me

What should the LLM use this for? Use this function when the user requests a phone call, callback, or asks to speak with a human agent. Collect the user's name, phone number, preferred callback time (optional), and reason for the call (optional).

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Customer's full name"
    },
    "phone_number": {
      "type": "string",
      "description": "Customer's phone number with country code if available"
    },
    "preferred_time": {
      "type": "string",
      "description": "Preferred callback time (optional)"
    },
    "reason": {
      "type": "string",
      "description": "Reason for requesting a callback"
    }
  },
  "required": ["phone_number"]
}

schedule_meeting

What should the LLM use this for? Use this function when the user wants to schedule a meeting, book a demo, arrange an appointment, or meet with a team member. Collect the user's name, email, meeting date, meeting time, timezone, meeting topic, duration, and any additional notes.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Full name of the person scheduling the meeting"
    },
    "email": {
      "type": "string",
      "format": "email",
      "description": "Email address for the meeting invitation"
    },
    "date": {
      "type": "string",
      "description": "Meeting date in YYYY-MM-DD format"
    },
    "time": {
      "type": "string",
      "description": "Meeting start time in HH:MM format (24-hour)"
    },
    "timezone": {
      "type": "string",
      "description": "Timezone for the meeting (optional)"
    },
    "topic": {
      "type": "string",
      "description": "Purpose or topic of the meeting"
    },
    "duration": {
      "type": "string",
      "description": "Expected meeting duration, e.g. '30 minutes' (optional)"
    },
    "notes": {
      "type": "string",
      "description": "Additional notes or special requests (optional)"
    }
  },
  "required": ["name", "email", "date", "time", "topic"]
}

Tip: keep function names short and descriptive, and be specific in "What should the LLM use this for?" — that's how the bot decides which function to call and when.

Need help?

If the widget doesn't appear, double-check that widget.js is in the correct directory and that your Wizard ID is pasted without extra spaces. For anything else, reach out through your dashboard or contact our team.

If the free contact-form widget doesn't appear, double-check your widget key is pasted without extra spaces and that you're using the contact-widget.js script, not widget.js — they're separate scripts for separate products. Haven't received your key yet? Allow one business day, or contact our team.