Configure call and chat settings for a Ringg AI agent

In the dashboard: Agents (listed under Assistants in the sidebar) → open an agent → Call Settings → Call or Chat. On a multi-prompt agent it is Global Settings → Call or Chat; on a WhatsApp agent, Calls → Settings and Chat → Settings. Switches and menus save as soon as you change them. Noise Suppression Level and Exit Timing save when you leave the field or press Enter. Custom message, Exit Message and the rate-limit fields have their own Save button. This chapter is the settings around the prompt and what comes out of each conversation:

Page	What you set
Call settings (this page)	Duration, inactivity timeouts, calling window, voicemail, interruption sensitivity, rate limits and chat session timeouts
Advanced Analysis	The typed variables Ringg extracts after each conversation, and the goal
Event Subscription	The call, chat and analysis events Ringg sends to your server
Webhooks, Webhook payloads	The endpoint side: subscribe by API, retries and errors, and the JSON for each call and chat event

Before you start

An agent

The agent whose call or chat behaviour you are setting.

A workspace call limit

Optional: needed only for Maximum calls to one person.

Which sections an agent shows

On a single-prompt agent, the Call page depends on the agent type. “Outbound” includes Outbound-Inbound agents.

Section	Outbound	Inbound	Webcall, WhatsApp
Call limits	Yes	No	No
Call duration	Yes	Yes	Yes
Calling window	Yes	No	No
Voicemail	Yes	Yes	No
Rate Limiting	No	Yes	No
Interruption sensitivity	Yes	Yes	Yes
Other settings	Yes	Yes	Yes

Every multi-prompt agent shows the outbound set (no Rate Limiting), in a compact list without section headings or helper text.

Changing call duration, inactivity, calling window, voicemail and interruption sensitivity

Call limits

Maximum calls to one person caps how often this agent may call the same person: No limit, or 1 call up to the workspace limit (50 at most). It can only tighten the workspace limit and uses the same period. With a workspace limit of 10 calls per 24 hours, setting 3 shows “Call one person up to 3 times in any 24-hour period.” With no workspace limit, the field is disabled and the link under it reads Set limit. No limit means the agent follows the workspace limit. See Per-agent limits. The limit applies to the agent’s outbound calls however they start: campaigns, API calls and workflows. Dashboard test calls are never held by it.

Call duration

Control	Values
Maximum Call Duration	2 to 20 minutes. The call ends at this length.
Inactivity Warning	Off (no warning), or 3, 5, 7, 10, 15, 20, 25 or 30 seconds of silence before the agent checks in
Inactivity Duration	10 to 60 seconds, in steps of 5. The call ends after this much silence.
Timezone	The zone the calling window is read in. Default IST (UTC+5:30).
Noise Filtering	On or off. Noise Suppression Level (0 to 100, default 80) shows when it is on.

The menu offers only warnings shorter than the inactivity duration. If you lower the duration to or below the current warning, the warning drops to the highest value still allowed: a 15-second warning with a 15-second duration becomes 10 seconds. Timezone offers IST, EST, CST, MST, PST, GMT, CET (Paris), CET (Berlin), GST, SGT, JST, AEST, NZST and UTC.

Call duration section with Maximum Call Duration 7 minutes, Inactivity Warning 15 seconds, Inactivity Duration 30 seconds, Timezone IST (UTC+5:30) and Noise Filtering on at level 80 — Call duration settings

Calling window

The hours an outbound agent may dial, in its Timezone. Call start time takes whole hours from 00:00 to 23:00; Call end time takes a later hour, up to 23:59. 00:00 to 23:59 means no restriction. An overnight window such as 22:00 to 06:00 can be set only through the API; the dashboard shows it and keeps it. An individual API call can send its own call_time: each key it sends replaces the agent’s value, and keys it leaves out keep the agent’s. A campaign always uses its own window instead of the agent’s; a campaign started by API without call_time calls from 09:00 to 21:00 IST.

Voicemail

Control	Values
Voicemail detection	On or off
Leave voicemail message	Off: “Assistant will end the call.” On: the agent leaves a summary of the call, or your custom message.
Custom message	Shown when Leave voicemail message is on. Played word for word instead of the summary; leave it empty to go back to the summary.
Retry call	On or off: retry the call when voicemail is detected, while the call has retries left

New single-prompt agents start with Voicemail detection and Retry call on; new multi-prompt agents start with both off. The agent detects voicemail during the call only while the caller’s audio is silenced: during the first message when Interruptible is off, or while the agent speaks when Silence callee when assistant is speaking is on (Other settings).

Voicemail section with Voicemail detection on, Leave voicemail message on with an Add button for a custom message, and Retry call on — Voicemail settings

Rate limiting (inbound)

Rate limiting stops one caller from calling an inbound agent over and over. Switching on Enable rate limiting starts with Terminate Call at 3 calls per hour; change the fields, then click Save.

Control	Values
Action	Terminate Call or Transfer Call
Max calls per hour	1 or more; default 3
Transfer to	A phone number; required for Transfer Call
Whitelisted numbers	Numbers that are never rate-limited

Interruption sensitivity

How easily the caller’s voice cuts the agent off mid-sentence: this is the agent’s voice activity detection () threshold. Pick Strict for noisy lines where background sounds keep stopping the agent, and Sensitive if callers feel the agent talks over them.

Option	Behaviour
Sensitive	The agent yields as soon as the caller starts speaking.
Default	Short sounds like “hello” or “hmm” don’t cut the agent off.
Strict	The caller has to keep speaking before the agent stops.

New agents start on Default.

Other settings

