Testing Your Agent

Before publishing your agent's phone number, run through a quick round of test calls to make sure the greeting, FAQs, integrations, and forwarding all work as expected.

Pre-test checklist

Item	Where to verify
Agent saved	Agent Setup page shows your agent
Phone number assigned	Phone Number tab shows green "Active"
Greeting written	Agent Setup → Greeting field
System prompt complete	Agent Setup → System Prompt field
Forwarding number set (if using)	Agent Setup → Call Rules tab
Integrations connected (if using)	Agent Setup → Integrations section

SDK dialer (no phone needed)

If you installed the @oncallclerk/sdk, you already have a browser-based test dialer. It lets you talk to your agent through your microphone, no phone call required.

# macOS
open node_modules/@oncallclerk/sdk/src/dialer.html

# Windows
start node_modules/@oncallclerk/sdk/src/dialer.html

# Linux
xdg-open node_modules/@oncallclerk/sdk/src/dialer.html

Paste your agent ID, click Call, grant microphone permission, and you're connected. The dialer shows a live transcript in real time.

Pre-fill the agent ID

Append ?agentId=YOUR_AGENT_ID to the dialer URL to skip the copy-paste step.

See the full SDK dialer reference for programmatic usage.

Basic call test

Use your personal phone (not the forwarding number) and dial the agent's OnCallClerk number. Listen to the full greeting and then hold a short conversation. You're checking three things:

1. Voice quality, clear audio, no static or echo, natural-sounding speech.
2. Accuracy, correct business name, hours, services, and FAQ answers.
3. Flow, conversation feels natural, agent doesn't repeat itself or lose context.

Ask a few common questions ("What are your hours?", "Where are you located?", "How much does X cost?") and at least one question the agent doesn't have an FAQ for, it should gracefully admit it doesn't know rather than fabricate an answer.

Integration tests

Google Calendar

Ask the agent to book an appointment, pick a time, and give your name. After the call, open your Google Calendar and verify the event exists with the correct details.

Google Sheets

Make a test call where you provide your name and email. After hanging up, open the connected sheet and confirm a new row was created with the right data.

Call forwarding

Say "I need to speak with someone" or "Transfer me." Your forwarding number should ring. If it goes unanswered, verify the number format includes the country code (e.g. +13055551234).

Edge cases worth testing

Try interrupting the agent mid-sentence, asking two questions at once, and calling from a noisy environment. Have a colleague with a different accent make a test call too. These scenarios surface issues that standard scripted tests miss.

After testing

Open Transcripts in the sidebar and review each test call. Look for misunderstood questions, incomplete answers, or phrasing that sounds off. Use what you find to refine your system prompt and add new FAQs, then re-test.

Going live

Once you're satisfied, update your website, Google Business listing, and any marketing materials with the new phone number. Monitor the first handful of real calls closely and keep tweaking.

Ongoing testing

Make a quick test call after every major setting change. A monthly "mystery caller" test (by you or a colleague) is a great habit for catching drift over time.

Troubleshooting

Agent not answering? Verify the phone number is assigned and active, the agent status is enabled, and your subscription is current.

Poor audio quality? Try calling from a different phone and location. If the problem persists, contact support with specifics.

Wrong or fabricated answers? Tighten your system prompt with more explicit instructions and add FAQs for the problem questions.

Forwarding loops? Make sure the forwarding number is different from the agent's own number. Check that the destination phone is reachable.