Integrations and Calls
Two tabs of Messaging Settings decide what happens with a lead outside the conversation:
- Integrations - which integrations get the leads of this source (or business): email, SMS, Slack, Telegram, CRMs, webhooks and the others. Each integration is set up once and turned on here, at any number of sources and businesses.
- Calls - the Voice Agent that calls this source’s leads and Call Bridge. These two stay settings of each source or business.
How to set up each integration (sign-in, field mapping, connection details) is on its own page in the Integrations catalogue.
Getting here
- A source - in NZ Leads, go to Sources → select a source → Messaging Settings → Integrations or Calls tab.
- A business - click the Business switcher in the sidebar → Messaging Settings next to the business → Integrations or Calls. If the business has sources of more than one type, pick All sources or one source type under Configuration target.
The Integrations tab
The tab lists the integrations this place uses, and the ones switched off here. Each row shows the integration’s name, what it sends to, and where it applies:
- Set for this source - switched on for this source itself.
- On - switched on for this business (in a business’s settings).
- From and a business name - switched on because the place follows that business.
- Off here - the integration is switched off here.
A row can also say Not set up yet, It has errors. Open its settings to see them., or Needs reconnecting (see statuses).
What you can do on a row:
- The switch - turns the integration on or off here. On a source it changes this source only. At a business, the change also reaches the places that follow it (see Customize for Location).
- Settings - opens the integration’s window (see The integration window).
- The X button (Remove from this list) - removes a switched-off integration from this list. It stays available under Add integration.
Search integrations… above the list finds a row by name. All integrations opens the Integrations page with every integration on your account, in a new tab.
Add integration
Add integration opens a window with two tabs:
- Use existing - pick an integration of this business or of a business above it. It’s turned on here right away.
- Create new - pick a kind (for example Slack or HubSpot). The new integration opens in its window: set it up there. It’s turned on here if nothing of its kind is used here yet. Otherwise you see ”… added. Set it up, then use it here.”: set it up, then pick it with Add integration → Use existing.
A place uses one integration of each kind at a time: turning on a second Slack, for example, asks you to confirm before it replaces the first one.
Customize for Location
A source follows its business’s integrations, and a business follows the business above it for the same source type.
- While the switch is off, the tab shows the business’s integrations, locked. On a source the switch is Customize for Location. On a business that has a parent business it’s Customize for Business, or Customize for and the source type (for example Customize for Yelp) while one source type is picked. A top-level business has no switch: its list is always its own.
- Turn it on to change the list for this place only. Nothing changes until you switch a row on or off or add an integration.
- Turning it off again asks “Use the integrations of its business?”. Stop customizing removes this place’s own choices, and it uses whatever its business uses, now and when that changes.
At a business, All sources applies to every source type of the business. If its source types use different integrations, the tab says so and shows one of them; a change you make then applies to all source types.
A business’s choice reaches all its sources and child businesses, including sources added later. Switching an integration on or off at a business also resets places below that had switched it off or on themselves; only places that use another integration of the same kind keep their own choice.
Only admins and managers of the business (or of a business above it) can change the integrations of a place. Everyone else sees the list read only: “Only an admin or manager of its business can change the integrations here.”
The integration window
Opened from Settings on a row, from All integrations, or from the integration’s icon on the source’s row on the Sources page. The heading shows the integration’s name, its kind, the business it belongs to, and its status.
- Rename - click the pencil next to the name, type the new name and click Save.
- Settings - the integration’s own options, described on its page in the Integrations catalogue. A change here applies to every place that uses the integration.
- Where it’s used - a tree of your businesses, source types, sources and voice agents with a checkbox on each. A business checkbox switches all source types below it, including future sources. Tick a source type or a single source for a narrower change. Use the search box to find a place.
- Delete integration - asks you to confirm, telling you how many sources and voice agents will stop sending to it, and then deletes it everywhere.
- Done - closes the window.
An integration owned by another business shows Managed by that business. You can’t change its settings, only turn it on or off for your own places where you’re allowed to. Needs reconnecting means the integration was copied without its sign-in and sends nothing until someone signs in again in its settings.
The Calls tab
Calls - “Call leads with a Voice Agent or connect them to your team with Call Bridge.” It has two cards, configured per source or business:
- Voice Agent - the AI voice agent calls this source’s leads when they share a phone number. See Outbound Calling.
- Call Bridge - connects you and the lead by phone when the lead shares a phone number. See Call Bridge.
Click a card to open its settings. The Calls tab has its own Customize for Location switch (on a business: Customize for Business, or Customize for All Sources with All sources picked). While it is off, the cards follow the business and are locked.
Inherit integration from Business
Shown on a card when the business above the source has that integration turned on, and only while Customize for Location is on. On a business that has a parent business, it reads Inherit integration from Parent Business.
- When on - the source uses the business’s setup of that integration, connection and options included.
- When off - the source has its own setup of that integration.
When each integration fires
Which events fire which integrations depends on each integration’s options and on the Contact Info tab:
- New lead arrives - CRM integrations fire unless Create lead in CRM only when contact info is received or Notify this integration only after the AI determines the lead is interested is on. Messenger integrations send a new-lead alert only when Notify on new lead is on. Zapier gets a lead only once its phone number or email is shared.
- When the new-lead notification goes out - for message sources such as Yelp or Thumbtack, together with the first automated reply: after any welcome delay, or once Bot Quiet Hours end. With Skip welcome message & follow-ups on, no new-lead notification is sent.
- Phone number captured - fires CRM, messenger and other integrations (such as Voice Agent and Call Bridge) according to the Trigger integrations: checkboxes in the Contact Info tab’s phone section.
- Email captured - the same, with the checkboxes in the email section.
- New messages - see Updates after the first send for which CRMs are updated.
How it behaves
- Per-source scope. Turning an integration on for one source has no effect on other sources. If you run two Yelp locations into two different CRMs, this is where you split them.
- No double-sends across sources. Each event fires the integrations selected on its source, not on every source.
- Turning an integration off here does not delete its setup. It stops firing for this source only; turn it back on any time without setting it up again.
Troubleshooting
- An integration you set up isn’t showing: it isn’t used here yet. Open Add integration → Use existing and pick it, or tick this place under Where it’s used in the integration’s window.
- The rows and Add integration are greyed out: the place follows its business: turn on Customize for Location. If you see a lock note instead, ask an admin or manager of the business.
- Integration is on but nothing is happening: check the Contact Info tab - the Trigger integrations: checkboxes there decide whether contact-info events fire integrations. Also check the integration for errors or Needs reconnecting: open it with Settings on its row, or from Settings → Integrations in the sidebar while the row is locked.
- Wrong CRM receiving the lead: turn on Customize for Location on this source and switch the right one on: it replaces the one of the same kind.
Questions? Email support@nzleads.com.