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

# Course overview

> A training course on HubTalk AI v4: from an empty canvas to the first outbound campaign. 27 modules built on one end-to-end example.

# Voice agent: from an empty canvas to the first outbound campaign

One end-to-end example — an agent for the Amanat medical center that confirms appointments and reschedules them. It covers every capability of the platform: graph nodes, variables, CRM calls, knowledge bases, transfer to a human, voice, telephony, an outbound campaign and post-call review.

* **Format:** self-paced, \~4 hours including practice
* **Access required:** the **Admin** or **Developer** role in the cabinet
* **Outcome:** your own agent that has passed testing and been published

> [!NOTE]
>
> **How to read the course**
>
> The modules follow the order in which an agent is actually built: first the dialog map, then the call settings, then the launch. Each module is a **goal**, **steps in the interface**, **a screenshot of that very screen** and **the pitfalls** people run into most often.
>
> Click a screenshot to open it at full size. Tall settings panels are shown in full — scroll the image.

> [!WARNING]
>
> **About the data in the screenshots**
>
> The screenshots were taken on test data. That is why CRM calls run in mock mode: mock responses instead of the clinic's real API. Names, numbers and dates in the frames are made up.

> [!NOTE]
>
> **Two market profiles**
>
> The course works for both calling market profiles — **Kazakhstan (kz)** and **USA — TCPA (us\_tcpa)**. The profile is set in the [organization settings](https://docs.hubtalk.ai/v4/platform/organization.md#general) and defines the legal calling rules.
>
> Building the agent (sections I–V) barely depends on the profile. Market differences show up when calling starts (section VI):
>
> * **Calling window.** For `kz`, it is the organization's calling window, which the campaign working hours can only narrow. For `us_tcpa`, it is the legal window in the contact's local time: federal rules, state rules and the campaign working hours, and the strictest wins.
> * **Contact file.** For `us_tcpa`, the `contact_zip` or `contact_state` column is required: the platform uses it to determine the contact's local time.
> * **Frequency limits.** For `us_tcpa`, they are on by default and are complemented by the state's legal limits; for `kz`, they are off by default.
> * **Do not call registry.** Automatic additions to the registry from a conversation work only for `us_tcpa`.
>
> The US profile is covered in detail in [US campaigns](https://docs.hubtalk.ai/v4/platform/campaigns/us-market.md).

## Course outline

### Section I · How an agent works

Before clicking anything, you need to understand the model: an agent is not one big prompt but a dialog map that the engine follows turn by turn.

1. [Dialog model: nodes, transitions, one turn](https://docs.hubtalk.ai/v4/tutorial/dialog-model.md)
2. [Cabinet: where things are](https://docs.hubtalk.ai/v4/tutorial/cabinet.md)
3. [Editor: canvas, palette, Begin](https://docs.hubtalk.ai/v4/tutorial/editor.md)

### Section II · Dialog logic

Five modules after which the agent can speak, listen, compute, query external systems and branch. This is the core of an agent author's work.

4. [Conversation: a phrase or a prompt](https://docs.hubtalk.ai/v4/tutorial/conversation-node.md)
5. [Transitions: five kinds and their priority](https://docs.hubtalk.ai/v4/tutorial/transitions.md)
6. [Variables: where they come from and where they go](https://docs.hubtalk.ai/v4/tutorial/variables.md)
7. [External systems: Function and tools](https://docs.hubtalk.ai/v4/tutorial/functions.md)
8. [Branching without a model: Logic Split](https://docs.hubtalk.ai/v4/tutorial/logic-split.md)

### Section III · Knowledge, reuse and people

A dialog rarely goes in a straight line: the customer asks an off-topic question, asks for a human or simply says goodbye. Four modules on how to plan for that.

9. [Global node and knowledge base](https://docs.hubtalk.ai/v4/tutorial/knowledge-base.md)
10. [Components: one block for all agents](https://docs.hubtalk.ai/v4/tutorial/components.md)
11. [Transfer to a human](https://docs.hubtalk.ai/v4/tutorial/transfer.md)
12. [Ending: End and the "interruptible goodbye"](https://docs.hubtalk.ai/v4/tutorial/ending.md)

### Section IV · Agent settings: voice and call

So far we have built *what* the agent says. Now — *how* it sounds and how it behaves on a phone line.

13. [Agent prompt, models and history window](https://docs.hubtalk.ai/v4/tutorial/prompt-and-models.md)
14. [Voice: recognition, synthesis, interruptions](https://docs.hubtalk.ai/v4/tutorial/voice.md)
15. [Call control and voicemail](https://docs.hubtalk.ai/v4/tutorial/call-control.md)
16. [Call recording and CRM notifications](https://docs.hubtalk.ai/v4/tutorial/recording-webhooks.md)

### Section V · Conversation quality

An agent that "seems to talk" and an agent for which you know what it achieved and where it broke the rules are different products. Five modules on measurability.

17. [Agent objectives](https://docs.hubtalk.ai/v4/tutorial/goals.md)
18. [Post-call analysis: what we learn after the call](https://docs.hubtalk.ai/v4/tutorial/post-call-analysis.md)
19. [Observers and incidents](https://docs.hubtalk.ai/v4/tutorial/observers.md)
20. [Validation, chat test, voice test, Copilot](https://docs.hubtalk.ai/v4/tutorial/testing.md)
21. [Publishing and versions](https://docs.hubtalk.ai/v4/tutorial/publishing.md)

### Section VI · Launch: how the agent starts calling

A published agent does not call anyone on its own. It needs a channel (telephony) and a trigger (a campaign, an inbound call or a call from your system via the API). This section is where the differences between market profiles show up: the calling window, the contact file and the Do not call registry.

22. [Telephony: trunk and routes](https://docs.hubtalk.ai/v4/tutorial/telephony.md)
23. [Outbound campaign: from a file to the first dial](https://docs.hubtalk.ai/v4/tutorial/campaign.md)
24. [A call from your system: the public API](https://docs.hubtalk.ai/v4/tutorial/public-api.md)
25. [Calling compliance: Do not call](https://docs.hubtalk.ai/v4/tutorial/dnc.md)

### Section VII · After the call

The most useful part of the work begins once calls are already going out: reviewing a specific conversation and monitoring the health of the platform.

26. Call history: transcript, analytics, diagnostics
27. Operations: system health and roles

### Summary

Checklists, pitfalls, exam — keep this part at hand while working: it covers what to check before every publication and every launch.

## Where to start

> [card] [Start the course](https://docs.hubtalk.ai/v4/tutorial/dialog-model.md)
>
> Module 01: how the engine decides what the agent says next.

> [card] Checklists
>
> What to check before publishing an agent and launching a campaign.

***

The course is based on HubTalk AI · Conversation Flow. The screenshots show the interface in the Russian locale; the data and integrations in them are test ones. Questions about the course and access — to your organization's administrator.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.