fydbek Založit účet

fydbek / Webhooky

Webhooky

Připomínky a změny z fydbeku do Make, Zapieru, n8n nebo vlastního systému

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álostKdy přijde
feedback.createdNová připomínka z widgetu, rozšíření nebo aplikace.
feedback.status_changedZměna stavu, v data je from a to. Potvrzení nebo vrácení reportérem má navíc review.
feedback.updatedZměna priority, typu, titulku, přiřazení nebo duplicity, v data.before jsou původní hodnoty.
feedback.deletedSmazání připomínky.
comment.createdNový komentář. Webhook je pro tým, chodí i interní komentáře s internal: true. Neposílejte je klientovi.
link.createdPř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

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.

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í

Podpora

hello@fydbek.com