Configuring xAI Grok for 3CX AI Agents

Introduction

This guide explains how to integrate xAI Grok with 3CX AI Agents for intelligent receptionist and call-handling scenarios.

This feature requires 3CX AI Edition.

Set up an xAI account

If you do not already have an xAI account, create one through the xAI Console and configure billing and appropriate usage limits.

Create an API key

  • In the xAI Console, open API Keys.
  • Click Create API Key.
  • Copy the generated key and store it securely.

Create a management key

  • Open Settings > Management Keys.
  • Create a management key with a descriptive name, such as "3CX-KB".
  • Grant Read & Write access for Collections and Files, then save.
  • Copy the generated management key and store it securely.

Configure xAI Grok in 3CX

In the 3CX Admin Console, go to Admin > Integrations > AI. Click Realtime API and choose xAI Grok.

  • Configure the following settings:
  • API Key: paste the API key created in the xAI Console.
  • Management API Key: paste the management key used for Knowledge Sources.
  • AI Realtime Model: select the Grok realtime model recommended by your 3CX version.
  • AI Text Model: select the Grok text model recommended by your 3CX version.
  • Fill in:
  • Company Name
  • Company Description; this is used by AI Agents to understand your organization’s context.
  • Click the Save button.

Setup AI Agents and Knowledge Sources

For detailed AI Agent setup, see the main 3CX AI Agents Configuration guide.

Technical notes

  • Audio codec: PCMU (G.711 μ-law ). xAI supports G.711 directly over WebSockets, allowing 3CX to pass telephony audio without additional encode/decode conversation.
  • If your account restricts model access, allow the models selected for Realtime and Text in the Realtime API Settings.
  • Ensure the 3CX Firewall Checker passes successfully.
  • Allow outbound traffic on:
  • TCP 443 – secure Websocket connection to the xAI Realtime API.
  • 3CX connects to xAI Realtime using:
  • wss://api.x.ai/v1/realtime

AI models

xAI regularly updates Grok models and may deprecate older versions. 3CX updates its recommendations as supported versions change. Ensure the xAI account can access the models required by your installed 3CX version.

See also

Last Updated
This document was last updated on 20 Aug 2026
https://www.3cx.com/docs/ai-agent-configuration-grok/