fb-messenger-ghl

What It Does

When you are chatting with someone on Facebook Messenger, this tool grabs their name and their email address from the conversation and adds them to your customer list (GoHighLevel) with one click. You do not have to copy and paste anything, and you can pick which business’s customer list to add them to (All Things Handy or Go-Kart Park). It is the fastest way to turn a Messenger chat into a real contact in your CRM.

When To Use

• During an active Messenger conversation with a prospect you want in GHL.
• After you get an email address in a DM — instead of copy-paste-alt-tab, one click saves it with the contact name already filled in.
• When switching subaccounts mid-flow — the popup has a subaccount toggle so you can send to ATH or GKP as needed.

How To Install And Invoke

1. Load unpacked from ~/apps/fb-messenger-ghl/extension/ at chrome://extensions.
2. Open the extension options page and enter your GHL PITs and location IDs for both subaccounts.
3. Open a Messenger conversation.
4. Click the extension popup → “Scrape Conversation.”
5. Review/edit the scraped data → “Create in GHL.”

Prerequisites

Requirement	Where
GHL Personal Integration Tokens	extension options (supports two: GHL_ATH_PIT, GHL_GKP_PIT)
GHL location IDs (one per subaccount)	extension options
Manifest permissions	storage, tabs, activeTab; hosts: messenger.com, facebook.com/messages, services.leadconnectorhq.com

Where It Lives

• Repo: ~/apps/fb-messenger-ghl/
• Entry files: extension/manifest.json, popup.html, popup.js, background.js, content.js

Known Gaps / Quirks

• Email extraction is regex-based and heuristic. Obfuscated emails (e.g., “email me at joe at example dot com”) will not match.
• Messenger DOM changes often. The CLAUDE.md in the repo warns that selectors need periodic updating.
• No deep profile scraping — unlike fb-email-slurper-3000, this extension only looks at conversation text, not the profile page.
• Build 8.