Troubleshoot AI lead manager issues
ZTZenoti Docs Team Updated June 26, 2026 3 min readGuide
This article helps you resolve common issues with AI Lead Manager, including lead access, integration problems, form submissions, and workflow failures.
Lead access issues
Employee cannot see any leads
- Verify the employee has the My Leads or All Leads permission on the AI Lead Manager permissions groups.
- If the employee has only the My Leads permission, they can only see leads assigned to them. Confirm that leads are assigned to this employee.
- Check that AI Lead Manager is enabled for the organization.
Employee cannot create leads
- Verify the employee has the Add permission on the My Leads or All Leads permissions.
- If the employee has only the My Leads Add permission, they can only create leads assigned to themselves.
Employee cannot access the dashboard
- Verify the employee has the View permission under Lead Management Dashboard.
Employee cannot modify settings
- Verify the employee has the View permission under Lead Settings.
- For specific settings, verify the employee has the appropriate Add/Edit/Delete permissions on the relevant permissions group (Lead Stages, Lead Sources, Lead Types, Task Types, or Call Outcomes).
Integration issues
Integration shows "Token Expired"
Platform access tokens expire periodically. To resolve:
- Navigate to Integrations and select the affected integration.
- Select Re-authorize.
- Sign in to the platform (Meta or Google) and grant the requested permissions.
- After successful authorization, the integration resumes capturing leads.
Leads are not being captured from the integration
- Check that the integration status is Active.
- Check that the integration's platform forms are synced and have field mappings configured. See Configure integration field mapping.
- Verify that the forms on the advertising platform are active and receiving submissions.
- If the integration was recently connected, allow a few minutes for the initial sync to complete.
Field mapping shows "Unmapped"
Unmapped forms cannot populate lead data correctly:
- Navigate to the integration detail page.
- Select the unmapped form.
- Map each platform field to the corresponding lead field.
- Select Save.
Form issues
Custom form submissions are not creating leads
- Verify the form status is Active. Draft and Inactive forms do not accept submissions.
- Check that form fields are mapped to lead fields. Unmapped fields may result in incomplete lead records.
- Verify that the share URL is valid and has not been regenerated since it was shared.
Prospects see an error when accessing the form URL
- Verify the form is in Active status.
- If the share URL was regenerated, the old URL is no longer valid. Share the new URL with prospects.
Workflow issues
Workflow is not triggering
- Verify the workflow status is Active. Draft, Paused, and Inactive workflows do not process new events.
- Check the trigger conditions. If conditions are too restrictive, matching leads may not activate the workflow.
- Verify that the trigger event type matches the lead action (for example, a "Lead created" trigger fires only when new leads are created, not when existing leads are edited).
Workflow step failed
- Open the workflow detail page and select the Instances tab.
- Find the failed instance and select it to view step details.
- Check the step that failed and review the error information.
- Common causes:
- Missing contact data -- The lead does not have an email address or phone number required by the Send Email or Send SMS step.
- Template error -- The notification template has invalid macros or is missing.
Workflow emails or SMS are not being received
- Verify the lead has a valid email address or phone number.
- Check the notification template for errors by sending a test notification.
- Verify the lead has consented to receive notifications (if consent checking is enabled).
Guest linking issues
Lead is not linked to the correct guest
Automatic guest linking matches leads to existing guest profiles by email or phone. If the wrong match occurred:
- Open the lead detail view.
- Use the manual guest linking option to search for and select the correct guest.
Note: Manual guest linking can only be done once per lead. If you need to change a manual link, contact your administrator.
Lead shows no linked guest
- Guest linking runs as a background process. Wait a few minutes for the system to complete the linking.
- If the lead has no email or phone number, guest linking may not find a match. Update the lead's contact information to trigger a new linking attempt.
- If no matching guest exists in Zenoti, the system automatically creates a new guest profile.
Was this article helpful?
Your feedback helps us improve our documentation.