# PUBLIC API

{% hint style="warning" %}
*Tento návod předpokládá, že zákazník využívá cloudové řešení aplikace mluvii. V případě, že zákazník využívá **on premise** varianty, je nutné zaměnit hostovací url za url zákazníkova serveru.*
{% endhint %}

Jedná se o rozhraní, které umožňuje komunikaci mezi mluvii a vašimi interními aplikacemi. Data můžete přeposlat z mluvii do svých vlastních systémů pomocí Public API callů. Díky tomu uchováte data mimo platformu mluvii, vytvoříte vlastní reporting, integrujete systémy třetích stran a mnohem více. Můžete například automaticky připojit všechna sezení ke konkrétnímu zákazníkovi v CRM.

## **K čemu slouží?**

Public API umožňuje hned několik užitečných akcí. Využijete ho například ve chvíli, kdy chcete **převést informace o uživateli z aplikace do jiného systému**. Slouží také k **synchronizaci stavů uživatelů mezi mluvii a systémy třetích stran**. Podstatnou akcí je také **anonymizace údajů o klientech**. Data lze anonymizovat jak v případě všech informací o klientovi tak i u jednotlivých Sezení.

{% hint style="info" %}
*Pomocí Public API lze také **zobrazit kompletní údaje** o **sezení** nebo **uživatelích** aplikace (jméno, příjmení, e-mail, ID, username). Další možností je generování **pozvánek** s neomezenou platností a jejich pozdější zneplatnění. Administrátoři také jistě ocení možnost hromadně měnit vzhled a chování existujících balíčků (vizuál chatových tlačítek, skrývání tlačítek a změna formulářů).*
{% endhint %}

V neposlední řadě lze díky volání tzv. webhook metody předávat informace z mluvii do jiného systému v reálném čase:

* změna stavu operátora,
* zahájení sezení,
* přepojení sezení na jiného operátora,
* ukončení sezení.


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mluvii.com/pro-it-specialisty/public-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
