Webhook pošle na vaši adresu požadavek POST s JSONem pokaždé, když se ve fydbeku něco stane: přijde nová připomínka, změní se stav, někdo napíše komentář. Hodí se pro Make, Zapier, n8n nebo vlastní systém. Pro Freelo, Asanu, ClickUp, Basecamp, Trello a GitHub má fydbek vestavěné integrace, webhook pro ně nepotřebujete.
Založení
Webhook přidá admin organizace v dashboardu v Nastavení organizace, záložka Webhooky. Zadáte adresu (jen https:// na veřejné doméně), projekt (nebo všechny) a události. Po uložení uvidíte jednou secret whsec_..., kterým ověříte podpis. Uložte si ho, znovu se neukáže. Organizace může mít nejvýš 10 webhooků.
V Make použijte modul Webhooks, Custom webhook, v Zapieru Webhooks by Zapier, Catch Hook, v n8n uzel Webhook. Adresu, kterou vám nástroj dá, vložte do fydbeku. Tlačítkem Vyzkoušet pošlete událost ping.
Události
| Událost | Kdy přijde |
|---|---|
feedback.created | Nová připomínka z widgetu, rozšíření nebo aplikace. |
feedback.status_changed | Změna stavu, v data je from a to. Potvrzení nebo vrácení reportérem má navíc review. |
feedback.updated | Změna priority, typu, titulku, přiřazení nebo duplicity, v data.before jsou původní hodnoty. |
feedback.deleted | Smazání připomínky. |
comment.created | Nový komentář. Webhook je pro tým, chodí i interní komentáře s internal: true. Neposílejte je klientovi. |
link.created | Připomínka se propojila s úkolem v jiném nástroji. |
Tělo požadavku
{
"id": "evt_01M5WRV7592BPPHY4JQ9F56XAR",
"type": "comment.created",
"created_at": "2026-10-26T18:51:26.249Z",
"project": { "id": "prj_01M5...", "name": "Eva Vzorová" },
"feedback": {
"id": "fb_01M5...",
"number": 12,
"title": "Nefunguje odeslání formuláře",
"status": "triaged",
"priority": "high",
"type": "bug",
"page_url": "https://eva-vzorova.cz/kontakt",
"url": "https://app.fydbek.com/codebros?item=fb_01M5..."
},
"actor": { "type": "user", "id": "usr_01M5...", "name": "Eva Vzorová", "via": null },
"comment": { "id": "cmt_01M5...", "body": "Pořád to hází chybu.", "internal": false, "author": "Eva Vzorová" },
"data": { "commentId": "cmt_01M5...", "internal": false }
}
feedback.url vede do detailu v dashboardu. U událostí bez komentáře comment chybí. Data jsou aktuální v době odeslání, ne v době události.
Hlavičky
Fydbek-Event: typ události.Fydbek-Delivery: ID události, stejné při opakovaném doručení. Podle něj poznáte duplicitu.Fydbek-Signature:t=1793040686,v1=b7cb..., kdetje čas odeslání v sekundách av1HMAC-SHA256 zt.tělose secretem webhooku, v hex.User-Agent:fydbek-webhooks/1.
Ověření podpisu
Podpis počítejte z těla tak, jak přišlo, ne z JSONu načteného a znovu vypsaného. Odmítněte požadavky starší než 5 minut.
Node.js
import { createHmac, timingSafeEqual } from 'node:crypto';
// rawBody: tělo požadavku přesně tak, jak přišlo (string), header: Fydbek-Signature
export function verifyFydbek(rawBody, header, secret) {
const parts = Object.fromEntries(header.split(',').map((p) => p.split('=')));
if (Math.abs(Date.now() / 1000 - Number(parts.t)) > 300) return false;
const expected = createHmac('sha256', secret).update(`${parts.t}.${rawBody}`).digest('hex');
const actual = String(parts.v1 ?? '');
return actual.length === expected.length && timingSafeEqual(Buffer.from(expected), Buffer.from(actual));
}
PHP
<?php
// $body = file_get_contents('php://input');
// $header = $_SERVER['HTTP_FYDBEK_SIGNATURE'] ?? '';
function fydbek_verify(string $body, string $header, string $secret): bool {
parse_str(str_replace(',', '&', $header), $parts);
if (abs(time() - (int) ($parts['t'] ?? 0)) > 300) return false;
$expected = hash_hmac('sha256', ($parts['t'] ?? '') . '.' . $body, $secret);
return hash_equals($expected, (string) ($parts['v1'] ?? ''));
}
Přihlášení přes API
Nástroje jako Make nebo Zapier si webhook umí založit samy, když scénář zapnete, a smazat, když ho vypnete. Slouží k tomu API s tokenem organizace, který založí admin v Nastavení organizace, záložka AI agenti a API. Token musí mít právo číst připomínky a patřit adminovi nebo agentovi.
GET /v1/tokenvrátí organizaci tokenu (orgId,orgName), hodí se k ověření připojení.POST /v1/hookss tělem{"targetUrl", "event", "projectId"}přihlásí webhook pro jednu událost a vrátí{"id"}. BezprojectIdchodí události ze všech projektů.DELETE /v1/hooks/:idwebhook odhlásí. Smí jen token, který ho přihlásil.GET /v1/hooks/sample?event=...vrátí poslední tři události v tvaru webhooku jako ukázková data.
Takto přihlášené webhooky uvidí admin v seznamu webhooků se zdrojem (Make, Zapier, API) a do limitu 10 se nepočítají. Když token zrušíte, jeho webhooky zmizí s ním.
Doručení a opakování
- Doručeno je, když adresa do 10 sekund odpoví stavem 2xx. Přesměrování fydbek nesleduje.
- Neúspěch zkusí znovu po 30 sekundách, 2 minutách, 10 minutách a pak každou hodinu, celkem 9 pokusů.
- Pořadí událostí není zaručené a stejná událost může přijít dvakrát. Rozhodujte podle
idacreated_at. - Když se 20 událostí za sebou nepodaří doručit ani po všech pokusech, fydbek webhook vypne a pošle e-mail tomu, kdo ho založil. Zapnete ho znovu v nastavení.