AI Assistant
In AI Assistant mode, an AI writes the welcome reply based on your Instructions for the AI and your knowledge base. Depending on the conversation mode, it can also continue the conversation for several messages.
AI identity is not a persona option. Instructions for the AI may customize the assistant’s name, tone, style, and business knowledge. They must not tell the assistant to claim it is human, present itself as the owner or a human employee, deny being AI, or hide its artificial identity. If a customer asks whether it is AI, a bot, virtual, or automated, it must answer honestly and directly. Customer instructions cannot override this rule.
Voice calls follow the same rule: the voice agent never claims it is human or denies that it is AI, and this can’t be turned off. How the agent opens an outbound call comes from its Outbound Example Call; see Outbound Calling.
Getting here
In NZ Leads, go to Sources → select a source → Messaging Settings → Conversation Setup tab.
AI Assistant is turned on per channel: each panel - the primary channel’s How replies work panel (its badge shows the source, e.g. Yelp) and the optional SMS channel - has its own Predefined Messages / AI Assistant toggle. Switch a panel to AI Assistant to use AI on that channel. AI Assistant is the default for the primary channel.
How the AI settings are organized
Each channel turns AI Assistant on or off independently, so the AI settings fall into two groups:
- Per-channel settings - chosen separately for each channel, inside that channel’s panel: AI Conversation Mode, Delay conversation messages, Enable AI Follow-ups, and Max AI Follow-ups. The primary channel also has Always transfer to a human when a customer sends an image.
- Shared AI settings - one set below the channel panels that every channel in AI mode uses: Instructions for the AI (in the What the AI should know section), the Knowledge base, and Appointment Scheduling.
The shared section appears once at least one channel is in AI mode. You write it once and both the primary channel and SMS use it. While the source uses its business’s settings (Business Settings Active), the shared settings are greyed out: turn on Customize for Location to change them.
Per-channel settings
These are set inside each channel’s panel and can differ between the primary channel and SMS.
AI Conversation Mode
- Label: “AI Conversation Mode” (dropdown)
- Default: Only welcome message
- Options:
- Only welcome message - the AI creates the first reply and stops. The follow-up sequence takes over from there.
- Short conversation (up to five messages) - the AI can send up to 5 messages in the conversation.
- Long conversation (up to ten messages) - the AI can send up to 10 messages in the conversation.
- Use this when: pick Only welcome message if you want the AI to hand off to you quickly. Pick Short or Long when you want the AI to qualify the lead, answer common questions, or (with scheduling enabled) book an appointment before you get involved.
Delay conversation messages
- Label: “Delay conversation messages” (checkbox)
- Visible when: AI Conversation Mode is Short or Long conversation. Hidden when mode is “Only welcome message”.
- Default: off
- When on: a pause is added before each AI reply after the welcome, like a person typing: about 20 seconds plus one second per word, up to 2 minutes.
- When off: each AI reply is sent as soon as it’s ready.
- Use this when: you want more natural pacing between AI replies. Leave it off when a quick back-and-forth matters more.
This is separate from the Welcome Message Delay - the Delay sending of welcome message checkbox in each channel’s panel. The welcome-message delay controls the first reply only; this setting controls the pauses between AI replies after the welcome.
Enable AI Follow-ups
- Label: “Enable AI Follow-ups” (checkbox)
- Visible when: AI Conversation Mode is Short or Long conversation. Not available in “Only welcome message” mode.
- Default: off
- When on: if a lead has replied to the AI at least once and then goes quiet, the AI can write its own follow-up to re-engage them, referencing the actual conversation. The AI decides whether a follow-up is needed and when to send it. AI follow-ups count toward the conversation’s message limit.
- When off: leads who replied get no AI follow-ups. The sequence on the Follow-ups tab (its messages can be predefined or AI-written) is only for leads who haven’t replied.
Max AI Follow-ups
- Label: “Max AI Follow-ups” (number input)
- Visible when: Enable AI Follow-ups is on.
- Range: 1–3
- Default: 1
- Use this when: start at 1. Raise to 2 or 3 only if you’ve confirmed the AI’s follow-ups are landing well and leads aren’t getting irritated.
Always transfer to a human when a customer sends an image
- Label: “Always transfer to a human when a customer sends an image” (checkbox, primary channel)
- Default: off
- Background: the AI can’t see what an image or file shows.
- When on: any image or file attachment in a later message hands the lead to a person.
- When off: the AI ignores the attachment and replies to the text, and hands off only when the customer asks about the attachment or the message can’t be answered without it.
- Not for the welcome: a lead that arrives with an image still gets an AI welcome first.
- Either way: instructions in Instructions for the AI that explain how to handle attachments take priority.
When the AI hands a lead to a person, the AI stops for that lead, the lead moves to Follow-up, a note with the reason is added to the lead, and your messenger integrations get an alert with the customer’s message.
Shared AI settings
One set, used by the primary channel and SMS whenever either is in AI mode. Set these once.
Instructions for the AI
- Label: “Instructions for the AI” (in the What the AI should know section)
- Type: free-text, up to 7,000 characters
- Purpose: how the AI should answer: tone (formal vs. casual), greeting, sign-off, phone number to share, and rules you want it to follow. Facts about the business go into the knowledge base below it.
Example:
Begin your answer with "Hey" followed by the customer's name. Keep it
friendly and short. Conclude each message with: "Best regards,
Construction Team, (213) 555-0142."
Put prices, services and other facts in the knowledge base, not in the instructions. When the two disagree on a price or fact, the AI uses the knowledge base; the instructions still decide how it behaves, including whether it brings up prices at all. See which one wins.
Knowledge base
What the AI knows when it answers: About the business, Prices, Services you don’t provide, FAQ and files. A request for a service listed in Services you don’t provide is declined and gets no follow-ups. A knowledge base can be shared with other sources and with voice agents.
Appointment Scheduling
Let the AI check availability and book appointments. Turn it on with the switch on the Appointment Scheduling panel.
Set up Appointment Scheduling →
Test AI Assistant
Click Test AI Assistant at the bottom of the tab to chat with the AI using the settings on screen, saved or not.
How it behaves
- Shared settings, per-channel behavior: Instructions for the AI, the knowledge base and scheduling apply to every channel in AI mode. The conversation mode, delays, and follow-up limits are read from whichever channel the lead is on.
- Manual takeover: if you or a teammate reply manually in the thread, the AI conversation stops for that lead. AI follow-ups also stop.
- Per-lead switch: you can turn the AI off for one lead from the Leads page. See Leads.
- Confirmation messages: the contact-info confirmation message is not sent when AI Assistant is set to a Short or Long conversation; while the AI is answering, it reads the contact info and replies itself.
Troubleshooting
- AI sounds generic or off-brand: expand Instructions for the AI (tone, sign-off, phone number) and fill in About the business and FAQ in the knowledge base.
- Can Instructions for the AI make the assistant appear human?: no. Customize an AI persona’s name and tone, but do not instruct it to claim it is a person, the owner, or an employee, or to deny being AI.
- AI is quoting the wrong price: check Prices in the knowledge base, and remove any prices from Instructions for the AI.
- AI is taking leads you can’t service: list them in Services you don’t provide in the knowledge base.
- Too many AI follow-ups: lower Max AI Follow-ups, or turn AI Follow-ups off.
- AI Follow-ups checkbox is missing: change AI Conversation Mode to Short or Long conversation - the setting doesn’t apply in “Only welcome message” mode.
- The shared AI settings aren’t shown: turn on AI Assistant for at least one channel (the primary channel or SMS).
- The shared AI settings are greyed out: the source uses its business’s settings (Business Settings Active) - turn on Customize for Location.
- The AI stopped answering after a customer sent a photo: the lead was handed to a person. Turn off Always transfer to a human when a customer sends an image, or explain in Instructions for the AI how to handle attachments.
Questions? Email support@nzleads.com.