This guide walks you through configuring the RingQ AI Agent with a ChatGPT (OpenAI) account token to enable intelligent, AI-powered conversations within the RingQ platform. You’ll learn how to securely link your ChatGPT account, assign the token to the AI Agent, and ensure proper authorization for message handling and response generation.
1. Login to your RingQ web app using your admin credentials.

AI Agent option in RingQ
2. From the Side Menu Bar, go to Settings > Global Settings > AI Agent.
3. Select the language(s) the AI Agent will recognize and use during conversations. Click the country flag icons to enable one or more languages. The AI Agent will automatically detect and respond using the selected languages.

Add your language and keywords for your ChatGPT AI Agent in RingQ
4. Connect Keywords. Keywords allow RingQ to route calls or trigger actions when specific words are detected. To add a Keyword:
a. In the Connect Keywords section, click the green Add (+) button.

Add your ChatGPT AI Agent Keywords into RingQ
b. The “Add ChatGPT Keyword” window will open. Enter your Keyword(s) in the Keyword field.
c. Click on the Extension field to display the dropdown list.
d. Select the action or destination that will be triggered when the keyword is detected.
e. Click Create to save the keyword.

Voice AI settings for your ChatGPT AI Agent in RingQ
5. AI Voice Selection. Click the Voice dropdown. A list of available AI voices will appear. Select the voice that the AI Agent will use when speaking with callers.

Noise Tolerance Settings for your ChatGPT AI Agent in RingQ
6. Noise Tolerance. This setting controls how much background noise the AI can tolerate during calls.
a. Near – For clear environments with minimal background noise.
b. Far – For noisy environments or calls with background sounds.

Add a custom greeting for your ChatGPT AI Agent in RingQ
7. Custom Greeting. This is the first message callers will hear. Click inside the text field to edit the default message and add your own custom greeting. Click Save.

Add your AI Agent prompts in RingQ
Prompts define how the AI behaves.
1. Go to Prompt (also called System Prompt or Instructions).

Add the AI Agent Context in RingQ
2. Click Edit.
3. Define the AI’s role, tone, and limitations.
4. Click Save.

Add the AI Agent Context in RingQ
This provides the AI with factual reference material.
1. Go to Context.
2. Click Edit.

Add the AI Agent Context in RingQ
3. Enter or paste the information the AI should use.
4. Click Save.
Once all the above sections have been configured, your RingQ AI Voice Agent is now ready to handle live caller interactions. You can begin routing calls, assisting customers, and automating conversations using AI.
To finalise the configuration, proceed to the Settings section.
This section explains how to connect a ChatGPT account token to RingQ so the AI Agent can power voice and chat interactions.

ChatGPT AI Agent settings in RingQ
1. Locate Enable ChatGPT Token.
2. Toggle the switch ON to activate the ChatGPT integration for this tenant.
3. Click inside the ChatGPT Token field.
4. Paste your OpenAI API Key (format: sk-…).
5. Click the eye icon if you need to verify the pasted value. This token allows RingQ to securely connect to your ChatGPT account. Important: Each RingQ tenant can use its own ChatGPT token to track usage and billing independently.
6. Enable Voice Turn this ON to allow the AI Agent to:
7. Click Save in the bottom right corner. RingQ will:
8. Validate the token
9. Connect to ChatGPT
10. Activate AI services for this tenant