Concept

Contacts

The people Willo keeps for you from your forms, signups and sales: where contacts come from, stages, follow-ups, and how to ask Willo about them.

Last updated Open in ClaudeOpen in ChatGPT
On this page

A contact is one person your business deals with: someone who sent you a message, joined your waitlist, signed up to your emails or bought from you. Willo keeps one record per person, so you can ask "what do we know about maria@example.com?" or "who's still waiting on a reply?" and get one answer.

Where contacts come from

Willo adds people on its own. There is nothing to set up and nothing to type in.

  • Your contact form and waitlist: each new message or signup.
  • Your email list: everyone who subscribes, and a note when someone unsubscribes.
  • Your sales: recent buyers from your connected Stripe account and Willo Shopify app, then each new Stripe sale and Shopify order as it happens.
  • Other forms and tools: a form Willo built on a table of its own, and tools like Zapier, Make, lead ads and booking tools, once you connect them. See Connect forms and other tools to Contacts.
  • You: tell Willo in chat, for example "add Dave the plumber, dave@example.com, he wants a quote."

One person is one contact. Willo matches people by email address, then by phone number, so the same customer writing in twice stays one record. Two different email addresses stay two contacts, even when they share a phone number.

Where they found you

When someone fills in a form on your Willo site, Willo also notes how they reached the site: the first page they landed on, the site that sent them (Google, Facebook, another site), and any campaign tags in the link they followed (utm_source, utm_medium, utm_campaign). It is kept from the message that first adds them as a contact, so it shows how a person first found you; a later message doesn't change it. Ask Willo "where did Maria find us?" to see it.

Sites built before 16 November 2026 start noting this once their next change is published. See where your customers come from adds it all up. People who wrote in before then show no source.

Stages

Each contact has a stage that says where things stand:

StageMeans
NewThey got in touch and haven't heard back.
TalkingYou're in conversation.
CustomerThey bought from you.
LostIt didn't go anywhere.

Someone who only signed up to your emails has no stage: they're on your list, not waiting on you. Willo sets stages as things happen. A form message makes someone New, and a purchase makes them a Customer. You can change any stage at any time.

When someone asks for a piece of work, add a job to them: it has its own stage (Requested, Quoted, Won, Lost) and value, and a won job makes them a customer. See Track jobs and send quotes.

Who's waiting on you

A contact can carry a follow-up date and a short note on what it's about. When someone sends a message, their follow-up is due straight away, so they show as waiting until you deal with it. Tell Willo when you've replied, by email, phone or in person, and it moves them to Talking and clears the follow-up (other reminders stay). A reply you send from Willo does this on its own. Set a new one any time: "remind me to call Maria on Tuesday." A day with no time means 9 in the morning in your business's time zone. On the Contacts page a person can have several reminders at once; their follow-up date is always the soonest one, and clearing the follow-up keeps the others.

The morning daily digest lists everyone waiting on you by name, with a link to each. A new lead you haven't answered after a day is pointed out once.

Someone you're Talking with who has gone a week with nothing new went quiet. Ask Willo who went quiet, or use the Went quiet chip on the Contacts page.

A message that looks automated is kept but tagged possible_spam. It never shows as waiting and is left out of lists unless you ask for it. If a real person was tagged by mistake, ask Willo to remove the tag.

The timeline

Every contact has a timeline, newest first: the messages they sent through your forms, emails between you, signups and unsubscribes, purchases, stage changes, follow-ups and notes. Each change says who made it: Willo, you, or an outside agent.

Purchases are read live from Stripe (your 100 most recent charges) and Shopify when you ask about someone, matched by email.

Ask Willo

Contacts are in chat. Some things to ask:

  • "Who contacted us this week, and who's still waiting?"

  • "What do we know about maria@example.com?"

  • "Who went quiet in the last two weeks?"

  • "I called Maria back. Set a follow-up for Friday: send the quote."

  • "Draft a check-in to Maria about the quote."

Willo looks a person up before it drafts a reply to them, so it can use what they wrote and what they bought. Willo never messages a contact on its own, apart from the instant reply if you turn it on. When you want a follow-up sent, Willo shows it to you on an approval card first, and it goes out only when you approve.

Emails you send to a contact

