> 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/behavior/playbooks.md).

# Playbooks

Playbooks define how your agent responds to specific concerns and which steps are carried out in the process. They are used when conversations should not only be answered, but handled in a targeted way, for example to capture information, check requests, or pass content on to your team.

This makes playbooks the basis for structured and automated conversation workflows.

### What are playbooks used for?

Playbooks are suitable for requests where a clear, structured process is necessary:

* Record callback requests with complete contact details
* Document support or service requests in a structured way
* Categorize and forward billing or contract questions
* Capture appointment requests when no calendar integration is connected

{% hint style="info" %}
**Calendar integration active?** Then do not create an additional playbook for scheduling appointments. Your agent recognizes appointment requests automatically and books them directly. An additional playbook can cause the request to be assigned incorrectly. More on this under Calendar.
{% endhint %}

A playbook consists of individual tasks. You define what the AI agent should do in the conversation:

* **Ask for information**, for example customer numbers, contact details, or problem descriptions
* **Pass on instructions**, for example instructions or information for callers
* **Map simple if-then workflows**, for example ask an additional question depending on an answer
* **Highlight important details in the summary**, so they are directly visible for follow-up processing

Tasks can be created as mandatory or optional. This allows the conversation flow to be tailored specifically to the respective request.

You can find more information under [**Summaries & Transcripts**.](https://help.sipgate.com/documentation/en/post-processing/summaries-and-transcripts.md)

### Playbooks from the library

{% hint style="warning" icon="user-headset" %}
The playbook library is only available in **sipgate sona** available. If you do not see a library in your agent overview, continue directly with the section **“Custom playbooks”** .
{% endhint %}

In the library, you will find **preconfigured playbooks from sipgate** for common use cases, for example recording incident reports or retrieving orders. The library is continuously expanded.

The playbooks are already preconfigured and **editable in parts**:

* **Add your own information:** Fill in the designated fields with your information.
* **Connect tools:** Connect the required tools.
* **Triggers and workflow:** These are fixed and cannot be changed.

You can find the library in the **sidebar of the agent overview**. Drag and drop the desired playbook onto your agent **Drag and drop onto your agent**.

**No suitable playbook included?** Then create your own.

### Custom playbooks

You create a custom playbook **from scratch** and configure it completely yourself. You define how your agent handles a conversation:

* **Ask for information:** For example customer numbers, problem descriptions, or contact options.
* **Confirm details:** The agent confirms the captured information.
* **Pass on results:** For example by email, webhook, or as a summary in the sipgate app.

Newly created playbooks are **initially deactivated**. Only after activation will your agent use them for suitable requests. Deactivated playbooks are ignored and do not need to be deleted.

How many playbooks you can create depends on your plan:

* **sipgate sona Free:** Up to three playbooks.
* **All other plans:** Unlimited playbooks.

### **Name and describe playbook**

**Title and description** help your agent select the right playbook. Make both specific and clearly distinguish the topics from one another. Test the selection with different requests and adjust the details if necessary.

### **Set conditions**

Define **keywords, phrases, or specific requests**that should trigger the playbook. Check regularly whether the conditions work and adjust them if necessary.

### **Use tasks**

With tasks, you define what your agent should do in the conversation:

* **Ask for information**, such as customer numbers or contact details.
* **Ask follow-up questions**, if certain information is available. To do this, use optional tasks.
* **Provide hints and instructions.**

Mark important tasks to highlight them in the **conversation summary** . More on this under [**Summaries & Transcripts**](https://help.sipgate.com/documentation/en/post-processing/summaries-and-transcripts.md).

### Reference MCP tools in tasks

You can reference MCP tools in the instructions of a task. Type `@` into the instruction field — a selection menu with the available tools will appear.

Select the desired tool. It appears under **Linked tools** in the task and is used by your agent in the conversation.

{% hint style="warning" icon="user-headset" %}
Referencing MCP tools in tasks is not available for **sipgate sona Free** .
{% endhint %}

<img src="https://1551117702-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXgAkjs11I2pdU4JZqXDl%2Fuploads%2Fgit-blob-7e9469a336f657328d16790b8878bd0c434b7a6d%2Funknown.png?alt=media" alt="" height="497" width="602">

### **Connections**

As soon as a playbook references an MCP tool, you can see under **Connections** in the playbook overview which tools are connected and whether the connection is active.

**Connection interrupted:** If an MCP server is no longer reachable, sipgate automatically deactivates all active playbooks that use tools from this server. Restore the MCP connection and then manually activate the playbook via **Activate**.

### **Define closing action**

Choose a **Forward to a phone number or a channel** or a **callback** as the closing action.

Channels do not need their own routed phone number. In the analytics dashboard, you can see which channel was forwarded to.

Obtain the **consent of callers** through a task and, if necessary, define alternatives, such as ending the conversation if no callback is desired.

### Interaction with knowledge and customer questions

**Playbooks control the workflow.** The [**knowledge base**](https://help.sipgate.com/documentation/en/behavior/wissensdatenbank.md) and the [**customer questions**](https://help.sipgate.com/documentation/en/behavior/kundenfragen.md) provide the information for your agent's answers.


---

# 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/behavior/playbooks.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.
