Google Sheets Integration

At a glance

Location	Settings → Google Sheets
Plan	All plans, including the free tier
Related features	4

Log WhatsApp events — messages, contacts, labels, calls and more — as rows in your own Google Sheets, and export existing data. One-way export (nothing is read back from Sheets). Two mechanisms:

1. Triggers (live) — each trigger maps one event type to a sheet tab; rows are appended as events happen. Options per trigger: destination (new spreadsheet, existing spreadsheet, or a folder/Shared Drive), privacy (mask phone numbers, exclude message text), filters (skip archived/groups/channels, only/exclude labels, advanced conditions), and a customizable column mapping with live preview. Some events support an AI summary column. Health states: Healthy, Backlog paused, Rate-limited, Google access lost, Sheet problem, AI token budget exhausted — with a delivery log and replay for failed rows.
2. Export history (one-shot) — export contacts, chat history, call log, or campaign results to a sheet (up to 100,000 rows per export; date range required for chat history).

Quick-start templates (e.g. a Leads Log sheet) create the sheet and wire up the matching trigger in one click. Spun can only see spreadsheets it creates for you or that you explicitly pick. Plan-gated: on plans without Google Sheets, existing triggers keep delivering but you cannot connect or create/edit triggers; after a downgrade there is a 30-day grace period before event capture stops. Trigger delivery is metered against your org's AI token budget; if the budget runs out, delivery pauses (queued rows are kept and resume automatically once the budget renews or is topped up) rather than being lost.

google sheetsspreadsheetsheets syncexport to sheetsleads logsheet trigger

How to use

1. Go to Settings → Google Sheets (admin only).
2. Click "Connect Google" and complete the OAuth popup.
3. Click "Add trigger" (or use a quick-start template): choose the event, destination, privacy options, filters, and columns.
4. Rows appear in your sheet as events happen — use "Send test row" to verify.
5. For a one-time dump, click "New export", pick the dataset and date range, and start the export. If delivery pauses due to an exhausted AI token budget, the panel shows a warning and rows resume automatically once the budget renews or you top up.

Related features

• Settings
• Contacts
• Campaigns / Broadcasts
• Labels

FAQ

• How do I connect Google Sheets?
• Can Spun log messages to a spreadsheet?
• How do I export my contacts to Google Sheets?
• Why did my sheet stop updating?
• Can I mask phone numbers in the sheet?
• Why is my Google Sheets sync paused because of tokens?