> For the complete documentation index, see [llms.txt](https://help.calshare.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.calshare.net/troubleshooting.md).

# Troubleshooting

Quick answers and step-by-step guides for common issues.

<details>

<summary>1. I cannot find a "Forgot Password" or password recovery link</summary>

**Answer / Explanation:** Calshare does not have a "Forgot Password" feature because it operates on a secure **Passwordless Social Authentication** system (Google, Facebook, and Apple).

Since we do not store password hashes on our servers, there are no passwords inside Calshare to leak or guess. To reset your password, you must change the password on your identity provider's dashboard (e.g. Google Account Settings, Facebook Settings, or Apple ID account pages).

</details>

<details>

<summary>2. WhatsApp QR Code is not generating or loads infinitely</summary>

**Cause:** Connection timeout on web socket streams or a hanging connection container in the server background.

**Resolution:** Refresh the page. If the QR code still does not generate, click the **Force Restart Connection Service** button in the WhatsApp panel. This stops the background process and restarts pairing.

</details>

<details>

<summary>3. The AI Assistant is connected but not responding to client messages</summary>

**Cause:** The Gemini API Key might have incorrect characters, or the quota limit of your AI Studio Key has been exceeded.

**Resolution:** Go to the **WhatsApp & AI** menu. Check that your API key is correctly typed. Verify on your Google AI Studio Dashboard if the API quota is exhausted. Replace it with a new key and save changes.

</details>

<details>

<summary>4. Clients report that no slots are available on the calendar grid</summary>

**Cause:** Timezone mismatch, lack of work hours configured, or conflicting scheduled events blocking the availability grid.

**Resolution:** Edit your calendar settings. Confirm you have activated the correct days of the week, set valid start/end times, and aligned the timezone configuration with your local server location.

</details>

<details>

<summary>5. Custom link says "Slug Unavailable" when saving a calendar</summary>

**Cause:** Another user in the Calshare system has already registered the same keyword suffix.

**Resolution:** Edit the **Custom Link (Slug)** and append numbers or your business location (e.g., change `drjohn` to `drjohnnyc`). Save settings again.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.calshare.net/troubleshooting.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.