GoHighLevel (GHL) Integrations: How to Guide

Purpose

This guide walks through the setup process to integrate Linq Blue with GoHighLevel (GHL),  including, contact syncing, call recording, message routing, automation setup, and best practices for healthy iMessage deliverability.

---

⚙️ Prerequisites

Before beginning setup, confirm the following:

1. Agency Admin Setup

Access Linq App Admin

1. Log in to the Linq App Admin portal on desktop.

2. Under Integrations → Create → GoHighLevel.

   

3. Authenticate your GHL account using your Agency Admin credentials.

   • Click Next → Sub-Account → Check all three boxes → Close Window.

       4. Inside the GHL Integration in Linq, activate all sync toggles.

       5. Under Advanced Settings, enable all sync options (some may be hidden near the bottom).

       6. Click Save.

✅ Tip: Activating all sync options ensures contact, message, and call logs are mirrored between Linq and GHL in real-time.

---

2. Configure JavaScript for Voice Memos

Install Custom JS

1. In GHL, navigate to Agency Admin → Settings → Company → Custom JS 

2. Under Custom JS, paste the Linq Voice Memo script provided by your Partner Success Manager.

3. Return to your Linq App tab → Copy your Location ID.

4. Replace the placeholder text inside the JS script ("location_id") with your sub-account's Location ID.

5. Click Save Changes → Proceed.

This enables native voice memos and transcript support in GHL.

---

3. Import Linq Blue Snapshot

Install the Pre-Built Automations

1. Open a new tab and visit the Snapshot URL provided by Linq.

2. Click Import Now.

3. In GHL, go to Agency View → Sub-Accounts → [Your Sub-Account] → Three Dots → Manage Client.

4. Click Actions → Load Snapshot → Linq Blue Snapshots → Proceed → Select All → Confirm.

5. The system will load all default automations, triggers, and actions.

✅ Progress Check:
You’re now ~70% integrated. The Linq dialer should appear blue inside GHL once JS and Snapshot imports succeed.

---

4. Enable Smart Number Assignment

1. In GHL, go to Settings → General Settings.

2. Toggle Smart Number Assignment → ON → Save Changes.

What it does:

• Round-Robins new inbound contacts to your team members.

• Keeps conversations “sticky” — if a contact first messages Phone Number 1, replies always route to Phone Number 1.

• Prevents conversation mix-ups when multiple Linq Blue lines are used.

---

5. User Phone Mapping & Forward Settings

1. Go to Linq →General Setting→ Smart Number Assignment.

2. Click Save.

3. 

Phone Forwarding Settings

1. Open Phone Forwarding Settings.

2. Add your cell number (temporary step) → Save Changes.

   

3. Copy your Linq Blue phone number — you’ll use this in Phone System GHL settings next.

---

6. Phone System Configuration

1. Go to GHL → Settings → Phone System.

   
   

2. Under Additional Settings → Telephone Provider, select Linq Blue.

    

   

   • This makes Linq Blue your default SMS/iMessage provider.

   • ⚠️  Note: this step is optional, and will make all SMS actions send via Linq Blue. Leadconnector will be unavailable for texting.
   • ⚠️  IMPORTANT: ensure your workflows are designed for iMessage best practices before toggling the default provider to Linq Blue.

3. Go to Phone Numbers → Verified Caller ID →Add Number.

    

   
   

    

   • Paste your Linq Blue number.

     

   • Click Verify and answer the call on your personal device to complete verification.

4. Click Edit Configuration → Check “Use verified number as Caller ID" and select the number you added from the dropdown.

   

5. Enable Call Recording (both inbound and outbound).

6. Click Save.

---

7.  Replace Forwarding Number

1. Copy your LeadConnector number (under GHL → Phone Numbers).

2. Return to Phone Forward Settings in the Linq settings.

3. Replace your cell number with the LeadConnector number.

4. Click Save Changes.

✅ You are now 100% integrated.

---

8. Testing the Integration

Test Messaging

1. In GHL → Conversations → New Conversation, send a message to a test number.

2. Confirm a reply appears in GHL.

3. Test Voice Notes via the waveform icon.

   • You should see the message and audio file appear instantly in GHL.

Test Inbound and Outbound Calling

1. From GHL, click the Green Dialer Icon and call your test number.

2. Verify:

   • Caller ID displays your Linq Blue number.

   • Call recording begins automatically.

3. Call your Linq Blue number → confirm it rings inside GHL (not your cell).

---

9. Contact Card Automations

Send iMessage and Share Contact

1. In GHL → Automations → Create Workflow → Start from Scratch.

2. Add an Action → Apps → Linq → Send iMessage.

3. Add an Action → Apps → Linq → Share Contact.

4. Email your Partner Success Manager your desired contact name and photo/logo for your phone number's contact card.

5. Once configured, when the action fires, it shares your contact name and photo with the recipient.

⚠️  Note: the “Share Contact” action cannot be the first automation step — it must follow a Send IMessage Action

---

10. Send Images & Videos

• Manual Sends:

  • Use from conversations, attach any image or audio files from your device. They will render on the recipient side in the appropriate format.

• Automated Sends:

  • In GHL, include attachments in the Send IMessage Action — they’ll deliver natively via iMessage.

---

11. Monitoring & Health

Review line health daily under Reports → Linq Blue Metrics (24-hour, 7-day, or 30-day views).

---

12. Post-Setup & Follow-Up

• Add your Partner Success Manager as an Agency Admin for quick troubleshooting access.

• Schedule a 14-Day Follow-Up Call with your Partner Success Manager to confirm:

  • Deliverability

  • Response rates

  • Automation success

  • Inbound call routing

---