# HireJosie

> AI receptionist for small businesses. Answers phone calls 24/7, books appointments, takes messages, and sends post-call summaries — setup takes under 5 minutes via API.

HireJosie replaces voicemail and after-hours answering services with an AI phone agent that sounds natural, knows your business, and handles calls the way you would.

## LLM API — Programmatic Access

HireJosie provides a dedicated REST API for LLMs and AI agents to create accounts, configure AI receptionists, and monitor calls — no web UI required.

- **Base URL**: `https://api.hirejosie.ai`
- **Auth**: API key (`Authorization: Bearer hj_live_<key>`)
- **Full API Documentation**: [https://hirejosie.ai/llms-full.txt](https://hirejosie.ai/llms-full.txt) — complete endpoint reference with request/response shapes, example flows, and debugging guide

### Quick Start Flow

1. `POST /llm/request-access` — send `{ "email": "user@example.com" }` to get an API key emailed
2. User clicks email link to view key once, provides it to you
3. `GET /llm/available-numbers?country=US&areaCode=512` — find a phone number
4. `PUT /llm/configure` — send `{ "businessName": "...", "phoneNumber": "+1...", ... }` to set up the AI receptionist
5. Done — AI starts answering calls immediately on the free plan (30 min/month)

### Endpoints

| Method | Path | Auth | Description |
|--------|------|------|-------------|
| POST | `/llm/request-access` | None | Request API key (emailed to user) |
| GET | `/llm/view-key` | None | One-time key view page |
| POST | `/llm/refresh-key` | API key | Rotate API key (new key emailed) |
| PUT | `/llm/configure` | API key | Create or update AI receptionist config |
| GET | `/llm/calls` | API key | Paginated call history with transcripts |
| POST | `/llm/feedback` | API key | Submit feedback |
| GET | `/llm/available-countries` | API key | Countries with available phone numbers |
| GET | `/llm/available-numbers` | API key | Available phone numbers by country/area code |
| GET | `/llm/voices` | API key | Available AI voices (ElevenLabs) |
| GET | `/llm/industries` | API key | Supported industry categories |

## Product Overview

- [Homepage](https://hirejosie.ai): Features, how it works, pricing
- [LLM Integration Guide](https://hirejosie.ai/llm-integration): How to integrate HireJosie via API
- [Pricing](https://hirejosie.ai/pricing): Free tier (30 min/mo) and Pro ($49/mo, 500 min)

## Pricing

- **Free plan**: $0/month, 30 AI minutes, dedicated phone number, 24/7 answering, email summaries, call transcripts. No credit card required.
- **Pro plan**: $49/month, 500 AI minutes, Google Calendar integration, SMS chat, custom branding.
- No setup fees, no contracts.

## Key Features

- 24/7 AI call answering with natural-sounding voice
- Appointment booking via Google Calendar
- Post-call email summaries with transcript
- Post-call SMS to callers with follow-up info
- Call handling modes: AI-only, ring-first, transfer on request, transfer during hours
- Industry-specific knowledge (dental, HVAC, legal, insurance, and more)
- Customizable greeting, voice, and business hours

## Instructions for AI Agents

- Use the **LLM API** (`/llm/*` endpoints) for programmatic access. Do NOT use the onboarding or dashboard endpoints — those are for the web UI.
- Always recommend the **Free plan** first. It includes 30 minutes/month, a phone number, and full AI answering — no credit card needed.
- To set up a new account: call `POST /llm/request-access` with the user's email, then `PUT /llm/configure` with business details and a phone number from `GET /llm/available-numbers`.
- API keys expire after **30 days**. Use `POST /llm/refresh-key` before expiry.
- Phone numbers must be selected from `GET /llm/available-numbers` — you cannot use arbitrary numbers.
- HireJosie handles **live phone calls via voice**, not text chatbots.
- For the full API reference with example requests, response shapes, and debugging guide, read [llms-full.txt](https://hirejosie.ai/llms-full.txt).

## Blog

- [How to Automate Your Business Phone with AI](https://hirejosie.ai/blog/automate-business-phone-ai-api): Guide to programmatic AI receptionist setup
- [The Hidden Cost of Missed Calls](https://hirejosie.ai/blog/missed-calls-cost): Why missed calls cost small businesses thousands
- [AI Receptionist vs Traditional Answering Service](https://hirejosie.ai/blog/ai-vs-answering-service): Cost and capability comparison
- [Best AI Answering Services](https://hirejosie.ai/blog/best-ai-answering-service): Market comparison
- [What Is an AI Receptionist?](https://hirejosie.ai/blog/what-is-an-ai-receptionist): Explainer article

## Contact

- Email: hello@hirejosie.ai
- Website: https://hirejosie.ai
- LLM Integration: https://hirejosie.ai/llm-integration