Predefined Messages
In Predefined Messages mode, you write a list of messages ahead of time. Each message has a set of trigger keywords; when a lead’s first message contains one, that message is sent as the welcome. The last message in the list is always a catch-all for anything that doesn’t match a specific keyword.
Getting here
In NZ Leads, go to Sources → select a source → Messaging Settings → Conversation Setup tab → click Predefined Messages at the top.
How matching works
- The customer’s first message is checked against each message’s keywords, in list order.
- The first message with a matching keyword wins. No further messages are checked for that lead.
- If no specific message matches, the catch-all at the bottom is used.
- Matching ignores upper and lower case.
- A keyword matches when its letters appear anywhere in the message, even inside a longer word. For example,
pricealso matches “prices”, andacalso matches “back”. Use longer keywords or short phrases to avoid false matches.
The message list
Use Add message to top or Add message to bottom to add a message (Add message while the list has only the catch-all). Each entry has the following fields.
Trigger keywords
- Label: “Keywords that trigger this message as a welcome message” (chip input)
- Default: (empty) - each message needs at least one keyword.
- Rules:
- Add words or short phrases.
- Combine parts with
&&to require all of them in the same message. Example:screen replacement&&appletriggers only when the message contains both “screen replacement” and “apple”.
- Use this when: think about the words your leads actually use - “price”, “cost”, “quote”, “how much”, “emergency”, “urgent”, “repair”, etc.
Skip welcome message and follow-ups for matching keywords
- Label: “Skip welcome message and follow-ups for matching keywords” (checkbox, not on the catch-all)
- Default: off
- When on: a lead whose first message matches this entry’s keywords gets no welcome message and no follow-ups. The lead is set to Follow-up, gets a note on the lead, and your integrations aren’t notified about that message. The message body is hidden, since nothing is sent.
- Use this when: some inquiries should never get an automatic reply, for example job types you only handle by phone.
Message body
- Label: text editor showing the message content
- Default: (empty on a new entry)
- What it is: what the lead actually receives when this message triggers. Plain text - line breaks are kept, there is no bold, italics or link formatting. Insert Customer First Name Placeholder adds
#customer_first_name#, which is replaced with the customer’s first name when the message sends. - Use this when: write it the way you’d normally write it - friendly, personal, with a clear next step.
Prevent Follow-ups
- Label: “Prevent Follow-ups” (checkbox)
- Default: off
- When on: if this message is sent as the welcome, no follow-ups are sent for that lead and the lead is set to Follow-up.
- When off: the normal follow-up sequence still runs after this message.
- Use this when: the message itself is the final answer (pricing deflection, “we don’t do that”, “please call us directly”) - you don’t want automated follow-ups chasing someone you’ve already fully responded to.
Reorder
- Label: drag handle on each row
- What it does: drag and drop to change the order of messages. The list is checked top-down, so put your most specific / highest-priority messages at the top.
The catch-all (last message)
- The last message in the list is always a catch-all. Its keyword is shown as Any and cannot be edited.
- The catch-all message body is editable.
- The catch-all cannot be deleted or reordered - it stays at the bottom so that every lead gets a reply.
- Use this when: always. It’s your safety net for anything that doesn’t match a specific keyword. Make it friendly and promise a follow-up.
The catch-all is what most leads will actually see - specific keyword triggers handle edge cases, the catch-all handles the rest. Spend time making the catch-all message feel human and helpful.
Skip welcome message & follow-ups (all leads)
Below the list, Skip welcome message & follow-ups stops every automatic message for this source: no welcome, no follow-ups, no AI replies and no Contact Info confirmation. Default: off. New leads are set to Follow-up. While it’s checked, the message list can’t be edited. Use it when another system, such as a REST webhook integration, decides what gets sent.
Example configuration
A typical setup:
- Emergency - keywords:
emergency, urgent, asap, flooding→ fast-response message with your direct phone number. Prevent Follow-ups: on (you’ll call them yourself). - Pricing - keywords:
price, cost, quote, estimate, how much→ message explaining you’ll send a quote after a quick call. - Catch-all - “Thanks for reaching out! I’ll review your message and reply within a couple hours…”
How it behaves
- Variables: if your message includes a customer-name placeholder, it’s filled in automatically when the message sends.
- With AI Assistant mode: Predefined Messages and AI Assistant are mutually exclusive. Switching to AI Assistant disables the predefined list for this source (but doesn’t delete it - switching back restores it).
- Welcome Message Delay: if delay is enabled, it applies equally to all predefined messages - they’re all “the welcome” in the eyes of the delay setting.
- No welcome after your own reply: the welcome is only sent while no one from your business has written in the conversation.
Troubleshooting
- The wrong message is triggering: list order decides the winner, and a keyword also matches inside longer words. Move the more specific message above the more general one, or use a longer keyword.
- Can’t delete the last message: that’s the catch-all. Delete a message above it, or edit its body instead.
- A specific-keyword message is getting follow-ups when it shouldn’t: turn on Prevent Follow-ups on that entry.
- No welcome was sent: check Skip welcome message & follow-ups, the keyword skip on each entry, and Bot Quiet Hours.
Questions? Email support@nzleads.com.