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

# Quickstart in 10 minutes

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

You will also find prepared [**Use Cases**](https://help.sipgate.com/use-cases/first-level-support)that show how all the components of your agents work together in typical situations and make it easier to classify them.

{% 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.de/ai-agents/en/getting-started/verifizierung-des-accounts.md) is required.
{% endhint %}

### Set up agent with sipgate sona

{% stepper %}
{% step %}

#### **Store website**

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

<figure><img src="https://3225157888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL8XuEunVQH0eqk0OHmIg%2Fuploads%2Fgit-blob-a43795a889801a681eff3f4bc4a823bfb58581a3%2Feinrichtugn1.gif?alt=media" alt=""><figcaption></figcaption></figure>

\
**💡 Tip:** Setting up via the website is faster. In the background, initial customer questions are also created, which you can adjust later.
{% endstep %}

{% step %}

#### **Review company profile**

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

Without a website, describe your company yourself, the way 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 conducts conversations and adjust the greeting text. The greeting text is prefilled with your company name.

<figure><img src="https://3225157888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL8XuEunVQH0eqk0OHmIg%2Fuploads%2Fgit-blob-c0515331d79f17736db9b8ff05490f043ccb1969%2Fcharacter.gif?alt=media" 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 tells your agent which steps to go through for a specific request, 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 phone number and test your agent in a conversation. Your account does not need to be verified for this.
{% endstep %}

{% step %}

#### **After setup**

#### **Assign phone number**

To get started, you will receive a phone number for 7 days so your agent is immediately reachable. After that, you can port your existing number to sipgate or book a free phone number.

**Note:** The free phone number is not automatically available 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 already exist. Review them and add any missing topics. Store more extensive content such as product information in the knowledge base.
{% endstep %}

{% step %}

#### **Integrate into routing**

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

#### Where to find what

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

| Tab       | What you set 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 call, and what happens afterward. Click an element to edit it.

<figure><img src="https://3225157888-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FL8XuEunVQH0eqk0OHmIg%2Fuploads%2Fgit-blob-f707b69a812c53c3f65fc28fd0f902017a57c2fc%2Fu%CC%88bersicht.gif?alt=media" alt=""><figcaption></figcaption></figure>

On the right is the library with elements that 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, no card will appear for it either. That is why you always add the first element of a type via the library.
{% endhint %}

### Important building blocks of sipgate sona

<details>

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

You determine how your agent sounds and in which language conversations are held. 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 inquiries, 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 wording.

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

</details>

<details>

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

Playbooks define workflows for specific types of calls. They control which steps your agent goes through in which order and how it responds to certain keywords. If a conversation should end automatically 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 time periods it is active.

**Note:** All settings can be adjusted at any time. It is not necessary to define every detail during the initial setup. Many adjustments arise during day-to-day use.

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

</details>

### Set up 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** . Click **Next**. Later, you can access all settings important for getting started via the configuration page.
{% endstep %}

{% step %}

#### **Store 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, the digital service must be mentioned. The text is read out verbatim and does not automatically adapt to later language changes.
{% endhint %}

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

{% step %}

#### **Assign phone number**

After the agent is created, a dialog for\
assigning a phone number opens automatically. Select the number through 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.de/ai-agents/en/getting-started/verifizierung-des-accounts.md)
{% endhint %}
{% endstep %}

{% step %}

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

In the basic settings, you define the name and label of the AI agent. In this area, you also select 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.de/ai-agents/en/behavior/kundenfragen.md)

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

{% step %}

#### [**Set playbooks**](https://help.sipgate.de/ai-agents/en/behavior/playbooks.md)

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

{% step %}

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

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

### Important building blocks of the AI Agents

<details>

<summary><a href="https://help.sipgate.de/ai-agents/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 held. 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 inquiries, store the relevant information either as customer questions or in the knowledge base.

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

[**The knowledge base**](https://help.sipgate.de/ai-agents/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 wording.

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

</details>

<details>

<summary><a href="https://help.sipgate.de/ai-agents/en/behavior/playbooks.md"><strong>Playbooks</strong></a></summary>

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.de/ai-agents/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 time 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 every detail during the initial setup. Many adjustments arise during day-to-day use.
{% endhint %}

The agent is now ready for use. Further adjustments, evaluations, 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.de/ai-agents/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.
