Skip to main content

Configure GrowthAgent settings

What does this do for me?

Settings control how the assistant sounds, what rules it follows, where it sends conversations that need human help, and what languages it supports. Open Settings from the app navigation to configure each section. Changes use Shopify’s Contextual Save Bar — change a field, then use Save or Discard. Inline messages identify invalid values. Discard restores saved values and clears error messages.

Brand & guardrails

Set the customer-facing brand voice that the assistant uses, and add additional guardrails with rules the assistant must follow.

Handoff

Choose where to receive conversations that need human support:
  • Email address (required for handoff)
  • HTTPS webhook URL (optional)
  • SMS number (optional) — requires a connected Twilio account
  • Fax number (optional) — requires your Sinch fax service to be enabled
Handoff tickets record the reason, summary, shopper contact (when supplied), priority, and destination.

Localization

Enter structural BCP 47 locale codes separated by commas, for example en, fr-CA, es-419, or zh-Hant-TW. Private-use tags such as x-private are also accepted. Malformed tags such as en-1 are rejected inline and by the API. The assistant answers in a shopper’s locale when it is in the supported list and falls back to the default locale otherwise.

AI configuration

Choose the response policy (Balanced, Strict, or Most strict), the API key source (managed or your own OpenAI key), and optionally enter your own OpenAI API key. The key source controls which key the assistant uses for answers.

Connected accounts

Connect your own provider accounts. Provider secrets are encrypted, never displayed again, and can be replaced or cleared from Settings:
  • Algolia — for external search indexing of knowledge documents (Pro plan)
  • Twilio — for SMS handoff notices
  • ElevenLabs — for voice playback of assistant answers
A complete merchant connection takes precedence over platform-managed credentials. If the provider binding is not enabled for your shop, the UI indicates the feature is not yet available.

Plan and billing

View your current plan and switch between Starter and Pro. The plan selector shows labels and prices from the app configuration.