Configure in Web App

Introduction

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.

Customizing your RingQ AI Agent

From the side menu bar, go to Settings > Global Settings > AI Agent.

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.

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.

b. The “Add ChatGPT Keyword” window will open. Enter your keyword(s) in the Keyword field.

c. Click 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.

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

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.

Prompt (AI Instructions)

Prompts define how the AI behaves.

Go to Prompt (also called System Prompt or Instructions).

Click Edit.

Define the AI’s role, tone, and limitations.

Click Save.

Prompt Template

Role: “You are a helpful RingQ support agent.”
Scope: “Answer questions about plans, onboarding, basic IP phone setup, and billing.”
Tone: “Concise, friendly, and professional.”
Escalation: “If unsure, ask clarifying questions; if still uncertain, escalate to a human.”
Formatting: “Use short paragraphs and bullet points.”
Do not: “Do not guess passwords or expose internal admin URLs.”

Context (Knowledge Base)

This provides the AI with factual reference material.

Go to Context.

Click Edit.

Enter or paste the information the AI should use.

Click Save.

What to Include in Context

Business hours, holidays, and time zone
Product names, versions, and common fixes
Billing rules (refunds, upgrades, payment status)
Links or summaries of help articles and guides
Keep all information accurate and up to date.

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.

ChatGPT Token Setup

This section explains how to connect a ChatGPT account token to RingQ so the AI Agent can power voice and chat interactions.

Locate Enable ChatGPT Token.

Toggle the switch ON to activate the ChatGPT integration for this tenant.

Click inside the ChatGPT Token field.

Paste your OpenAI API key (format: sk-…).

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.

Enable Voice. Turn this ON to allow the AI Agent to:

Answer phone calls
Speak with callers
Use AI-generated voice responses
Enable Chat. Turn this ON to allow the AI Agent to:
Respond to web chat
Handle WhatsApp, Facebook, and SMS (if enabled)
Provide AI-powered messaging.

Click Save in the bottom-right corner. RingQ will:

Validate the token

Connect to ChatGPT

Activate AI services for this tenant