Zendesk Integration
The Fluents.ai Zendesk App embeds your Fluents voice AI agents directly inside Zendesk. Support teams get a unified view of every AI-handled call, can create tickets in one click, and can trigger outbound AI calls without leaving the ticket.
Prerequisites
- A Zendesk account (Suite Team or above)
- A Fluents.ai account with at least one agent and one phone number configured
- Your Fluents API key — found in your Fluents dashboard under Settings → API Keys
Installation
1. Download the app
Download the latest fluents-zendesk-app.zip from the Fluents GitHub repository.
2. Open Zendesk Admin
Go to Admin Center → Apps and integrations → Apps → Zendesk Support Apps.
3. Upload the app
Click Upload private app, select the .zip file, and click Upload.
4. Enter your API key
During installation, paste your Fluents API Key into the Fluents API Key field.
The API key is stored securely via Zendesk’s encrypted app settings — it is never exposed to the browser.
5. Enable the app
Click Install. The app will appear in the Zendesk top navigation bar and in the ticket sidebar.
Once installed, the app is available in two places:
| Location | Purpose |
|---|
| Nav bar (main app) | Full call list, analytics, and transcript viewer |
| Ticket sidebar | Click-to-call and requester call history |
If you rotate your Fluents API key, re-install the app with the new key via Admin Center → Apps → Fluents.ai → Settings.
Call List & Filters
The Call List is the main view of the app. It shows your most recent 200 calls, paginated 10 per page, with a filter bar at the top.
Filter bar
| Control | Description |
|---|
| Agent dropdown | Filter calls by a specific Fluents AI agent |
| From date | Start of the date range (inclusive, from 00:00) |
| To date | End of the date range (inclusive, through 23:59) |
| Today / Yesterday / This week | Quick date shortcuts |
| Clear | Resets all filters and reloads |
Filters apply automatically on change — changing the agent or date fields immediately reloads the list with no extra button click.
Call row
Each call in the list displays:
| Field | Description |
|---|
| Outcome badge | Color-coded outcome (green = human-answered, purple = bot/no-answer) |
| Agent name | The Fluents AI agent that handled the call |
| Phone numbers | Caller and called numbers |
| Date / time | When the call started |
| Duration | Length of the call |
| Ticket link | If a ticket was created, shows the Zendesk ticket number with a clickable link |
| Create ticket icon | One-click ticket creation (greyed out once a ticket exists) |
Ticket references
When you create a ticket from a call, the ticket number is saved in browser local storage keyed to the call ID. This means:
- The ticket reference persists across page reloads
- The create-ticket icon becomes greyed out to prevent accidentally creating duplicate tickets
- Each browser/device maintains its own references independently
Ticket references are stored locally in the browser. Clearing browser data will remove them. For a fully shared persistent reference, consider using a custom Zendesk ticket field mapped to the call ID.
Transcript Viewer
Clicking any call row opens the Transcript Modal — a full-screen overlay with the call conversation rendered as a chat.
| Element | Description |
|---|
| Agent avatar | Auto-generated initial avatar in the agent’s color |
| Agent name | The Fluents AI agent that handled the call |
| Outcome badge | Color-coded outcome label |
| Phone chips | Caller number and called number |
Chat bubbles
The conversation is displayed as iMessage-style chat bubbles:
| Speaker | Style |
|---|
| AI Agent | Light gray pill, left-aligned |
| Human | Fluents blue pill, right-aligned |
Create Ticket from transcript
The modal footer has a Create Ticket button that creates a Zendesk ticket pre-populated with:
- Subject:
AI Call – {agent name} – {date}
- Tags:
fluents-ai, ai-call, and the call outcome
- Internal note: Full call transcript and a link to the call
Once a ticket is created the button is replaced with a clickable ticket number link.
You can only create one ticket per call per browser. The create button is permanently disabled for that call once a ticket has been created.
Call Analytics
The Analytics Panel sits above the call list and loads automatically when the app opens.
Outcome distribution
A horizontal bar chart shows the count of each call outcome across your most recent 200 calls:
| Outcome group | Color |
|---|
human_answered, completed, appointment_booked | 🟢 Shades of green |
bot_disconnected, no_answer, voicemail, failed | 🟣 Shades of purple |
Call Insights
Below the outcome chart, the app samples the 30 most recent calls and aggregates every call_insights field. Each insight key is rendered as its own bar group showing the value distribution. The panel adapts dynamically to your account’s insight schema with no hardcoding.
Insights are sampled from the 30 most recent calls to keep the panel responsive. Analytics load once at app startup — reload the app to refresh.
The Sidebar appears in the right-hand panel of any Zendesk ticket. It lets agents start an outbound AI call and view the ticket requester’s recent call history.
Starting a call
Select an agent and phone number, then click Start AI Call.
| Field | Description |
|---|
| Agent | Which Fluents AI agent will handle the call |
| From number | The Fluents number the call will originate from |
| To number | Pre-filled from the ticket requester’s phone field (editable) |
The sidebar auto-selects the first available agent and number when it loads — in most cases the agent just needs to verify the fields and click Start AI Call.
fluents-ai and outbound-ai-call.
Requester call history
Below the call form, the sidebar shows the last 5 Fluents calls associated with the ticket requester’s phone number, including:
- Call outcome badge
- Date, time, and duration
- Transcript preview (click to expand inline)
This gives agents full context on previous AI interactions before they intervene or initiate a new call.
Auto-Ticket Creation
The Auto-Ticket feature polls your Fluents account every 60 seconds and automatically creates a Zendesk ticket for any recently completed call that doesn’t already have one.
Enabling auto-tickets
Toggle the Auto-tickets switch in the call list filter bar. The toggle state is saved in browser local storage and survives page reloads.
When enabled:
- The app polls for new calls every 60 seconds
- Any call completed in the last 5 minutes without a local ticket reference is processed
- A Zendesk ticket is created automatically
- The ticket reference is saved so the same call is never processed twice
Ticket contents
| Field | Value |
|---|
| Subject | AI Call – {agent name} – {date} |
| Status | New |
| Tags | fluents-ai, ai-call, {outcome} |
| Internal note | Full transcript (if available) |
If multiple agents use the app from different browsers, each browser tracks its own ticket references independently. Use a shared Zendesk view filtered by the fluents-ai tag to avoid duplicate processing.
Live Call Badge
The Live Call Badge is a pulsing animated indicator in the top-right of the app header.
| State | Display |
|---|
| No active calls | Badge is hidden |
| 1+ active calls | Pulsing green dot + call count + “Live” label |
in_progress. This helps supervisors and team leads see at a glance that the AI is active.
