SMS
The SMS integration texts lead notifications to the phone numbers you add - new leads, contact info a customer shares, customer messages the AI didn’t answer, appointments, and voice-agent call summaries. You don’t need to bring your own phone service - NZ Leads sends the texts from its own number. Each number is confirmed with a code before it gets alerts.
This is an alert to your team, not a conversation with the lead. It texts you when something happens with a lead. To text the lead and carry on a two-way SMS conversation (with its own welcome, AI, and follow-ups), use SMS Messaging instead - that’s a separate feature with its own registration.
You set SMS up once and then choose which sources and voice agents send alerts to its numbers. Add it from a source’s Messaging Settings → Integrations tab, from a voice agent’s Integrations section, or from Settings → Integrations in the menu, which lists all your integrations.
What gets texted
- New lead - the customer’s name, the address and original request when known, and a link to the conversation. Only when Notify on new lead is on.
- Contact info - the customer’s name and the phone number or email they shared. Only when Messengers is ticked under Trigger integrations: in the source’s Contact Info settings.
- Customer message - the customer wrote and the AI didn’t answer, for example because the AI is off for this lead, it handed the lead over to your team, or it reached its message limit. The text has the customer’s name and a link to answer.
- System notices - for example “AI message limit reached” or a file the customer sent.
- Appointments - the customer, the time, and a phone number to call back. A booking also lists the service and the address when known.
- Call finished - a voice-agent call ended: the phone number, the start of the call summary, and the recording link.
Every number on the list gets every text. A very long text is shortened so carriers accept it - open NZ Leads to see the whole conversation.
Connecting SMS
Add SMS
In NZ Leads, open the source → Messaging Settings → Integrations tab → Add integration → Create new → SMS. The SMS window opens. If your account already has an SMS integration, pick it on the Use existing tab instead.
Add a phone number
Under Add new phone number, type the number in Enter new phone number (full number including country code, e.g. +1 202 555 0123) and click Send code.
Confirm the number
A code is texted to that number. Type it in Enter code and click Verify to add the number to the list. Every number must be confirmed this way. Didn’t get it? Use Resend code once its timer runs out, or Change number to fix a typo. Repeat to add more numbers - each one gets its own text for every alert.
Turn on the Enabled toggle
Turn on Enabled next to Connected phone numbers. A new SMS integration stays off until you do. The integration doesn’t send anything while it is off.
Remove numbers you don’t want
Expand a number on the list and click its delete button, then confirm. Removed numbers stop getting alerts immediately. Removing the last number turns the integration off.
To send alerts for another source to the same numbers, open that source’s Integrations tab → Add integration → Use existing and pick this SMS integration. You can also tick sources and voice agents under Where it’s used in the SMS window. If you added SMS on the Integrations page, it isn’t used anywhere yet: tick the places under Where it’s used.
Options
Enabled
Turns this SMS integration on or off everywhere it’s used. The toggle appears once a number is on the list. To stop texting for one source only, switch SMS off on that source’s Integrations tab (if the source follows its business, turn on Customize for Location first), or untick the source under Where it’s used in the SMS window.
Phone numbers
The numbers that receive the texts, listed under Connected phone numbers. Add as many as you need - each number on the list receives its own text every time. Use this to route alerts to multiple on-call people at once.
For an on-call rotation, keep the list short and update it when the rotation changes. Everyone on the list gets every alert, so adding your whole team usually isn’t ideal.
Notify on new lead
Default: off. Shown once a number is on the list. When on, a text goes out for a new lead. For message sources such as Yelp or Thumbtack, it goes out together with the first automated reply: after any welcome delay, or once the bot’s off-hours end. With Skip welcome message & follow-ups on, none is sent. When off, there is no new-lead alert; you still get an alert when a customer sends a message the AI doesn’t handle or when the AI hands the lead to a person, and when contact info arrives if Messengers is checked under Trigger integrations: in the source’s Contact Info tab.
Include source name in messages
Label: Include source name in messages. Default: off. Shown once a number is on the list. When on, the source name is added to the SMS alert so you can tell sources apart.
Disconnecting
- For one source - switch SMS off on that source’s Integrations tab, or untick the source under Where it’s used. Other sources keep texting.
- Everywhere - remove every number on the list, switch Enabled off, or click Delete integration in the SMS window. Removing the last number turns the integration off and no more alerts are sent.
Troubleshooting
- No texts arriving - Check that Enabled is on, that SMS is on for the source on its Integrations tab, and that the number is on the list with the country code. If Notify on new lead is off, new leads don’t send a text; contact-info texts need Messengers in Contact Info.
- The code never arrives - Check the format (full international format with
+and country code), make sure the phone can receive texts from unknown senders, and use Resend code. - “Phone number(s) invalid” - The number couldn’t be checked as a real phone number. Enter it again with the country code.
- “This phone number is already connected to your integration” - The number is already on the list.
- “You entered an invalid code” - Check the code in the latest text, or click Resend code.
- Texts are delayed - Rare, but carriers can introduce delivery delays during high-volume periods. If it’s a consistent issue, contact support.
- The integration shows “Has errors” - Open it and click the warning icon at the top of its Settings to see why a text failed. Errors from the last 7 days are shown.
Questions about the SMS integration? Email support@nzleads.com.