> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fluents.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Keragon

> Trigger AI-powered outbound calls directly from Keragon healthcare automation workflows using the Fluents connector.

# 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

<Note>
  * A [Keragon](https://www.keragon.com) account
  * A [Fluents.ai](https://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**
</Note>

***

## 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.

<Note>
  Your API key is stored securely by Keragon and sent as a `Bearer` token on every request to the Fluents API.
</Note>

### 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.

#### Inputs

| 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`                                                                                                                          |

<Tip>
  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.
</Tip>

#### 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                                            |

<Note>
  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.
</Note>

***

### 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.

#### Inputs

| 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.

#### Inputs

| 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:

1. **Trigger** — A new appointment record is created in your EHR or CRM
2. **Fluents: Start call** — Call the patient using your appointment-reminder agent, passing `first_name`, `appointment_date`, and `provider_name` as context
3. **Condition** — Branch on `stage_outcome`:
   * `human_answered` → mark the appointment as confirmed
   * `human_unanswered` or `voicemail` → schedule a follow-up call for the next day

<Tip>
  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.
</Tip>

***

## 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.

<Note>
  Your Fluents account must be configured for HIPAA compliance. Contact [support@fluents.ai](mailto:support@fluents.ai) to enable this on your account.
</Note>

***

## 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](https://platform.fluents.ai).