Control	What it does
Silence callee when assistant is speaking	Ignores the caller’s voice whenever the agent speaks.
Silence callee during assistant’s introduction	Multi-prompt agents only: the same during the first message. On a single-prompt agent this is the Interruptible switch next to First message (The Interruptible switch).
Enable background audio	Plays office ambience under the agent’s voice. Loop Audio (on by default) repeats it for the whole call; Volume goes from 0 to 100 in steps of 10, default 100.
Enable graceful exit warning	Plays a message shortly before Maximum Call Duration is reached, then ends the call. It doesn’t play before an inactivity hang-up. Exit Timing (seconds) is how long before the end, at least 1, default 12. Exit Message takes one line per agent language, such as “We’re almost out of time, so I’ll wrap up now.”

Chat settings

The Chat page shows Chat Duration on every agent except WhatsApp agents. WhatsApp agents show WhatsApp session instead: see Set the session timeouts. Chat Duration applies to every text chat in an embedded widget and every Live chat test. Voice web calls use the call settings above.

Control	Values
Maximum call length (seconds)	120 to 1,200, in steps of 120
Idle Timeout Warning (seconds)	10 to 60 in steps of 5, then 90 and 120
Idle Timeout End (seconds)	10 to 60 in steps of 5, then 90 and 120

Do this with the API

Create Agent (POST /public/agent) takes these settings in call_config. Any key you leave out takes its default. You need an API key.

object

Show properties

object

Calling window: call_start_time and call_end_time as HH:MM (the window may cross midnight), and timezone as an IANA zone such as Asia/Kolkata.

integer

default:"240"

Seconds, 10 to 3,600.

integer

default:"5"

Seconds of silence before the agent checks in. 0 turns it off.

integer

default:"10"

Seconds of silence before the call ends. Must be greater than idle_timeout_warning.

object

filter_noise (default false) and noise_suppression_level (0 to 100, default 80).

object

detect (default true), action (end, summarise or static_message; default end), retry (default true) and static_message, the text spoken when action is static_message.

object

audio_id (office_ambience), volume (0.0 to 1.0), mixing and loop. Omit it to keep background audio off.

boolean

true means the caller cannot interrupt the first message.

cURL

curl -X POST https://prod-api.ringg.ai/ca/api/v0/public/agent \
  -H "X-API-KEY: $RINGG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_name": "Payment reminder",
    "introduction_and_objective": "You are Riya, calling customers of Acme Finance about an upcoming EMI.",
    "response_guidelines": "Be polite and brief. Confirm the due date before ending.",
    "task": "Remind the customer of their EMI due date and ask when they will pay.",
    "primary_language": "en-IN",
    "voice_id": "857e1b18-0adb-4b3e-b150-ce7896a16bf1",
    "intro_message": "Hello, this is Riya from Acme Finance. Am I speaking with the account holder?",
    "agent_type": "outbound",
    "call_config": {
      "max_call_length": 300,
      "idle_timeout_warning": 7,
      "idle_timeout_end": 15,
      "call_time": { "call_start_time": "10:00", "call_end_time": "19:00", "timezone": "Asia/Kolkata" },
      "voicemail": { "detect": true, "action": "end", "retry": true }
    }
  }'

To override settings for one call, send call_config (max_call_length, idle_timeout_warning, idle_timeout_end, call_time, call_retry_config) with Initiate Individual Call. On an existing agent, Edit Assistant changes these:

Operation	Sets
`edit_chat_settings`	`chat_settings.whatsapp_session` (`idle_timeout_minutes` 5 to 1,440, `max_duration_minutes` 60 to 10,080)
`edit_vad_settings`	Interruption sensitivity: `vad_settings.interruption_sensitivity` is `default`, `sensitive` or `strict`
`edit_noise_settings`	The two silence switches: `mute_during_intro` and `mute_while_bot_speaking`, both required

Other call settings on an existing agent are changed in the dashboard.

Verify it worked

Test the agent with a phone call and stay silent. The agent should check in at the Inactivity Warning time and hang up at the Inactivity Duration. Open the call in Logs to check its duration and how it ended.

Troubleshooting

The agent keeps getting cut off mid-sentence

Background noise or short sounds on the caller’s side are being heard as speech. Set Interruption sensitivity to Strict; if callers still can’t be heard over the agent, switch on Silence callee when assistant is speaking under Other settings. To stop interruptions during the greeting only, turn off the first message’s Interruptible switch (Prompt).

Calls are not going out at night

Check the calling window and the Timezone it is read in. Outside the window an outbound call is not dialled immediately. A campaign’s calls follow the campaign’s calling window, not the agent’s.

Build agents

Inventory

Deploy

Monitor

Manage account

Ringg Labs

Call settings

Before you start

An agent

A workspace call limit

Which sections an agent shows

Call limits

Call duration

Calling window

Voicemail

Rate limiting (inbound)

Interruption sensitivity

Other settings

Chat settings

Do this with the API

Verify it worked

Troubleshooting

Next steps

Extract data with Advanced Analysis

Run a campaign

​Before you start

An agent

A workspace call limit

​Which sections an agent shows

​Call limits

​Call duration

​Calling window

​Voicemail

​Rate limiting (inbound)

​Interruption sensitivity

​Other settings

​Chat settings

​Do this with the API

​Verify it worked

​Troubleshooting

​Next steps

Extract data with Advanced Analysis

Run a campaign

Before you start

Which sections an agent shows

Call limits

Call duration

Calling window

Voicemail

Rate limiting (inbound)

Interruption sensitivity

Other settings

Chat settings

Do this with the API

Verify it worked

Troubleshooting

Next steps