Webhook tool

athenahealth AI receptionist that answers the front desk phone

The agent answers scheduling and office calls, reads and writes athenahealth through a service your team or integrator runs, and sends clinical calls to staff.

Practice front desk agent

Handles scheduling and office questions.

Instructions

Ask for the patient's name and date of birth. Offer appointment times from the schedule tool. Never discuss symptoms, results or medication. Transfer those calls to the nurse line right away.

Handoff
Nurse line

Connected tools

  • Get openingsWebhook
  • Book visitWebhook
  • Transfer to nurse lineTransfer

What a athenahealth AI voice agent can do

Open one to watch a call. The grey lines are the tools the agent calls mid-sentence.

The agent answers hours, directions, new-patient steps and appointment requests at any hour, so fewer calls wait for staff.

Tool definitions

Webhook tools go to POST /v1/agents/tools. Transfers are a system tool on the agent. Replace the placeholder values in capitals with your own.

Webhook

Get openings

Asks your service for openings by visit type.

Show the JSON definition
get_openings
{
  "type": "webhook",
  "name": "get_openings",
  "description": "Lists open appointment times for a visit type, and for a provider if the caller names one.",
  "pre_tool_speech": "auto",
  "execution_mode": "immediate",
  "response_timeout_secs": 20,
  "api_schema": {
    "url": "https://api.your-company.com/athena/openings",
    "method": "GET",
    "query_params_schema": {
      "properties": {
        "visit_type": {
          "type": "string",
          "description": "Visit type, such as new patient or follow-up."
        },
        "date": {
          "type": "string",
          "description": "Requested date, YYYY-MM-DD."
        },
        "provider": {
          "type": "string",
          "description": "Provider the caller asked for, if any."
        }
      },
      "required": [
        "visit_type",
        "date"
      ]
    },
    "authentication": {
      "mode": "bearer",
      "token": {
        "type": "secret",
        "secret_value": "YOUR_SERVICE_TOKEN"
      }
    }
  }
}

Webhook

Book visit

Sends the patient's name, date of birth and chosen slot to your service.

Show the JSON definition
book_visit
{
  "type": "webhook",
  "name": "book_visit",
  "description": "Books the chosen slot for the patient. Your service matches the patient by name and date of birth.",
  "pre_tool_speech": "auto",
  "execution_mode": "immediate",
  "response_timeout_secs": 20,
  "api_schema": {
    "url": "https://api.your-company.com/athena/appointments",
    "method": "POST",
    "request_body_schema": {
      "type": "object",
      "properties": {
        "patient_name": {
          "type": "string",
          "description": "Patient's full name, as the caller gave it."
        },
        "date_of_birth": {
          "type": "string",
          "description": "Patient's date of birth, YYYY-MM-DD."
        },
        "slot_id": {
          "type": "string",
          "description": "The slot identifier returned by get_openings."
        }
      },
      "required": [
        "patient_name",
        "date_of_birth",
        "slot_id"
      ]
    },
    "authentication": {
      "mode": "bearer",
      "token": {
        "type": "secret",
        "secret_value": "YOUR_SERVICE_TOKEN"
      }
    }
  }
}

Transfer

Transfer to nurse line

Cold transfer to the nurse line.

Show the JSON definition
transfer_to_nurse
{
  "config": {
    "system_tools": {
      "transfer_to_number": {
        "description": null,
        "pre_tool_speech": "auto",
        "transfers": [
          {
            "destination": {
              "type": "phone",
              "phone_number": "+14155550104"
            },
            "condition": "The caller mentions symptoms, test results, medication, or anything urgent about their health."
          }
        ]
      }
    }
  }
}

Set it up

No native connector. The agent calls a service your team or integrator runs, which holds your athenahealth API access. Vendor details read in October 2026.

  1. Confirm what your athenahealth access allows

    athenahealth grants API access to approved apps. Ask your account contact or integrator which scheduling data you may read and write.

  2. Build or buy the service

    It holds the athenahealth credentials and exposes the two endpoints. Return only what the agent needs to speak.

  3. Add the tools and a transfer rule

    Configure both webhooks and the nurse-line transfer in the Playground.

  4. Review calls before launch

    Listen to test calls with staff and tighten the instructions.

Before you build

Patient privacy is yours to settle

Decide with your compliance team what the agent may say, what your service logs, and what agreements you need before real patient calls.

This page describes a pattern

We do not publish athenahealth endpoint details because access depends on your agreement with athenahealth. The tool shapes show how the pieces connect.

Enterprise-grade security

  • HIPAA compliant badge

    HIPAA compliant

  • SOC 2 Type 2 badge

    SOC 2 Type 2

  • GDPR badge

    GDPR

athenahealth AI voice agent FAQs

Can an AI voice agent schedule appointments in athenahealth?

Yes, through a service that holds athenahealth API access. A Cartesia agent calls a service your team or integrator runs, and the service applies your scheduling rules. There is no native athenahealth connector.

How do I get athenahealth API access for a voice agent?

Ask your athenahealth account contact or integrator which scheduling data you may read and write. Then build or buy the service that holds those credentials and exposes two endpoints, one for openings and one for booking. This page doesn't publish athenahealth endpoints, because access depends on your agreement.

Is an athenahealth voice agent HIPAA compliant?

It can be, if every party that touches patient data has a business associate agreement. Cartesia offers BAAs on its Enterprise plan. Decide with your compliance team what the agent may say and what your service logs before real patients call. The healthcare guide lists what to check.

Can the agent read a patient's athenahealth chart?

Only if your service exposes it, and we recommend it doesn't. Keep the agent to scheduling and office questions such as hours, directions and new-patient steps, and let your service match the patient by name and date of birth before it books.

Which calls should the agent send to a person?

Questions about symptoms, medication and results go straight to the nurse line named in the transfer rule. Transfers only work on Twilio and SIP trunk calls, so put the number on Twilio or a SIP trunk.

What does an athenahealth voice agent cost to run?

Agents run at $0.03/min, plus LLM usage and telephony. athenahealth access, and any integrator who runs the service, are billed under your own agreements. Telephony comes from the number you use, a Cartesia number or your own Twilio or SIP trunk.

Get started today

Talk to an expert.

Connect with a member of our team and learn how Cartesia can help you build world-class voice experiences.

Contact Sales

Start building.

Access our models via API and bring a voice agent into production in minutes.

Try Cartesia