Skip to content

OpenAI (platform credentials)

Zyelra uses a platform OpenAI API key configured by Super Admins. Agencies only enable AI Assistant toggles — no agency OpenAI keys today.

Available with provider requirementsSupported, but an external account or verification is required.

What this connection does

OpenAI powers Zyelra AI Assistant features when the platform has a valid OpenAI credential and your agency has AI enabled. Agencies do not paste OpenAI keys into Settings today.

Before you start

  • Super Admin access to /admin for platform credentials (platform operators only).
  • Agency admins only need Settings → AI Assistant permission to toggle features.

OpenAI API keys (official) ↗

Configure OpenAI

  1. Step 1In provider

    Create a platform API key at OpenAI

    As a platform operator, sign in at platform.openai.com, open API keys, and create a secret key for Zyelra’s platform use. Copy it once — OpenAI will not show the full key again.

  2. Step 2In Zyelra

    Store the key in Super Admin → Integrations → Credentials

    In the Super Admin console, go to Integrations → Credentials (OpenAI provider). Paste the platform API key, save, and run Test if available. Never place this key in agency Settings.

  3. Step 3In Zyelra

    Agency: enable AI Assistant

    Agency admins go to Settings → AI Assistant and enable AI Assistant / AI Actions as needed. No OpenAI key field appears for agencies.

Verify

  1. Super Admin credentials show OpenAI configured / healthy.
  2. Agency Settings → AI Assistant toggles are on.
  3. AI Assistant responds in the agency workspace.

Troubleshooting

  • Agency looking for an API key field — not supported; keys are platform-only.
  • Platform test fails — regenerate key at platform.openai.com and update Super Admin → Integrations → Credentials.
  • AI unavailable for agency — check plan/feature access and Settings → AI Assistant.

Security

Next step

Find setup steps for other messaging, payment, calendar, and channel connections.

Browse more integration guides →

Related guides

  • Integrations overview

    Hub for Zyelra integrations: email, SMS, WhatsApp, calendar, OTAs, guest payments, and AI — plus links to the Developer API and webhooks for custom connections.

  • Anthropic (platform credentials)

    Zyelra uses a platform Anthropic API key configured by Super Admins. Agencies only toggle AI Assistant — no agency Anthropic keys today.

  • Agency BYOK (bring your own key)

    Agency-supplied OpenAI or Anthropic API keys are not available yet. AI uses platform credentials only.

  • AI in Zyelra

    How agencies use Zyelra AI Assistant for workspace help — without managing agency API keys.

  • Enable AI Assistant

    Turn on AI Assistant and AI Actions under Settings → AI Assistant for your agency.