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

# Configure GrowthAgent settings

> Set brand voice, guardrails, handoff destinations, localization, AI configuration, and connected accounts.

# 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.