Slack
The Slack integration posts lead notifications into a channel in your Slack workspace - new leads, contact info a customer shares, customer messages the AI didn’t answer, booked appointments, and voice-agent call summaries. Your team sees them right in the channel they already live in, and everything about one lead stays in one thread.
You set Slack up once and then choose which sources and voice agents post into the channel. 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 posted
You’ll recognize each message by its label:
- New Lead - a new lead came in. Only when Notify on new lead is on.
- Phone Message or Email Message - the customer shared a phone number or email. Only when Messengers is ticked under Trigger integrations: in the source’s Contact Info settings.
- Sent a 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.
- System - a notice about the lead, such as “AI message limit reached” or a file the customer sent.
- Appointment Scheduled or Booking Summary - the AI agreed on an appointment or booked one.
- Call Finished - a voice-agent call ended, with the phone number, a call summary, and the recording link. See Voice Agent Integrations.
Lead messages also show the customer’s name and, where they apply, the address, the original request, and a link to the conversation. The first message about a lead starts a thread in the channel; later messages about the same lead are posted as replies in that thread.
Connecting Slack
Add Slack
In NZ Leads, open the source → Messaging Settings → Integrations tab → Add integration → Create new → Slack. The Slack window opens. If your account already has a Slack integration, pick it on the Use existing tab instead.
Click Connect with Slack
Under Settings, click Connect with Slack. You’ll be redirected to Slack to authorize the connection. Sign in to the workspace you want alerts to land in if you’re not already signed in.
Approve the scopes
Slack will ask you to approve these permissions:
chat:write- post messages into channels.channels:read- list your public channels so you can pick one.channels:join- join the public channel you pick so messages can be posted there.groups:read- list the private channels the NZ Leads app has been added to.
Approve and you’ll land on a page that says “Slack connected”. Click Continue: the Integrations page opens with your Slack integration.
Pick a channel
Click Load Channels if the list is empty, then pick a channel under Select Channel. The list is your workspace’s public channels, plus the private channels the NZ Leads app has been added to. This is the channel every lead alert of the places that use this integration will land in.
Turn on the Enabled toggle
The Enabled toggle can be turned on once a channel is selected. The integration doesn’t post anything until it is on.
To post another source into the same channel, open that source’s Integrations tab → Add integration → Use existing and pick this Slack integration. You can also tick sources and voice agents under Where it’s used in the Slack window. If you added Slack on the Integrations page, it isn’t used anywhere yet: tick the places under Where it’s used.
Options
Enabled
Turns this Slack integration on or off everywhere it’s used. Default: off. To stop posting for one source only, switch Slack 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 Slack window.
Channel
The Select Channel dropdown of channels in the connected Slack workspace. This is where the alerts will post. Change it at any time - new leads will go to the new channel. When you pick a public channel, the NZ Leads app joins it.
If a channel you want isn’t showing up, make sure the Slack app has been invited to it (for private channels) or that it’s a public channel in the connected workspace, then click Reload Channels.
Notify on new lead
Default: off. You can change it while Enabled is on.
- When on - A New Lead message is posted 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. When on, each message starts with Source: and the source’s name so you can tell sources apart. You can change it while Enabled is on.
Load Channels / Reload Channels
Fetches the channel list from Slack again, for example after you created a new channel.
Disconnect Slack
Asks “Are you sure you want to disconnect Slack?”. Yes removes the Slack OAuth connection and the channel and turns the integration off; the integration stays in your list, so you can sign in again with Connect with Slack. You should also remove the NZ Leads app from your Slack workspace via Slack’s App Management page if you want it fully cleaned up there.
When Slack needs reconnecting
If a source that uses this Slack integration moves to another account while other places keep using it, the moved source gets a copy without the Slack sign-in. The copy shows Needs reconnecting and posts nothing until someone opens it, clicks Connect with Slack, picks the channel in Select Channel and turns Enabled back on. After signing in, Slack is off and has no channel yet.
Disconnecting
- For one source - switch Slack off on that source’s Integrations tab, or untick the source under Where it’s used. Other sources keep posting.
- Everywhere - turn off Enabled in the Slack window, click Disconnect Slack, or click Delete integration there. Every source and voice agent that used it stops posting.
Messages already in the channel stay.
Troubleshooting
- The integration shows “Has errors” - Open it and click the warning icon at the top of its Settings to see why Slack refused the messages. Errors from the last 7 days are shown. If the OAuth connection was revoked in Slack, or the Slack app was removed from the workspace, click Disconnect Slack, then Connect with Slack, choose the channel, and turn on Enabled again.
- No messages arriving - Check that Enabled is on and that Slack is on for the source on its Integrations tab. Make sure you’ve selected a Channel. If the channel is private, make sure the NZ Leads Slack app is a member of the channel. New Lead messages need Notify on new lead, and contact-info messages need Messengers in Contact Info.
- Messages going to the wrong channel - Pick another channel in Select Channel.
- Can’t see a private channel in the list - Invite the NZ Leads Slack app to that channel from Slack, then click Reload Channels.
- “Needs reconnecting” - Open the integration, click Connect with Slack, pick the channel and turn Enabled back on (see When Slack needs reconnecting).
Questions about the Slack integration? Email support@nzleads.com.