Contact triggers
Start an Agent Program when someone new reaches your business or a contact moves stage, and what a program may do with your contacts.
On this page
A contact trigger starts a program when something happens to one of your contacts: a new person writes in or buys, or someone moves stage. Each event starts one run, and the run is told which contact it is about.
Set one up
Tell Willo's chat what should happen, for example:
- "When a new lead comes in through the contact form, tag it by the service they want and remind me tomorrow."
- "When someone becomes a customer, write them a thank-you for me to approve."
- "When a follow-up I set comes due, write them a check-in for me to approve."
Willo sets the program's trigger to contact and gives it the contact tools it needs. The Agents tab shows the trigger as a sentence, such as "When a new contact from contact form is added".
Willo's starter programs include three ready-made versions: New lead: tag and remind me, New customer: thank-you note, and Follow-ups due: check-in drafts (a check-in for each person whose follow-up date comes due).
What can start it
| Event | When | Filters |
|---|---|---|
| New contact | Someone is added: a form message, a waitlist or list signup, a sale, or a person you add in chat or on the Contacts page. | Where they came from (contact form, waitlist, newsletter, chat, Stripe, Shopify), a tag. |
| Stage change | A contact moves stage, for example to customer. | The stage they moved to, the stage they came from, where they came from, a tag. |
| Follow-up due | A follow-up date you or a program set comes due. It starts once for each date. | None. The program checks the contact itself. |
| Job stage change | One of a contact's jobs moves stage, for example to won. | The stage it moved to, the stage it came from. |
"A new contact" means a lead or a customer. A newsletter signup starts the program only when you include the newsletter as a source. Someone who comes back also counts as new: a lost contact or a newsletter subscriber who writes in through your form.
These never start a contact trigger:
- adding people by importing a file, and the contacts and purchases Willo brings in from your past form messages, Stripe and Shopify (a stage a file sets on someone you already have does count as a stage change);
- a form message that looks automated (it is kept and tagged possible_spam);
- an archived contact;
- a change another agent made, so two agents can't keep handing a contact back and forth;
- clearing a contact's stage.
Runs usually start within a few minutes, one at a time per program. A program takes at most 60 contact events a day unless you change its Runs a day (up to 500). See Limits.
What a program can do with contacts
A program with the contact tools can find and read your contacts, and change these things only:
- the stage;
- tags;
- the follow-up date and its note;
- a note on the timeline.
It can also change an existing job's stage, value and lost reason. It can't add, rename or delete a job.
It can't add, rename, re-address, archive, merge or delete a contact. Stage changes, follow-up dates and notes show on the contact's timeline as made by the program.
What visitors typed, such as a form message, is treated as information, never as instructions. So a run started by a contact event reads, changes and emails only that contact. A run that has read outside text in any other way can still set stages, tags and follow-up dates, but doesn't write notes. Any run can change at most 25 contacts.
Emails to contacts always ask first
A program never sends anything to a contact by itself. When it writes an email to a contact, you get it as an approval request naming the person and their address, with the subject and the whole message, in every mode, including act on its own. Approve it and it is sent from your business's sending address and logged on the contact's timeline. If the contact's address changed after you approved, it is not sent. Deny it and nothing is sent. See Working on its own or asking first.
Related: Contacts, Email triggers, Webhook triggers.
Questions
Can an agent email my customers on its own?
No. An email from an agent to a contact always reaches you first as an approval request, whatever the agent's mode. Nothing is sent until you approve it.
Will importing a contact list start my agents?
No. Imports, the contacts Willo brings in from your past form messages and buyers, and messages that look automated never start a contact trigger.