Skip to main content

Overview

BoostGPT supports four trigger types, each suited for different scenarios:
TypeBest ForVisibility
ButtonGeneral help, persistent CTAMedium - floating button
ToastConversational, friendly outreachHigh - chat bubble with avatar
BannerUrgent/important messagesVery High - full-width strip
InlineContextual help in specific areasLow - embedded in page

Button Type

A floating action button in one corner of the screen.
boostgpt.trigger('help', {}, {
  type: 'button',
  position: 'bottom-right',
  buttonText: 'Need help?',
  buttonColor: '#7788BB',
  textColor: '#FFFFFF',
  showIcon: true
});

When to Use

  • General “get help” functionality
  • Persistent availability indicator
  • Minimal intrusion
  • E-commerce checkout pages
  • Settings/configuration pages

Button Options

OptionDefaultDescription
buttonText”Need help?”Button label
buttonColor”#7788BB”Background color
textColor”#FFFFFF”Text color
showIcontrueShow chat icon
borderRadius”50px”Border radius (pill shape)
fontSize”14px”Text size
fontWeight”600”Text weight
padding”12px 20px”Internal spacing
boxShadow”0 4px 12px rgba(0,0,0,0.15)“Shadow

Toast Type

A chat bubble that looks like a message from your agent.
boostgpt.trigger('onboarding_stuck', {}, {
  type: 'toast',
  position: 'bottom-right',
  title: 'Support Bot',
  message: 'Looks like you might be stuck. Need a hand?',
  toastBackground: '#ffffff',
  toastTextColor: '#374151'
});

Stacked Messages

Create a conversational feel with multiple bubbles:
boostgpt.trigger('welcome', {}, {
  type: 'toast',
  messages: [
    'Hey there! 👋',
    'I noticed you\'re checking out our pricing.',
    'Have any questions? I\'m here to help!'
  ]
});

When to Use

  • Friendly, conversational outreach
  • Onboarding assistance
  • Feature discovery
  • When personalization matters
  • Higher engagement needed

Toast Options

OptionDefaultDescription
message”Need help?…”Single message text
messagesnullArray of messages (stacked)
avatarnullAvatar URL (uses agent’s if null)
titlenullName shown (uses agent’s if null)
toastBackground”#ffffff”Background color
toastTextColor”#374151”Text color
buttonColor”#7788BB”Action button color
A full-width notification strip at the top or bottom of the page.
boostgpt.trigger('sale_help', {}, {
  type: 'banner',
  position: 'top',
  bannerText: 'Questions about our summer sale? Chat with us!',
  bannerColor: '#10B981',
  bannerTextColor: '#FFFFFF',
  buttonText: 'Ask Now'
});

When to Use

  • Time-sensitive announcements
  • Site-wide promotions
  • Important notices
  • High-visibility needed
  • Urgent support availability
OptionDefaultDescription
bannerText”Need help?…”Message text
bannerColor”#7788BB”Background color
bannerTextColor”#FFFFFF”Text color
bannerPadding”14px 20px”Internal spacing
buttonText”Chat Now”CTA button text
position”top""top” or “bottom” only

Inline Type

Renders inside a specific container element on your page.
<!-- Your page -->
<div class="help-section">
  <p>Having trouble? We're here to help.</p>
  <div id="help-button"></div>
</div>

<script>
boostgpt.trigger('section_help', {
  section: 'billing'
}, {
  type: 'inline',
  container: '#help-button',
  buttonText: 'Chat with Support',
  buttonColor: '#4F46E5'
});
</script>

When to Use

  • Contextual help for specific sections
  • Embedded in existing UI
  • Form assistance
  • FAQ supplements
  • Documentation pages

Inline Options

OptionDefaultDescription
containernullCSS selector or DOM element
buttonText”Need help?”Button label
buttonColor”#7788BB”Background color
textColor”#FFFFFF”Text color
showIcontrueShow chat icon
borderRadius”8px”Border radius
fontSize”14px”Text size
padding”12px 20px”Internal spacing

Comparison Table

FeatureButtonToastBannerInline
VisibilityMediumHighVery HighLow
IntrusivenessLowMediumHighNone
PersonalizationLowHighMediumMedium
Position Flexibility4 corners4 cornersTop/BottomAny element
Best EngagementGeneralConversationalUrgentContextual
Multiple InstancesNoNoNoYes

Choosing the Right Type

Use Button. It’s unobtrusive but always visible.
Use Toast. The conversational format feels personal and inviting.
Use Banner. High visibility ensures users see it.
Use Inline. Embed help exactly where users need it.

Next Steps