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:

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.

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

Messages already in the channel stay.

Troubleshooting


Questions about the Slack integration? Email support@nzleads.com.

Get Started