AI Agents

Setup AI agents API key

Integrate voice and AI Agents with your custom API in Smart Directory AI.

Last updated on 09 Feb, 2026

Let's do it together!

Step 1: Access Dashboard

Open your Smart Directory AI installation and access the main dashboard.

Snapshot

Step 2: Generate API Key

Navigate to Settings → Integrations, and click Generate API key. Copy the key to your clipboard.

Snapshot

Step 3: Collect Business Email

Go to Contacts, apply filter by tag for businesses, and select a business email to copy.

Snapshot

Step 4: Collect Consumer Email

Again in Contacts, filter by consumer tag and copy a consumer email or register as a new consumer.

Snapshot

Step 5: Check Email Conditions

Ensure that the consumer email has not claimed the corresponding business.

Snapshot

Step 6: Access AI Agents

Navigate back to AI Agents in the left menu to set up the voice AI agents.

Snapshot

Step 7: Set Up Inbound Agent

Select the inbound agent, go to Agent Goals, and edit the Look up a listing action.

Snapshot

Step 8: Input API Key

Paste your custom API key into the authorization section.

Snapshot

Step 9: Input Business Email

In the parameters variable section, paste the business email you copied earlier.

Snapshot

Step 10: Test Inbound Action

Click Test Webhook, then click Initialize Action and save the changes.

Snapshot

Step 11: Set Up Outbound Agent

Switch to the outbound agent, go to Agent Goals, and select Claim a listing action.

Snapshot

Step 12: Input API Key Again

Paste your custom API key into the authorization section of the outbound agent.

Snapshot

Step 13: Input Consumer Email

Insert the consumer email and the business email in the parameters section.

Snapshot

Step 14: Test Outbound Action

Click Test Webhook, then click Initialize Action and save the changes.

Snapshot

Step 15: Confirmation

Your voice AI inbound and outbound agents are now set up for use with your Smart Directory AI site.

Snapshot

Troubleshooting

API key not working
Ensure the API key is correctly pasted without extra spaces.
Emails not recognized
Verify that the consumer email has not claimed the business.

FAQ

Can I use my own email?
Yes, but ensure it meets the integration requirements.
What if I don’t have consumers?
Sign up as a consumer on your directory site.

Did you find this article helpful?
Previous

Update custom values & webhook

Next