A follow-up is one email to one person. It goes from your own domain when you've verified one for email, and otherwise from your business's Willo sending address. Replies reach your own inbox and the contact's timeline (below). The email goes on their timeline, a New contact moves to Talking, their follow-up date is cleared, and the note about their message in your inbox is marked handled. A business can send up to 20 of these emails an hour and 60 a day, lead replies included. Willo won't send to an address that bounced before or marked your email as spam. Drafts don't cost credits.

When a contact replies

Every email Willo sends to a contact lists two reply addresses: yours first, then a Willo address for that person. When they reply, the answer goes straight to your own inbox, and Willo's copy goes on their timeline. Willo doesn't forward or answer it.

  • A New or Lost contact moves to Talking, and they show in Waiting on you until you deal with it. Your Willo inbox gets a note.
  • Attachments stay in your inbox. The timeline lists their names and sizes.
  • A reply from a different address goes on the same contact, marked as from a different address.
  • When you or a teammate reply-all from your own mail, Willo logs it as sent by your team. The next email you send from Willo joins the same thread. A reply-all from a team address whose domain doesn't confirm its senders isn't logged.
  • A reply from an email domain that doesn't confirm who sent it is still logged and shows in Waiting on you, marked Unverified sender. It doesn't change their stage. Check it before acting on it.
  • Out-of-office replies, bounces, and mail that fails the sender's own domain checks or can't be checked aren't logged. Willo logs up to 50 emails a day from one address and 100 a day for one contact; past that, your inbox gets a note and logging resumes the next day.

A reply that leaves out Willo's address reaches only you, and isn't logged. To keep replies to yourself, including replies to emails you sent earlier, turn on Send replies only to me in Contacts settings (the gear on the Contacts page).

Log email you write in your own mail

Contacts settings shows your business's BCC address. Add it as BCC when you email a customer from Gmail, Outlook or any other mail app, and Willo puts the email on the timeline of up to 3 people in To and Cc, adding them as contacts if they're new. It works from the verified email address of the business's owners and admins.

Instant reply to new leads

Turn this on and everyone who writes in through your contact form or waitlist, and leaves an email address, gets one message from you within a minute: "Thanks, we got your message." It's off until you turn it on in Contacts settings, or ask Willo: "reply to new leads right away."

  • You write and approve the message once. It can fill in {first_name}, {business_name}, {phone} and {hours}, and can't hold links. Changing it asks for your approval again; turning it off works at once.
  • No AI writes anything per lead, and nothing the lead wrote goes into it.
  • It skips leads that look automated, anyone it already reached in the last 30 days, and anything past 25 a day. Each one it sends or skips is counted in Contacts settings.
  • It goes from your own domain if you've verified one, else your Willo sending address, and their reply reaches you like any other (above).
  • If one sent from your Willo sending address bounces or is marked as spam, Willo stops emailing that address from your business, replies and follow-ups included.
  • It goes on their timeline as Willo's instant reply. They stay New and in Waiting on you: it isn't an answer, and you still owe one. Your lead alert says it went.

Automations

An Agent Program can start when a new contact arrives or a contact moves stage, and can tag contacts, move their stage, set follow-ups and add notes. A program's email to a contact always reaches you first as an approval request. See Contact triggers.

From an outside agent

An agent connected to your business can read contacts with willo_contacts and change them with willo_contacts_write. It can draft a follow-up with willo_follow_up, and willo_send_follow_up sends one after a person approves it. All of them need a token made by an owner or admin. See give an agent access.

Where contacts are kept

Contacts live in your business's own database, next to the form messages and subscribers they come from, and only on your live site. Drafts never get a copy. See tables and access rules.

Related: Visitors and leads, Get started with business records.

Questions

Do I have to add contacts myself?

No. Willo adds everyone who writes in through your site's forms, joins your waitlist or email list, or buys from you through Stripe or Shopify. You can also tell Willo about someone in chat.

Does adding someone as a contact put them on my email list?

It depends how they arrived. People who write in through your forms, and people who buy from you, join your email list automatically unless you turn that off in Contacts settings (Shopify buyers only if they agreed to marketing email in Shopify). When you import contacts or add someone yourself, you say whether they agreed. Anyone who unsubscribed, bounced or marked your email as spam stays off. Others can be invited from the Contacts page.

Who can see contacts?

Asking Willo about contacts in chat, and an outside agent's contacts tools, need an owner or admin of the business. Anyone below admin is refused.