Keragon Integration
The Fluents connector for Keragon lets you trigger outbound AI voice calls from any Keragon workflow. Use it to automate patient outreach, appointment reminders, follow-ups, and any other scenario where a natural-sounding AI voice agent can handle the conversation automatically.
Prerequisites
- A Keragon account
- A Fluents.ai account with at least one AI agent and one phone number configured
- Your Fluents API key — found in your Fluents dashboard under Settings → API Keys
Installation & Authentication
1. Add the Fluents app in Keragon
Inside your Keragon workflow, click Add app and search for Fluents.
2. Authenticate
When prompted, select API Key as the authentication method and paste your Fluents API key.
Your API key is stored securely by Keragon and sent as a Bearer token on every request to the Fluents API.
3. Choose an action
The Fluents connector exposes three actions you can use inside any Keragon step:
| Action | Description |
|---|
| Start call | Trigger an outbound AI voice call to a phone number |
| Get agents | Retrieve all AI agents from your Fluents account |
| Get numbers | Retrieve all active phone numbers from your Fluents account |
Actions
Start Call
Triggers an outbound AI voice call. This is the primary action you’ll use in your workflows — for example, to call a patient after a form submission or a CRM update.
| Field | Required | Description |
|---|
| To number | ✅ | The phone number to call, in E.164 format (e.g. +14155552671) |
| From number | ✅ | The Fluents number to call from, in E.164 format. Populated automatically from your account’s numbers |
| Agent | ✅ | The AI agent to handle the call. Shown as Agent Name (ID) and populated from your Fluents account |
| Context | — | Key-value pairs injected into the agent’s prompt (e.g. first_name, appointment_date). Use these to personalise the conversation with patient or customer data from your workflow |
| On no human answer | — | What to do if no human picks up: continue (leave a voicemail / keep trying) or hangup. Defaults to continue |
| Run do not call detection | — | Check the callee against your Fluents DNC list before dialling. Defaults to true |
| HIPAA compliant | — | Flag the call as requiring HIPAA-compliant handling. Defaults to false |
| Human detection result | — | Override the human detection result (advanced use). Defaults to human |
| Do not call result | — | Override the DNC result (advanced use). Defaults to false |
Use Context to pass any patient or customer data from your Keragon workflow directly into the AI agent’s script — for example, {{ first_name }}, {{ appointment_time }}, or {{ provider_name }}. The agent can reference these variables naturally during the call.
Outputs
The action returns the full call object created by Fluents. Key output fields you can use in downstream Keragon steps:
| Field | Description |
|---|
| Call ID | Unique identifier for the call — use this to look up the call later |
| Status | Current call status (e.g. in_progress, completed) |
| Stage | Lifecycle stage of the call (e.g. created) |
| Stage outcome | Result of the call (e.g. human_answered, human_unanswered, voicemail) |
| Transcript | Full text transcript of the conversation |
| Recording available | Whether a recording can be retrieved |
| To number | The number that was called |
| From number | The number the call was placed from |
| Start time | ISO 8601 timestamp of when the call started |
| End time | ISO 8601 timestamp of when the call ended |
| Human detection result | Whether a human answered (human or other) |
| Do not call result | Whether the number was on the DNC list |
| HIPAA compliant | Whether HIPAA-compliant mode was active |
| Errors | List of any errors that occurred |
The Start call action returns as soon as the call is created — it does not wait for the call to finish. To react to the outcome (e.g. transcript, stage outcome), use a Fluents webhook to trigger a separate Keragon workflow when the call completes.
Get Agents
Retrieves all AI agents configured in your Fluents account. This action is used automatically by Start call to populate the Agent dropdown — you generally won’t need to use it directly unless you’re building a custom lookup step.
| Field | Default | Description |
|---|
| Sort by | created_at | Field to sort results by: created_at, updated_at, or name |
| Sort order | desc | Sort direction: asc or desc |
Outputs
Returns an array of agent objects. Each item includes the agent’s ID, name, label, and configuration.
Get Numbers
Retrieves all active phone numbers in your Fluents account. Used automatically by Start call to populate the From number dropdown.
| Field | Default | Description |
|---|
| Sort by | created_at | Field to sort results by: created_at, updated_at, or number |
| Sort order | desc | Sort direction: asc or desc |
Outputs
Returns an array of number objects. Each item includes the phone number and the name of any inbound agent assigned to it.
Example: Patient Appointment Reminder Workflow
A typical Keragon workflow using the Fluents connector looks like this:
- Trigger — A new appointment record is created in your EHR or CRM
- Fluents: Start call — Call the patient using your appointment-reminder agent, passing
first_name, appointment_date, and provider_name as context
- Condition — Branch on
stage_outcome:
human_answered → mark the appointment as confirmedhuman_unanswered or voicemail → schedule a follow-up call for the next day
Combine the Start call output’s Call ID with a Fluents webhook to retrieve the full transcript after the call ends and store it back in your CRM or EHR.
HIPAA Compliance
The Fluents connector supports HIPAA-compliant call handling out of the box. Enable the HIPAA compliant flag on the Start call action to ensure the call is routed and stored in compliance with healthcare data regulations.
Your Fluents account must be configured for HIPAA compliance. Contact support@fluents.ai to enable this on your account.
Do Not Call Detection
The connector automatically checks the callee’s phone number against your Fluents DNC list before placing the call (enabled by default). If a number is on the list, the call will not be placed and do_not_call_result will be true in the output.
To manage your DNC list, go to your Fluents dashboard.
