Settings & Configuration

Export CSV Export Excel
API Keys Configuration
API keys are stored in the .env file in your project root. Edit that file to update your credentials, then restart the server.
Outscraper API

Used to scrape Google Maps and find businesses without websites.

  1. Go to app.outscraper.com → sign in or create account
  2. Navigate to Profile → API Key
  3. Copy your API key and paste it into .env as OUTSCRAPER_API_KEY
Checking...
Go High Level (GHL)

Used to create contacts and send/receive SMS messages.

  1. In GHL, go to Settings → Integrations → API Keys
  2. Create a new API key and copy it to GHL_API_KEY in .env
  3. Find your Location ID in Settings → Business Profile and copy it to GHL_LOCATION_ID
  4. In GHL, set up a Twilio phone number under Settings → Phone Numbers
  5. Add your Twilio SMS number to SMS_FROM_NUMBER in .env
Checking...
OpenAI (Optional)

Used for smarter intent classification of ambiguous SMS replies. Falls back to rule-based classification if not configured.

  1. Go to platform.openai.com → API Keys
  2. Create a new key and paste to OPENAI_API_KEY in .env
GHL Webhook Setup

Configure this webhook URL in GHL so incoming SMS replies are automatically processed by the AI agent.

Important: This URL must be publicly accessible. For local development, use ngrok to create a tunnel: ngrok http 5000
  1. In GHL, go to Settings → Integrations → Webhooks
  2. Click Add Webhook
  3. Paste the webhook URL above
  4. Select event: InboundMessage
  5. Generate a webhook secret and paste it to WEBHOOK_SECRET in .env
AI Conversation Flow
Hi! Is this [Business Name]? 👋
Step 1 — Initial Greeting
Yes, that's us! How can I help?
Lead confirms identity
We noticed you have an impressive 4.8-star Google rating — that's great! ⭐

However, we also noticed there's no website linked to your Google profile. That means customers searching online may not find you, which could be costing you sales.
Step 2 — Compliment + Gap
Oh wow, I didn't know that...
Lead engages
We've actually already put together a free preview website for [Business Name]. Would you like me to send you the link so you can take a look? No obligation at all! 🌐
Step 3 — Offer
Yes please!
Lead says yes
Wonderful! I'll have that link ready for you shortly. One of our team will be in touch very soon with your personalised website. 😊
Step 4 — Flagged for manual follow-up ✅
Lead tagged "interested-in-website" in GHL — create their site on Lovable and send the link manually.
System Status
Checking status...