Connecting & Managing Contacts

Tell your assistant which of these you're using, and it calls connect_data_source to wire it up. Every account has exactly one data source connected at a time — whichever one holds your real, current list.

Starting from scratch

No credential, no external service. Contacts live in Wawai's own database, managed entirely through conversation — ask your assistant to add contacts one at a time, or import a whole list at once. This is the right choice if you don't have (or don't want to set up) an Airtable base or a spreadsheet, or if you're migrating contacts from somewhere else.

A spreadsheet you've uploaded

No credential needed. You (or your assistant, from Claude Code) upload the file first, then connect it.

Airtable

Needs a Personal Access Token scoped to data.records:read on the target base, from airtable.com/create/tokens. Your assistant will also need the table ID, plus which columns hold the email, groups, subscription status, and unsubscribe token. Segments come from Airtable views named "Segment: <name>".

Google Sheets

No credential needed from you — the platform uses one shared Google service account. Share your spreadsheet with that service account's email (ask your assistant if you don't have it) instead of doing your own OAuth setup. Same column requirements as Airtable, plus the sheet name.

Consolidating a list from somewhere else

Already have contacts scattered across more than one place? Ask your assistant to read them from that other source directly (many services expose their own tools your assistant can call) and import them into Wawai's built-in contact store in one pass — that gives you a single, consolidated list to send from, instead of juggling multiple sources.

Managing your list day to day

If you're using Wawai's own contact store (the "starting from scratch" option above), your assistant manages it entirely through conversation — no separate contacts app to log into.

• Adding people: ask to add a contact one at a time, or import a whole batch at once.
• Grouping: contacts can belong to more than one group (segment) — ask to tag someone into a group when you add them, or update it later.
• Removing a segment: ask to delete a segment when you're done with it — it untags every contact that had it; the contacts themselves aren't deleted or unsubscribed, only the grouping.

If you're using Airtable or Google Sheets instead, list management happens in that spreadsheet directly — Wawai reads from it live each time you send, so there's nothing to sync.