Google Sheets Integration
Pipe every chat and lead capture into the same spreadsheets your team already lives in. Truck-roll logs, room readiness lists, BOM tracking, RFP intake. Connect AVCodex to Google Sheets and let the data land where the work happens.
Connect your AVCodex agent to Google Sheets to automatically export conversations and collect lead form data.
| Use Case | Description |
|---|---|
| Export Chat Logs | Automatically save every conversation to a spreadsheet |
| Lead Generation Forms | Collect form submissions directly into Google Sheets |
Automatically export every conversation to a Google Sheet for analysis, dispatch review, or compliance. Useful for tracking what techs are asking your AVCodex agent in the field, or what end-clients are reporting from conference rooms.
Prerequisites#
Before connecting, create an empty spreadsheet in your Google Drive. AVCodex will add the data to this spreadsheet.
Setting Up Chat Export#
1. Navigate to Chat Output
Go to your agent's Chats page and click the Actions tab. Find the Connected Outputs card.
2. Click Configure Output
Click the Configure Output button to open the output dialog.
3. Connect Google Sheets
Click the Google Sheets button. If you haven't connected your Google account yet, you'll be prompted to:
1. Sign in to your Google account 2. Review the permissions AVCodex is requesting 3. Click Allow to grant access
4. Select Your Spreadsheet
The Google File Picker will open. Navigate to and select the empty spreadsheet you created earlier (for example, Field-Tech-Chat-Log-2026.xlsx).
> Warning: You must create an empty spreadsheet in Google Drive first. AVCodex cannot create spreadsheets for you.
5. Confirm Setup
Once selected, AVCodex will initialize your spreadsheet with headers. You'll see your sheet listed in the Connected Outputs section.
What Gets Exported#
Each row in your sheet will contain:
| Column | Description |
|---|---|
| Date | When the conversation started |
| Updated At | Last message timestamp |
| Chatlogs | Full conversation text |
| Conversation ID | Unique session identifier |
| User ID | User identifier (if collected) |
| User email (if collected) | |
| Phone Number | User phone (if collected) |
| Source | Where the chat originated (Web, API, Slack, etc.) |
| Tags | Conversation tags |
Viewing Your Data#
Your connected sheet appears in the Connected Outputs section. Click the Google Sheets icon to open it directly in Google Sheets where you can:
- Share it with the dispatch team or service manager
- Build pivot tables that count how often a given Crestron error code shows up
- Automate alerts with Google Apps Script when a high-priority room is mentioned
Collect form submissions directly into Google Sheets when using lead generation forms. Good for RFP intake on your website, dealer-program signups, or "request a quote" widgets embedded on a microsite.
Setting Up Lead Form Export#
1. Open Lead Collection
Go to Build page and find the Lead Collection section. Click + Collection Form to create a new form.
2. Connect Google Sheets
In the dialog, you'll see "Would you like to push leads to a Google Sheet?" Click Connect to link your Google account.
3. Select Your Spreadsheet
Use the Google Picker to select an empty spreadsheet from your Google Drive.
4. Configure Form Fields
Click Next to set up your form fields. Choose which information to collect: company name, room count, vertical (corporate AV, higher-ed, hospitality), preferred manufacturer, project budget, expected commissioning window.
5. Save the Form
Click Save to create your form. Lead submissions will now automatically appear in your Google Sheet.
Form Data in Sheets#
When a user submits a lead form, a new row is added with:
- Each form field you configured
- Submission timestamp
- Conversation context
Success: Pro Tip: Use Google Sheets' built-in notifications to get alerted when new leads come in. Go to Tools > Notification rules in your sheet. Pipe it to the BD inbox so RFP responses don't sit overnight.
Viewing Connected Sheets#
- Chat Logs: Go to Chats > Actions tab to see connected output sheets
- Lead Forms: Go to Build > Lead Collection to see forms with connected sheets
Disconnecting a Sheet#
To disconnect a Google Sheet from chat logs:
- Go to Chats > Actions tab
- Find the sheet in Connected Outputs
- Click the trash icon to remove it
To disconnect a lead form:
- Go to Build > Lead Collection
- Click the trash icon next to the form
Revoking Google Access Entirely#
To completely revoke AVCodex's access to your Google account:
- Go to your Google Account Security Settings
- Find Third-party apps with account access
- Click on AVCodex and select Remove Access
Switching Accounts#
To use a different Google account:
- Disconnect the current sheet
- Reconnect using the new account credentials
"Connection Failed" Error#
- Check that you're signed into the correct Google account
- Ensure pop-ups aren't blocked in your browser
- Try disconnecting and reconnecting
Data Not Appearing in Sheet#
- Verify the correct sheet is selected
- Ensure your AVCodex agent is receiving conversations
- Check that the sheet wasn't deleted from Google Drive
"Permission Denied" When Accessing Sheet#
- Make sure you're accessing with the same Google account used to connect
- The sheet may have been deleted, check your Google Drive Trash
Can't Find Spreadsheet in Picker#
- Make sure you created an empty spreadsheet first
- Check that the spreadsheet is in Google Drive (not Google Docs or another app)
- Try refreshing the picker
Your data security is important:
- Encrypted tokens: All Google credentials are encrypted at rest
- Minimal permissions: We only request access to spreadsheets, not your entire Drive
- Automatic refresh: Tokens are refreshed securely without requiring re-authorization
- You control access: Revoke access anytime from your Google account
*AVCodex · Your AV expertise. Amplified by AI.*