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

# GHL Integration

> GHL Integration lets Voicemetrics connect seamlessly with your clients’ GoHighLevel (GHL) accounts, enabling branded AI voice workflows fully synced with their CRM — ensuring a smooth, scalable experience for agencies managing multiple clients.

## **Methods to Connect Your GHL Account with Voicemetrics**

<CardGroup cols={2}>
  <Card title="GHL Client Import" icon="file-import" color="#034737">
    * Import clients from GHL
    * Sync client automatically
    * Verify the client as a sub-account
  </Card>

  <Card title="GHL Settings" icon="gear">
    * Install from Marketplace
    * Enable Custom Menu
    * Sync CRM Data
  </Card>
</CardGroup>

## **GHL Client Import**

<Warning>
  Ensure the client is a **sub-account** in your GHL Panel before importing.
</Warning>

<Steps>
  <Step title="Add a New Client via GHL">
    * Log in to your **Voicemetrics Agency Panel**.
    * Go to **Clients → Add New Client**.
    * Click **GHL Client Import**.

          <img src="https://mintcdn.com/voicemetrics-47a09903/c34RQ5XlOO0RkZrt/images/ghl2.png?fit=max&auto=format&n=c34RQ5XlOO0RkZrt&q=85&s=766bf35b2d99acbac44c93b6b68fe9c1" alt="Ghl2 Pn" width="1920" height="1080" data-path="images/ghl2.png" />
  </Step>

  <Step title="GHL Permissions">
    * Install **GoHighLevel (GHL)** from the Marketplace.
    * Enable **“Voicemetrics Call”** and click **Proceed**.
    * Select your client (must be listed as a **Sub-account** in GHL).

          <img src="https://mintcdn.com/voicemetrics-47a09903/hk-fCvv9tnO9cqep/images/ghl1.png?fit=max&auto=format&n=hk-fCvv9tnO9cqep&q=85&s=79a504dfd2a2520b5194c35a12ea4ef3" alt="Ghl1 Pn" width="1920" height="1080" data-path="images/ghl1.png" />
  </Step>
</Steps>

## **GHL Settings**

<Steps>
  <Step title="Connect to GHL">
    * Log in to your **Voicemetrics Agency account**.

    * Go to **Client Accounts → Open desired Client → GHL Settings**.

    * Click **Connect to GHL**.

          <img src="https://mintcdn.com/voicemetrics-47a09903/ozlonTqeV_mFM7sy/images/ghl5.png?fit=max&auto=format&n=ozlonTqeV_mFM7sy&q=85&s=06bf53bc3f442e13f17edeb13935721f" alt="Ghl5 Pn" width="1920" height="1080" data-path="images/ghl5.png" />

    * Install **GHL** from the Marketplace.

          <img src="https://mintcdn.com/voicemetrics-47a09903/6idSWEu8E48umMvc/images/Screenshot(98).png?fit=max&auto=format&n=6idSWEu8E48umMvc&q=85&s=b64e6aa4cea48493a0f89301765c6b40" alt="Screenshot(98) Pn" width="1920" height="1080" data-path="images/Screenshot(98).png" />

    * Enable **“Voicemetrics Call”** and click **Proceed**.

    * Select your client listed as a **Sub-account** in GHL.

          <img src="https://mintcdn.com/voicemetrics-47a09903/hk-fCvv9tnO9cqep/images/ghl1.png?fit=max&auto=format&n=hk-fCvv9tnO9cqep&q=85&s=79a504dfd2a2520b5194c35a12ea4ef3" alt="Ghl1 Pn" width="1920" height="1080" data-path="images/ghl1.png" />

    <Note>
      Keep both **Voicemetrics** and **GHL** open in two tabs of the same browser for a quick setup.
    </Note>
  </Step>

  <Step title="Custom Menu Link">
    * In the **Voicemetrics Agency account**, go to **Client Accounts → GHL Settings**.
    * Copy the **Custom Menu Link URL**

    <Tip>
      For example: [https://ai.voiceagent.ai/#/embed/\&locationid=\{\{location.id}}\&allow=\&u=\{\{user.name}}\&c=\{\{user.email}}](https://ai.voiceagent.ai/#/embed/\&locationid=\{\{location.id}}\&allow=\&u=\{\{user.name}}\&c=\{\{user.email}})
    </Tip>

    <img src="https://mintcdn.com/voicemetrics-47a09903/ozlonTqeV_mFM7sy/images/ghl6.png?fit=max&auto=format&n=ozlonTqeV_mFM7sy&q=85&s=677285cdb90b3e7c546d22c34cbd4159" alt="Ghl6 Pn" width="1920" height="1080" data-path="images/ghl6.png" />

    * In **GHL**, go to **Settings → Custom Menu Links**.
      * Click **Create New** and:
      * Choose an icon and name.
      * Paste the copied URL.
      * Enable **“Allow Microphone”**.
      * Select all sub-accounts.

    <Note>
      **All GHL CRM users can now access Voicemetrics inside GHL.**
    </Note>
  </Step>

  <Step title="Sync Call Logs & Contacts">
    In **Voicemetrics → GHL Settings**, enable:

    * Auto-Create New Contact in GHL CRM
    * Auto-Sync Call History to GHL CRM
    * Log Call Summary as Notes
    * Auto-Sync GHL Contacts

    You can also:

    <Check>
      Set **Sync Frequency** (e.g., every 1 hour)
    </Check>
  </Step>

  <Step title="Field Mapping">
    <Warning>
      Mapping options appear only if at least one contact exists in GHL CRM.
    </Warning>

    * Click **Add Field** to map additional contact fields.
    * Ensure accurate field mapping for precise data sync between Voicemetrics and GHL.

          <img src="https://mintcdn.com/voicemetrics-47a09903/ozlonTqeV_mFM7sy/images/ghl9.png?fit=max&auto=format&n=ozlonTqeV_mFM7sy&q=85&s=6586a1c91801ed3b38086c6c0db36670" alt="Ghl9 Pn" width="1920" height="1080" data-path="images/ghl9.png" />
  </Step>
</Steps>

## **FAQs**

<AccordionGroup>
  <Accordion title="Do I need to log in with the main GHL account or sub-account?">
    Log in with your **sub-account**. You’ll see the Voicemetrics menu inside.
  </Accordion>

  <Accordion title="Can I use the custom menu link for multiple client accounts?">
    Yes. A one-time setup of the custom menu link works for all clients in GHL.
  </Accordion>

  <Accordion title="How often does the contact sync run?">
    You can set your preferred sync frequency (e.g., every 1 hour).
  </Accordion>

  <Accordion title="What if there are no contacts in GHL CRM?">
    Field mapping appears only after at least one contact exists in GHL.
  </Accordion>

  <Accordion title="How do I ensure call logs sync correctly?">
    Turn on **Auto-Sync Call History** and **Log Call Summary as Notes**.
  </Accordion>
</AccordionGroup>
