Text

Customize the text displayed in the widget to match your product’s voice and terminology.

Custom text

Pass a text object to override default messages. You only need to specify the text you want to change.

const voltai = Voltai.load({
  apiKey: 'your-api-key',
  text: {
    guestLimitDescription: 'Sign in to continue chatting with our AI assistant.',
    supportTicketNote: 'Our team replies within one business day.'
  }
});

Available text options

Property	Description
`guestLimitDescription`	Message shown when a guest user reaches their usage limit
`supportTicketNote`	Note beside the support ticket form’s submit button (requires `enableSupportTicket`). Default: “Please allow up to 48 hours for a response”.
`supportTicketDescription`	Note under the support ticket form’s title (requires `enableSupportTicket`). If omitted, no note is shown.
`supportTicketAcknowledgement`	Label of the support ticket acknowledgement checkbox. Only shown with `requireSupportTicketAcknowledgement`

Support ticket description

Use text.supportTicketDescription to tell users what is sent with their ticket.

const voltai = Voltai.load({
  apiKey: 'your-api-key',
  enableSupportTicket: true,
  text: {
    supportTicketDescription: 'Your conversation with our assistant will be shared with our support team to help them understand your inquiry.'
  }
});

If the user has a conversation open when they submit, the ticket email links to it. A ticket sent outside a conversation carries no link. Use the top-level initialMessage option to show a dismissible popup the first time an unauthenticated user (guest or signed-out) opens the widget. The popup uses your widget title as the heading and an OK button to dismiss.

const voltai = Voltai.load({
  apiKey: 'your-api-key',
  title: 'Support Chat',
  initialMessage: 'Welcome! Please sign in to get the full functionality of our assistant.'
});

If initialMessage is omitted, no popup is shown. The popup is shown at most once per page load — once dismissed, it will not reappear until the page is reloaded.

Support ticket acknowledgement

With enableSupportTicket, set requireSupportTicketAcknowledgement to add a checkbox above Submit Ticket, for example to confirm a request is within your support scope. The ticket can’t be submitted until the checkbox is ticked. Set its label with text.supportTicketAcknowledgement. Markdown links ([label](https://…)) in the label open in a new tab; only http and https URLs become links. Without a label, the widget shows: “I understand the scope of support and confirm my request falls within it.”

const voltai = Voltai.load({
  apiKey: 'your-api-key',
  enableSupportTicket: true,
  requireSupportTicketAcknowledgement: true,
  text: {
    supportTicketAcknowledgement:
      'My request is within the scope of support as described [here](https://example.com/support-scope).'
  }
});

Getting Started

Configuration

Guides

Custom text

Available text options

Support ticket description

Support ticket acknowledgement

​Custom text

​Available text options

​Support ticket description

​Initial message popup

​Support ticket acknowledgement

Custom text

Available text options

Support ticket description

Initial message popup

Support ticket acknowledgement