Setting Up Alhena AI on Zoho SalesIQ: OAuth, Departments, and Go-Live Checklist

Your Zoho SalesIQ portal handles live chat and chatbot automation. Alhena AI handles the selling, order lookups, and smart escalations. Connecting the two platforms takes about 15 minutes of admin work, no code, and zero webhook configuration on your end.

This guide walks you through the full setup: OAuth connection, department routing, escalation mapping, and a go-live testing checklist for marketing and support teams. If you want the strategic "why" behind this integration, read our posts on cart recovery and order lookup on SalesIQ and turning SalesIQ into a shopping assistant. This post is the hands-on "how".

How the Integration Works (Architecture)

Here's the flow in plain terms:

1. A visitor on your website opens your SalesIQ live chat widget and types a question.
2. Zoho SalesIQ delivers that message from the visitor to Alhena's AI bots to Alhena's pre-registered webhook endpoint (registered automatically during OAuth setup).
3. Alhena's Product Expert Agent generates a grounded, hallucination-free reply using your product catalog data and knowledge base data.
4. Alhena posts the reply back into the SalesIQ conversation via Zoho's API.
5. If escalation triggers, Alhena creates a Zoho Desk ticket with full conversation context and customer data and routes to human operators.

You don't host an endpoint. You don't write webhook handlers. You don't verify HMAC signatures. Alhena owns the entire event-handling layer.

Prerequisites Before You Start

Gather these before clicking "Connect":

• Zoho SalesIQ admin role on the target portal (you'll approve OAuth scopes)
• Zoho Desk org if you want escalation tickets routed there (optional but recommended)
• Alhena workspace with Integrations permission enabled for your user
• Knowledge sources ready: product catalog, FAQ content, and brand voice configured in Alhena

Alhena requests OAuth scopes for SalesIQ read/write and Desk read/write during the consent step. No API keys to copy-paste, no secrets to rotate manually. Your ecommerce data stays secure.

Step-by-Step Setup in the Alhena Dashboard

The entire connection lives in Alhena's dashboard. Here's the walkthrough:

1. Navigate to Integrations → Zoho → Connect via OAuth. This opens a Zoho consent screen.
2. Approve the consent screen on accounts.zoho.com. You'll see the specific scopes Alhena needs (SalesIQ conversations, Desk tickets).
3. Select your SalesIQ portal and app. If you run multiple portals, pick the one where AI should respond.
4. Choose which departments route to Alhena. Each SalesIQ department can be toggled on or off independently. Start with one department to test your chatbot and expand after validation.
5. Configure escalation behavior. Map which Zoho Desk department receives escalation tickets. Add trigger rules based on sentiment, explicit request, or topic match.
6. Set the bot operator identity. This is the email and screen name that appears in SalesIQ when Alhena responds. Pick something like "AI Assistant" or your brand name.

Once you click Save, Alhena registers its webhook with Zoho automatically. The AI chatbot goes live in your selected departments within seconds, ready to engage visitors on your website across platforms and drive customer engagement.

Department Routing and Multi-Department Portals

Most e-commerce brands run multiple SalesIQ departments: Sales, Support, Returns, and VIP. Alhena gives you granular control:

• Per-department toggle: Enable Alhena on "Sales" and "General" while keeping "VIP" human-only.
• Independent knowledge bases: Each department can pull from different product data collections or FAQ sets for its live chat responses.
• Escalation rules per department: "Sales" might escalate after 3 unanswered questions; "Support" might escalate on refund requests.

If a department is disabled in Zoho's own settings, Alhena respects that flag and won't respond there regardless of your Alhena-side configuration.

Escalation: How Handoffs Work

When Alhena decides a conversation needs a human, two things happen simultaneously:

1. The visitor sees a smooth transition message in SalesIQ ("Let me connect you with a specialist").
2. Alhena creates a Zoho Desk ticket containing the full conversation transcript, customer context, and the reason for escalation.

Your operators pick up with complete context. No "can you repeat your issue?" moments. For a deeper look at escalation best practices, see our guide on AI-to-agent handoff without losing context.

Alhena also syncs operator replies back into its conversation record. If a human agent responds inside SalesIQ, that reply appears in Alhena's analytics so you get a unified view of the full interaction.

Go-Live Testing Checklist

Before announcing AI chat to your customers, run through this checklist:

• Basic response test: Open an incognito browser, visit your website, start a live chat on your SalesIQ widget, and ask a product question. Confirm Alhena replies with accurate, grounded information.
• Order lookup test: If order management is configured, ask "Where's my order?" with a test order number. Confirm the Order Management Agent returns the right status.
• Escalation test: Trigger a forced handoff (say "I want to talk to a human"). Confirm a Zoho Desk ticket appears with full context.
• Department isolation test: Chat in a department where Alhena is disabled. Confirm no AI response fires.
• Operator reply sync: Have a team member reply from SalesIQ's operator console. Confirm the reply appears in Alhena's conversation log.

For a broader validation framework, our 48-hour stress test guide covers load testing and edge-case scenarios before full rollout.

Troubleshooting Common Issues

• "Alhena isn't replying to chats" → Check that the OAuth token hasn't expired (reconnect if needed), the department is toggled on in Alhena, and the app ID matches your live portal.
• "Escalation tickets aren't appearing in Desk" → Verify your Zoho Desk org is connected and the department mapping is set. Check that the desk scopes were approved during OAuth.
• "Bot shows the wrong name" → Update the bot operator email and screen name in Alhena's Zoho integration settings.
• "Replies are slow" → Check your knowledge base size and how bots engage with product data. If you recently imported thousands of products, allow a few hours for indexing to complete.

What Happens After Go-Live

Once live, Alhena handles product questions, cart recovery prompts, lead capture, and proactive engage prompts, and order lookups autonomously. Your team focuses on complex cases, qualified leads, and conversations that need human judgment. Alhena provides the first line of customer engagement around the clock.

Track chatbot performance and customer data in Alhena's built-in analytics dashboard: deflection rate, revenue attributed to AI chatbot conversations, CSAT scores, visitor analytics, and escalation frequency. For tuning guidance during your first month, read our 30-day tuning playbook.

Ready to connect Alhena to your Zoho SalesIQ portal? Book a demo or start free with 25 conversations to see the integration in action.

Alhena AI

Schedule a Demo

Frequently Asked Questions