🔗 Webhooky

📍 Kde webhooky nastavit

Otevřete Nastavení (ikona ozubeného kolečka v menu) a přejděte na záložku Webhooky. Zde vytváříte, upravujete a spravujete své webhooky.

✨ Jak vytvořit webhook

📬 Na jaké události můžete reagovat

U každého webhooku vyberete, na které události má Diktator reagovat:

📋 Co zpráva obsahuje

Každá zpráva obsahuje typ události, čas a data – například název diktátu, obsah, stav, úkoly, štítky, autora. Data jsou ve formátu JSON, který dokáže zpracovat většina systémů. Pro nastavení zpracování na straně vašeho systému kontaktujte svého IT administrátora.

🔒 Zabezpečení

Každý webhook má tajný klíč (secret). Slouží k ověření, že zpráva skutečně přišla z Diktatoru – váš systém ho použije při kontrole. Nikdy klíč nesdílejte a ukládejte ho bezpečně. Pomocí tlačítka Regenerovat můžete vygenerovat nový klíč (např. pokud byl odhalen).

🔄 Správa webhooků

• • Zapnout/vypnout – dočasně deaktivujte webhook bez mazání
• • Testovat – odešlete zkušební zprávu a ověřte, že vše funguje
• • Historie – prohlédněte si, které zprávy byly odeslány a zda byly doručeny
• • Smazat – trvalé odstranění webhooku

❓ Když něco nefunguje

👥 Uživatelské vs. týmové webhooky

Uživatelské webhooky reagují pouze na vaše diktáty. Týmové webhooky (v nastavení týmu) reagují na diktáty všech členů týmu – vhodné pro centrální integrace do firemního ERP.

⚙️ Pro administrátory – technické detaily

Níže najdete technické údaje pro nastavení přijímajícího systému: formát zpráv, které HTTP hlavičky kontrolovat a jak ověřit platnost.

Základní informace o requestu

• • Metoda: HTTP POST
• • Content-Type: application/json
• • User-Agent: Diktator-Webhook/1.0
• • Tělo: JSON objekt (UTF-8)

Struktura JSON payloadu

Každá zpráva má tento formát:

{
  "event": "dictate.created",
  "timestamp": "2026-02-09T10:30:00Z",
  "content": "Diktator – dictate.created",
  "data": {
    "dictate": { ... },
    "task": { ... }
  }
}

• • event – typ události (viz tabulka níže)
• • timestamp – čas v ISO 8601, UTC
• • content – text pro kompatibilitu (např. Discord)
• • data – obsahuje objekty dictate, task podle typu eventu
• • data.previous – u eventů updated obsahuje předchozí hodnoty
• • data.old_status / new_status – u dictate.status_changed

Technické názvy eventů

Datová pole v objektech

data.dictate obsahuje:

dictate_id, name, original_content, processed_content, status, created_at, updated_at, author_first_name, author_last_name, author_email, gps, labels (name, color, description), tasks (content, status, priority, due_date, created_at, updated_at)

data.task obsahuje:

content, status, priority, due_date, created_at, updated_at

Co ověřit – HMAC podpis

Každý request obsahuje hlavičku X-Webhook-Signature ve formátu sha256=<hex>. Podpis = HMAC-SHA256(raw body, secret). Před zpracováním vždy ověřte podpis – jinak by mohl kdokoli posílat falešné zprávy na vaši adresu.

HTTP hlavičky (čekejte tyto)

Odpověď endpointu

Pro úspěch vracejte HTTP 2xx. Při 4xx, 5xx nebo timeoutu Diktator zprávu znovu pošle (až 3×, po 1, 5 a 15 minutách).

Doporučení pro implementaci

• • Idempotence – stejný event může dorazit vícekrát (retry). Používejte dictate_id nebo created_at pro detekci duplicit.
• • Rychlá odpověď – vraťte 2xx co nejdříve, zpracování proveďte asynchronně.
• • HTTPS – v produkci vždy HTTPS.

🔌 Příklad pro n8n

n8n je open-source nástroj pro automatizaci workflow. Můžete v něm snadno přijímat webhooky z Diktatoru a využít je pro další zpracování – např. odeslání e-mailu, zápis do tabulky nebo integraci s dalšími službami.

❓ Časté otázky