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

# Troubleshooting & FAQ

> Common issues, solutions, and frequently asked questions

## Common Issues

### Agent Not Responding Correctly?

<Steps>
  <Step title="Check Knowledge Base">
    Ensure your Knowledge Base has relevant information
  </Step>

  <Step title="Verify Processing">
    Make sure documents are processed (show "Completed")
  </Step>

  <Step title="Review Instructions">
    Review and update your agent instructions
  </Step>

  <Step title="Add FAQs">
    Add more FAQs for common questions
  </Step>
</Steps>

***

### Widget Not Showing on Website?

<Steps>
  <Step title="Verify Embed Code">
    Check the embed code is correct and complete
  </Step>

  <Step title="Check Placement">
    Make sure the script is before `</body>` tag
  </Step>

  <Step title="Check Agent Status">
    Verify your agent is set to "Active"
  </Step>

  <Step title="Clear Cache">
    Clear your browser cache and refresh
  </Step>
</Steps>

***

### Integration Issues?

<Steps>
  <Step title="Reconnect">
    Try disconnecting and reconnecting the integration
  </Step>

  <Step title="Check Permissions">
    Ensure you have the correct permissions
  </Step>

  <Step title="Verify Credentials">
    Check your credentials haven't expired
  </Step>

  <Step title="Contact Support">
    Contact support if issues persist
  </Step>
</Steps>

***

### Can't Login?

<Steps>
  <Step title="Check Credentials">
    Verify your email and password are correct
  </Step>

  <Step title="Reset Password">
    Use "Forgot Password" to reset
  </Step>

  <Step title="Verify Email">
    Verify your email if you haven't already
  </Step>

  <Step title="Clear Cookies">
    Clear browser cookies and try again
  </Step>
</Steps>

***

## Frequently Asked Questions

### General

<AccordionGroup>
  <Accordion title="Is Loopz free to use?" icon="circle-dollar">
    Yes! We offer a free plan with 100 messages per month. Paid plans are available for higher usage.
  </Accordion>

  <Accordion title="What languages does Loopz support?" icon="language">
    Currently English and Arabic, with multiple Arabic dialect options.
  </Accordion>

  <Accordion title="Can I have multiple agents?" icon="robot">
    Yes, you can create multiple agents for different purposes or websites.
  </Accordion>
</AccordionGroup>

### Technical

<AccordionGroup>
  <Accordion title="Will the widget slow down my website?" icon="gauge-high">
    No, the widget loads asynchronously and won't affect page speed.
  </Accordion>

  <Accordion title="Is my data secure?" icon="shield-halved">
    Yes, we use industry-standard encryption and security practices.
  </Accordion>

  <Accordion title="Can I export my conversations?" icon="file-export">
    Contact support for bulk conversation exports.
  </Accordion>
</AccordionGroup>

### Billing

<AccordionGroup>
  <Accordion title="When does my billing cycle reset?" icon="calendar">
    On the same day each month that you subscribed.
  </Accordion>

  <Accordion title="What happens if I exceed my message limit?" icon="triangle-exclamation">
    You'll receive a notification to upgrade. Your agent will pause until the next billing cycle or upgrade.
  </Accordion>

  <Accordion title="Can I cancel anytime?" icon="circle-xmark">
    Yes, you can cancel your subscription at any time from Settings > Billing.
  </Accordion>
</AccordionGroup>

***

## Glossary

| Term               | Definition                                                      |
| ------------------ | --------------------------------------------------------------- |
| **Agent**          | Your AI-powered virtual assistant                               |
| **Knowledge Base** | Information your agent uses to answer questions                 |
| **Widget**         | The chat interface that appears on your website                 |
| **Embed Code**     | JavaScript code that adds the widget to your site               |
| **RAG**            | Retrieval-Augmented Generation - how the AI finds relevant info |
| **Session**        | A single conversation between a customer and your agent         |
| **Deployment**     | Making your agent live and available to customers               |

***

## Contact & Support

<CardGroup cols={2}>
  <Card title="Email Support" icon="envelope" href="mailto:support@loopz.ai">
    [support@loopz.ai](mailto:support@loopz.ai)
  </Card>

  <Card title="Website" icon="globe" href="https://loopz.ai">
    loopz.ai
  </Card>
</CardGroup>

<Info>
  If you encounter bugs or have feature requests, contact our support team.
</Info>