> For the complete documentation index, see [llms.txt](https://help.sipgate.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.sipgate.com/documentation/en/getting-started/quickstart-in-10-minuten.md).

# Quickstart in 10 minutes

sipgate sona automatically answers calls, recognizes customer concerns, and responds to them. **Your agent answers common questions, forwards calls to the right contacts, or records important information.** This guide shows you how to set up an agent.

In addition, you will find prepared [**Use Cases**](https://help.sipgate.com/documentation/en/use-cases/first-level-support.md), which show how all the components of your agents work together in typical situations and make classification easier.

{% hint style="info" %}
**Note:** You can set up and test your agent before your account is verified. For operation with your own phone number, [location verification](https://help.sipgate.com/documentation/en/getting-started/verifizierung-des-accounts.md) is required.
{% endhint %}

### Set up an agent with sipgate sona

{% stepper %}
{% step %}

#### **Add website**

After logging in, open the AI Agents area and create a new agent. Enter your website address. sipgate sona reads the page and pre-fills the company name, industry, and description.

<figure><img src="https://1551117702-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXgAkjs11I2pdU4JZqXDl%2Fuploads%2FkHHc15pA0gy5HIIO41Zj%2Feinrichtugn1.gif?alt=media&amp;token=ebbb6a13-b81c-4771-a014-a47b4a138c71" alt=""><figcaption></figcaption></figure>

\
**💡 Tip:** Using the website makes setup faster. In the background, initial customer questions are also created, which you can adjust later.
{% endstep %}

{% step %}

#### **Review company profile**

Check the pre-filled details and adjust them. The suggestions are marked as AI-generated.

Without a website, describe your company yourself, just as you would explain it to a customer on the phone: What do you offer, for whom, and what makes you special? Your agent uses this text to inform callers.
{% endstep %}

{% step %}

#### **Set character**

Choose a character set. It defines voice, form of address, and tone together. Alternatively, configure the three points individually.

Here you also choose the language in which your agent will conduct conversations and adjust the greeting text. The greeting text is prefilled with your company name.

<figure><img src="https://1551117702-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXgAkjs11I2pdU4JZqXDl%2Fuploads%2F06qtNrkg50QDfds0SiuL%2Fcharacter.gif?alt=media&amp;token=f4888cc8-8da0-4679-9e02-562336d2a1c9" alt=""><figcaption></figcaption></figure>

**Note:** For legal reasons, the greeting text must refer to the digital service. The text is read out verbatim and will not automatically adapt if the language is changed later.
{% endstep %}

{% step %}

#### **Select playbook**

Select a playbook template. This lets your agent know which steps to go through for a specific issue, for example when taking a callback request. You can add more playbooks later or create your own.
{% endstep %}

{% step %}

#### **Enable summaries**

Optionally enable call summaries. After each call, you will then receive an email with the phone number, time, duration, and content of the conversation.
{% endstep %}

{% step %}

#### **Test agent**

Call the displayed number and test your agent in conversation. Your account does not need to be verified yet for this.
{% endstep %}

{% step %}

#### **After setup**

#### **Assign phone number**

To start, you will receive a number for 7 days, which your agent can be reached on immediately. After that, port your existing number to sipgate or book a free number.

**Note:** The free phone number is not automatically in your account. You book it actively under Phone Numbers. You can add more phone numbers at any time.
{% endstep %}

{% step %}

#### **Add customer questions and knowledge**

If you created your agent via the website, initial customer questions are already available. Review them and add missing topics. More extensive content, such as product information, belongs in the knowledge base.
{% endstep %}

{% step %}

#### **Integrate into routing**

Integrate your agent into your routing. From this point on, it will handle incoming calls according to the defined rules.
{% endstep %}
{% endstepper %}

#### Where to find what

Open sipgate sona and select your agent. The settings are located in tabs:

| Tab       | What you configure there                                    |
| --------- | ----------------------------------------------------------- |
| Overview  | The structure of your agent as a workflow, plus the library |
| Character | Voice, language, form of address, greeting                  |
| Knowledge | Customer questions and knowledge base                       |
| Tools     | Connection to external systems                              |
| Calendar  | Cal.com integration                                         |
| Outbound  | Outgoing calls                                              |

Under **Overview** you can see the workflow from top to bottom: the phone number, your agent, what happens during the conversation, and what happens afterward. Click an element to edit it.

<figure><img src="https://1551117702-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXgAkjs11I2pdU4JZqXDl%2Fuploads%2FCNNFhFqNSZ3MC1zQ7uyB%2Fu%CC%88bersicht.gif?alt=media&amp;token=32695efe-d227-4a22-9b6c-fa200a5d0a2f" alt=""><figcaption></figcaption></figure>

On the right is the library with elements you can add via drag and drop, for example additional playbooks or data retrieval.

{% hint style="info" %}
**Note:** The overview only shows elements that have already been set up. As long as you have not created data retrieval, for example, there will be no card for it either. That is why you always add the first element of a type via the library.
{% endhint %}

### Key building blocks of sipgate sona

<details>

<summary><strong>Character</strong></summary>

You determine how your agent sounds and in which language conversations are conducted. The settings apply to all calls and can be adjusted at any time.

</details>

<details>

<summary><strong>Knowledge</strong></summary>

So that your agent can answer requests, store the relevant information as customer questions or in the knowledge base.

Customer questions are suitable for individual, clearly defined questions with fixed answers, for example about opening hours or address. The knowledge base is suitable for more extensive content such as FAQs, product information, or process descriptions. It helps your agent respond more flexibly to different phrasings.

**Note:** Do not maintain the same content twice in customer questions and the knowledge base. Duplicate or conflicting information can reduce answer quality.

</details>

<details>

<summary><strong>Playbooks</strong></summary>

Playbooks define processes for specific types of calls. They control which steps your agent goes through and in what order, and how it responds to certain keywords. If a conversation should automatically end after all steps are completed, store that in the playbook.

</details>

<details>

<summary><strong>Routing and forwarding</strong></summary>

Routing determines when and how calls are forwarded to your agent and during which periods it is active.

**Note:** All settings can be adjusted at any time. It is not necessary to define all details during the initial setup. Many adjustments arise during live operation.

Your agent is now ready for use. You can make further adjustments, analyses, and optimizations at any time.

</details>

### Set up an agent with AI Agents

{% stepper %}
{% step %}

#### **Create first agent**

After logging in, you will find the **AI Agents area in the product menu**. There you can add a new agent or select an existing one for editing. Choose the **language**in which your agent should conduct phone calls. Enter the **name of your company** and your **industry** and click **Next**. Later, you can access all settings that are important for getting started via the configuration page.
{% endstep %}

{% step %}

#### **Add company profile**

Describe your company and your services as if you were explaining them to a customer on the phone: What do you offer, for whom, and what makes you special?

Your agent uses this text to inform callers competently.

{% hint style="info" %}
**Note:** The description must be at least 20 characters long.
{% endhint %}

Click **Next**.
{% endstep %}

{% step %}

#### **Set greeting text**

The greeting text is automatically prefilled with your company name.\
Adjust it if necessary.

{% hint style="info" %}
**Note:** For legal reasons, reference to the digital service is required. The text is read out verbatim and does not automatically adjust if the language is changed later.
{% endhint %}

Click **Continue.** Your agent is now being created.
{% endstep %}

{% step %}

#### **Assign phone number**

After the agent has been created, a dialog for assigning a phone number opens automatically.\
Choose the phone number on which your agent should be reachable and confirm.

{% hint style="info" %}
If no suitable phone number is available, first book a sipgate package with phone numbers, for example a SIP trunk. Your account must be fully set up and verified for this. You can learn more in the article [**account verification.**](https://help.sipgate.com/documentation/en/getting-started/verifizierung-des-accounts.md)
{% endhint %}
{% endstep %}

{% step %}

#### [**Set basic settings**](https://help.sipgate.com/documentation/en/behavior/stimme-and-sprache.md)

In the basic settings, define the name and label of the AI agent. In this area, you also choose the voice of the phone assistant. The selection applies to all conversations and can be adjusted at any time.
{% endstep %}

{% step %}

#### [**Define common customer questions**](https://help.sipgate.com/documentation/en/behavior/kundenfragen.md)

Under customer questions, you can store typical questions and the associated answers that the AI agent should answer automatically. The questions should be clearly formulated and, if possible, not too similar. Clear separation improves recognition and the response quality of the phone assistant.
{% endstep %}

{% step %}

#### [**Set playbooks**](https://help.sipgate.com/documentation/en/behavior/playbooks.md)

Under playbooks, you define the workflows for specific types of calls. Here you specify which steps the AI agent goes through in a conversation and how it responds to certain keywords. If a conversation should automatically end after all steps are completed, this must be explicitly stored in the playbook.
{% endstep %}

{% step %}

#### [**Integrate agent into routing**](https://help.sipgate.com/documentation/en/behavior/routing-und-weiterleitung.md)

After configuration, integrate the AI agent into routing. From this point on, it will handle incoming calls according to the defined rules.
{% endstep %}
{% endstepper %}

### Important building blocks of AI Agents

<details>

<summary><a href="https://help.sipgate.com/documentation/en/behavior/stimme-and-sprache.md"><strong>Voice and language</strong></a></summary>

You can determine how the agent sounds and in which language conversations are conducted. These apply to all calls and can be adjusted at any time.

</details>

<details>

<summary><strong>Store customer questions or knowledge base</strong></summary>

So that your AI agent can answer requests, store the relevant information either as customer questions or in the knowledge base.

[**Customer questions**](https://help.sipgate.com/documentation/en/behavior/kundenfragen.md) are suitable for individual, clearly defined questions with fixed answers, for example about opening hours, address, or appointment scheduling.

[**The knowledge base**](https://help.sipgate.com/documentation/en/behavior/wissensdatenbank.md) is suitable for more extensive content such as FAQs, product information, or process descriptions. It helps the AI agent respond more flexibly to different concerns and phrasings.

{% hint style="warning" %}
Do not maintain the same content twice in customer questions and the knowledge base. Duplicate or conflicting information can reduce answer quality.
{% endhint %}

</details>

<details>

<summary><a href="https://help.sipgate.com/documentation/en/behavior/playbooks.md"><strong>Playbooks</strong></a></summary>

The playbooks define workflows for specific types of calls. They control which steps the agent goes through in which order and how it responds to certain keywords.

</details>

<details>

<summary><a href="https://help.sipgate.com/documentation/en/behavior/routing-und-weiterleitung.md"><strong>Routing and forwarding</strong></a></summary>

Routing determines when and how calls are forwarded to the agent and during which periods it is active.

</details>

{% hint style="info" %}
All settings of an agent can be adjusted at any time. It is not necessary to define all details during the initial setup. Many adjustments arise during live operation.
{% endhint %}

The agent is now ready for use. Further adjustments, analyses, and optimizations can be made at any time.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.sipgate.com/documentation/en/getting-started/quickstart-in-10-minuten.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
