# Start building with HeyRik.

> Start with the official HeyRik docs. Learn how to create an AI voice agent, connect knowledge and phone numbers, place calls, and use structured call results.

Source: https://www.heyrik.com/docs/introduction

Turn a business task into a useful conversation. Build your first voice agent in the dashboard, or connect HeyRik to your own application.

[In the dashboard**Build your first agent** Follow a guided path from an idea to a tested voice agent. No code needed._Start the guide_](https://www.heyrik.com/docs/academy/plan-agent)[With your own code**Connect to the API** Get an API key, make your first request, and bring HeyRik into your product._Get started with the API_](https://www.heyrik.com/docs/guides/api-key)

## From first draft to first call

A clear sequence, with a useful result at every step.

1.  ### Define the job
    
    Choose one outcome and write a clear brief.
    
    [Plan your agent](https://www.heyrik.com/docs/academy/plan-agent)
2.  ### Build the agent
    
    Create a draft. Add its instructions, voice and knowledge.
    
    [Create a draft](https://www.heyrik.com/docs/academy/create-agent)
3.  ### Test the conversation
    
    Try real questions, difficult cases and human handoffs.
    
    [Test and launch](https://www.heyrik.com/docs/academy/test-and-launch)
4.  ### Learn from every call
    
    Review the results and improve one thing at a time.
    
    [Review call results](https://www.heyrik.com/docs/academy/improve)

## The building blocks

Each part has one clear responsibility.

[**Agent** — The AI that speaks and makes decisions during the call. — Real estate qualifier](https://www.heyrik.com/docs/api-reference#agents)[**Conversation Flow** — Ordered instruction sections that control how the agent behaves. — Ask budget → location → timeline](https://www.heyrik.com/docs/guides/conversation-flow)[**Knowledge base** — Approved facts the agent can use when answering questions. — Pricing PDF and refund policy](https://www.heyrik.com/docs/api-reference#knowledge)[**Phone number** — The connection used to receive or place calls. — +91 business number](https://www.heyrik.com/docs/api-reference#phone-numbers)[**Custom API** — A tool the agent can call during a conversation. — Check appointment availability](https://www.heyrik.com/docs/api-reference#custom-apis)[**Call result** — The record your application receives after the call. — Transcript, outcome, and extracted fields](https://www.heyrik.com/docs/api-reference#calls)

## What you can build

The same platform primitives support different industries and outcomes.

### AI receptionist

Answer every inbound call, explain opening hours, collect the caller’s intent, book appointments, and route urgent requests.

### Lead qualification agent

Call new leads, understand requirements, qualify interest, capture structured fields, and schedule the right follow-up.

### Customer support agent

Identify the customer, answer from approved policies, look up information through a custom API, and create a ticket when needed.

### Campaign calling agent

Call a list of leads for reminders, surveys, renewals, or outreach, then export outcomes for your workflow.

## Create your first agent

This small example creates a support agent. The request defines its identity, opening line, and basic behavior.

**Request**

```
curl -X POST https://server.heyrik.com/api/v1/agents \
  -H "Authorization: Bearer $HEYRIK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Support Agent",
    "language": "en-IN",
    "greeting": "Hi, thanks for calling Acme. How can I help?",
    "config": {
      "personality": "Friendly",
      "prompt_sections": [
        {
          "order": 0,
          "title": "Identity & Purpose",
          "content": "You are Acme’s support agent. Resolve the caller’s question using approved company information."
        },
        {
          "order": 1,
          "title": "Guardrails",
          "content": "Never invent policy details. If the answer is unavailable, offer a human follow-up."
        }
      ]
    }
  }'
```

**Example output**

```
{
  "data": {
    "id": "agc_9f2a1c30",
    "name": "Support Agent",
    "language": "en-IN",
    "greeting": "Hi, thanks for calling Acme. How can I help?",
    "config": {
      "personality": "Friendly",
      "prompt_sections": [
        { "order": 0, "title": "Identity & Purpose", "enabled": true },
        { "order": 1, "title": "Guardrails", "enabled": true }
      ]
    },
    "created_at": "2026-07-24T06:11:44.201Z"
  }
}
```

## What the call output looks like

After a call finishes, your application can read the outcome and use it in the next workflow.

**Completed support call**

_resolved_

Caller**+91 98765 43210**

Duration**3m 42s**

Outcome**Refund policy explained**

Extracted field**order\_id: ORD-2048**

Next action**No follow-up required**

**GET /calls/{id} response**

```
{
  "data": {
    "id": "call_1dd990f7",
    "status": "completed",
    "outcome": "resolved",
    "summary": "Caller asked about the refund window. The agent explained the approved 14-day policy.",
    "extracted_variables": { "order_id": "ORD-2048" },
    "transcript_url": "https://…",
    "recording_url": "https://…"
  }
}
```

## Choose your next step

Continue with the guide that matches what you need to build.

[Get your API key — Authenticate and test your first request safely. — Continue](https://www.heyrik.com/docs/guides/api-key)

[Design the conversation — Turn the job into a structured, reliable flow. — Continue](https://www.heyrik.com/docs/guides/conversation-flow)

[Generate a draft with AI — Start from a plain-language description. — Continue](https://www.heyrik.com/docs/guides/design-with-ai)