> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vozagent.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Common Issues and Solutions

> Fixes for common VozAgent problems including phone not ringing, assistant not answering, and calendar not syncing.

Here are the most common issues VozAgent users run into, along with step-by-step solutions. If your issue isn't covered here, check out [Getting Support](/help/troubleshooting/getting-support) for how to reach our team.

## My Phone Number Isn't Receiving Calls

**Symptoms:** You call your VozAgent phone number and it doesn't ring, goes to a generic error message, or just disconnects.

**Solutions:**

1. **Check that a phone number is assigned to your assistant.** Go to **Phone System** in the sidebar and make sure your number shows an assistant assigned to it. If it says "Unassigned," click the number and assign your assistant.

2. **Verify the phone number is active.** On the Phone System page, make sure your number's status shows as active. If you recently purchased the number, it may take a minute to become fully provisioned.

3. **Check your subscription status.** VozAgent requires an active subscription to handle calls. Go to **Settings > Billing** to confirm your subscription is active.

4. **Try calling from a different phone.** Occasionally, carrier-level issues can prevent calls from specific numbers. Try calling from a mobile phone or a different line.

> **Tip:** If you just set up your number, wait 2-3 minutes before testing. Phone number provisioning can take a short time to propagate.

## My Assistant Isn't Answering Calls

**Symptoms:** The phone rings but nobody (or nothing) picks up, or you hear ringing that eventually times out.

**Solutions:**

1. **Make sure you have an assistant created.** Go to **Assistants** in the sidebar and verify you have at least one assistant set up. If the page is empty, you'll need to [create an assistant](/help/assistants/creating-an-inbound-assistant) first.

2. **Confirm the assistant is linked to a phone number.** An assistant without a phone number won't receive any calls. Go to **Phone System** and check the assignment. See [Assigning Phone Numbers to Assistants](/help/phone-numbers/assigning-to-assistants) for details.

3. **Review your assistant's configuration.** Open your assistant and make sure the basic settings (business name, greeting, etc.) are filled in. An incomplete configuration may prevent the assistant from starting properly.

## My Calendar Isn't Syncing

**Symptoms:** Your assistant says it can book appointments, but nothing appears on your calendar. Or the assistant can't see your availability.

**Solutions:**

1. **Check your calendar integration.** Go to **Integrations** in the sidebar and verify that your Google Calendar or other calendar service is connected. If the connection shows an error, try disconnecting and reconnecting.

2. **Re-authorize the integration.** Calendar tokens can expire over time. Click on your calendar integration and follow the prompts to re-authorize access.

3. **Verify the correct calendar is selected.** If you have multiple calendars in your Google account, make sure VozAgent is connected to the right one (not a personal calendar when you want your business calendar).

4. **Check for conflicting time slots.** If a caller tries to book during a time that's already blocked on your calendar, the assistant will suggest alternative times. Review your calendar to make sure your availability is accurate.

## Calls Are Ending Too Quickly

**Symptoms:** Your assistant picks up but the call drops after a few seconds, or the caller gets disconnected mid-conversation.

**Solutions:**

1. **Review your call recordings.** Go to **Call Activity**, find the affected call, and listen to the recording. This often reveals whether the issue is with the assistant's behavior or a connection problem.

2. **Check the "Ended Reason" field.** In the call detail view, the ended reason tells you why the call stopped. Common reasons include:
   * **Customer ended call** -- The caller hung up (nothing wrong on your end)
   * **Assistant ended call** -- The assistant determined the conversation was complete
   * **Silence timed out** -- Neither party spoke for an extended period

3. **Review your assistant's greeting and instructions.** If the greeting is confusing or the assistant doesn't clearly identify itself, callers may hang up thinking they reached the wrong number.

## My Contacts Aren't Being Saved

**Symptoms:** You see calls in Call Activity, but the callers aren't appearing in your Contacts list.

**Solutions:**

1. **Check if the contact already exists.** If someone calls from a number that's already in your contacts, a new contact won't be created -- the call is associated with the existing contact instead.

2. **Look at the call detail.** Open the call in Call Activity and check if a contact was linked. The contact name should appear at the top of the call detail.

3. **Verify your caller ID settings.** Some callers use blocked or private numbers. If the caller's phone number isn't available, VozAgent can't create a contact record.

## Dashboard Shows No Data

**Symptoms:** All metrics show zero and the insight panels are empty, even though you've been receiving calls.

**Solutions:**

1. **Check the time range.** The dashboard defaults to "Last 30 days." If your calls happened more than 30 days ago, switch to "Last 90 days" or "This year" using the dropdown in the top-right corner.

2. **Give it a moment.** After a call ends, it takes a short time for the data to process and appear on the dashboard. Try refreshing the page after a minute or two.

3. **Verify calls are completing.** Go to **Call Activity** and check that calls have a "completed" status. Calls that were abandoned or failed may not count toward your analytics.

## Next Steps

* [Call Quality Tips](/help/troubleshooting/call-quality-tips) -- Improve voice clarity and call performance
* [Getting Support](/help/troubleshooting/getting-support) -- Contact VozAgent support for additional help
* [Understanding Your Dashboard](/help/getting-started/understanding-your-dashboard) -- Full overview of the dashboard layout