Skip to main content

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.

The GoHighLevel (GHL) integration connects your VozAgent account to your GHL location so contacts, appointments, and tags stay in sync. Your AI assistant can book directly to your GHL calendar, push new contacts from calls, and track leads through your pipelines.

​
What the GoHighLevel Integration Does

The integration provides three main capabilities:

​
Contact Sync

  • Bidirectional contact sync — contacts flow between VozAgent and GoHighLevel in both directions
  • Automatic sync on new contacts — new contacts from calls can be pushed to GHL automatically
  • Manual refresh available — trigger a sync at any time with the Sync Contacts button
  • VozAgent tag added to synced contacts — all contacts synced from VozAgent are tagged with a “vozagent” tag in GHL for easy identification

​
Calendar Booking

  • Book to GHL calendar — your AI assistant can schedule appointments directly on your GoHighLevel calendar during calls
  • Real-time availability check — the assistant checks your calendar availability before offering time slots
  • Automatic confirmations — callers receive confirmation when an appointment is booked
  • Works during AI calls — booking happens live while the assistant is on the phone with the caller

​
Tag Sync

  • Bidirectional tag sync — tags are kept in sync between VozAgent and GHL
  • Tags added in VozAgent push to GHL — when you tag a contact in VozAgent, the tag appears in GHL
  • Tags deleted in GHL sync back — removing a tag in GHL is reflected in VozAgent
  • “vozagent” tag auto-added — a “vozagent” tag is automatically applied to all synced contacts

​
How to Connect

Connecting GoHighLevel requires a Private Integration Token and Location ID from your GHL account. The setup uses a step-by-step wizard with four stages.

​
Step 1: Get Your API Credentials

Before starting the connection in VozAgent, you need two pieces of information from GoHighLevel:
  1. Private Integration Token — In GHL, go to Settings > Business Profile > API Keys (or visit https://app.gohighlevel.com/settings/api-keys). Copy your Private Integration Token — it starts with pit_.
  2. Location ID — Find your Location ID in the GHL Settings under Business Profile, or look at the URL when you’re inside a GHL location.

​
Step 2: Start the Connection in VozAgent

  1. Go to Integrations in your sidebar
  2. Click the GoHighLevel card on the Third Parties tab
  3. Click the Connect GoHighLevel button
  4. A connection dialog will open with a progress bar showing four steps

​
Step 3: Enter and Test Credentials

In the first step of the dialog:
  1. Enter your Private Integration Token in the field (placeholder shows pit_xxxxxxxxxxxxxxxx)
  2. Enter your Location ID
  3. Click Test Connection to verify the credentials
If successful, your GHL location name and address will appear in a green confirmation. Click Next to continue.

​
Step 4: Configure Calendar (Optional)

On the Calendar Setup step:
  1. A dropdown lists all calendars from your GHL location
  2. Select a calendar if you want your AI assistant to book appointments to it
  3. Or choose Skip - No calendar if you don’t need calendar booking
  4. Click Next

​
Step 5: Configure Pipeline (Optional)

On the Pipeline Setup step:
  1. A dropdown lists all pipelines from your GHL location
  2. Select a pipeline if you want new leads tracked as opportunities
  3. If you select a pipeline, a second dropdown appears to choose the default stage for new opportunities
  4. Or choose Skip - No pipeline to skip pipeline tracking
  5. Click Next

​
Step 6: Review and Connect

The summary step shows everything you’ve configured:
  • Location — your GHL location name
  • Calendar — the selected calendar (if any)
  • Pipeline — the selected pipeline and stage (if any)
  • Auto-sync contacts toggle — enabled by default, automatically pushes new contacts from calls to GHL
Review the settings and click Connect to save.

​
Connection Status

Once connected, the integration page shows:
  • A green Connected badge
  • A status banner with your GHL location name
  • The last sync timestamp
  • Three action buttons: Sync Contacts, Update Settings, and Disconnect

​
Sync Settings

When connected, the Sync Settings section displays your current configuration:
SettingDescription
Auto-sync ContactsShows Enabled or Disabled — controls whether new contacts from calls are automatically pushed to GHL
CalendarShows the name of the GHL calendar used for appointment booking (if configured)
To change these settings, click Update Settings to reopen the connection dialog.

​
Syncing Contacts

Click Sync Contacts on the integration page to trigger a manual contact sync. A spinning animation appears while the sync is running. Use this when you want to ensure both systems are fully up to date.

​
Disconnecting GoHighLevel

To disconnect:
  1. Click the red Disconnect button on the integration page
  2. A confirmation dialog will explain what happens: contact sync will stop and your assistants won’t be able to book to your GHL calendar
  3. Click Disconnect to confirm
Existing synced contacts will remain in both systems — nothing is deleted.

​
Troubleshooting

“Test Connection” fails — Double-check that your Private Integration Token and Location ID are correct. Make sure the token has the required permissions in GHL. Tokens that start with pit_ are Private Integration Tokens — do not confuse them with OAuth tokens. No calendars found — Your GHL token may not have the calendars.readonly permission scope. Check your Private Integration Token permissions in GoHighLevel Settings. No pipelines found — Your GHL token may not have the opportunities.readonly permission scope. This is optional and won’t prevent the connection from working. Contacts not syncing — Make sure Auto-sync Contacts is enabled. You can also use the Sync Contacts button to force a manual sync. Calendar booking not working — Verify that a calendar was selected during setup. Click Update Settings to check or change the calendar selection.