> For the complete documentation index, see [llms.txt](https://docs.mluvii.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mluvii.com/pro-it-specialisty/public-api/faq-pro-webhooky.md).

# FAQ pro Webhooky

Tato sekce je určena pro konzumenty mluvii Public API a má poskytnout detail k použití a manipulaci s webhooky, a tím přispět ke snadnější implementaci integrací se systémy 3. stran.

## Po jak dlouhé době dochází ke smazání webhooku?

Nefunkční webhook je smazán po 3 dnech, během kterých se nedaří doručit zprávu na definované URL.

## Co když se nepodaří webhook poslat na URL?

V takovém případě se vyvolá (až 2x) retry. Když ani to nestačí, zpráva se zahodí.

## Platí pravidlo "one event at a time"?

Ano, 1 webhook = 1 request 

## Jak poznáte, že data chodí skutečně z mluvii?

Do URL je možné přidat username:password \[[dle rfc-3986 (3.2.1. User Information)](https://www.rfc-editor.org/rfc/rfc3986)] ,které transformujete do Authorize hlavičky, takže je možné provést basic authentication. 

## Jsou ošetřeny případy duplicitních eventů (např. 2x zrušení objednávky)?

TCP protokol potvrzuje doručení a HTTP protokol definuje potvrzovací odpověď klientského serveru. V případě výpadku (klient zpracuje payload od mluvii před tím, než k nám pošle http odpověď) posílá mluvii stejný payload znovu. Zpracování payloadu klientem by mělo být idempotentní operace.

## Odchází informace o jednotlivých eventech ve správném pořadí?

Ano, události pro daný typ entity (sezení, e-mail, user) odcházejí v pořadí, v jakém nastanou.

## Je vyžadováno použití HTTPS protokolu pro webhook endpointy?

Je to doporučeno, ačkoli to v dnešní době nevynucujeme.


---

# 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 dynamically by asking a question.

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

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.