Skip to content

The open alternative to Salesforce, designed for AI.

4.5 KB
Raw Blame
---
title: Webhooky
description: Dostávejte upozornění při změnách záznamů — HTTP POST na váš koncový bod při každém vytvoření, aktualizaci nebo smazání.
---

import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';

Twenty odešle HTTP POST na vaši adresu URL pokaždé, když je záznam vytvořen, aktualizován nebo smazán. Všechny typy objektů jsou podporovány, včetně vlastních objektů.

## Vytvořit Webhook

1. Přejděte na **Nastavení → API & Webhooks → Webhooks**
2. Klikněte na **+ Vytvořit webhook**
3. Zadejte adresu URL svého webhooku (musí být veřejně přístupná)
4. Klikněte na **Uložit**

Webhook se aktivuje okamžitě a začne odesílat oznámení.

<VimeoEmbed videoId="928786708" title="Vytvoření webhooku" />

### Spravovat Webhooky

**Upravit**: Klikněte na webhook → Aktualizovat adresu URL → **Uložit**

**Odstranit**: Klikněte na webhook → **Odstranit** → Potvrdit

## Události

Twenty odesílá webhooky pro tyto typy událostí:

| Událost                    | Příklad                                                    |
| -------------------------- | ---------------------------------------------------------- |
| **Záznam je vytvořen**     | `person.created`, `company.created`, `note.created`        |
| **Záznam je aktualizován** | `person.updated`, `company.updated`, `opportunity.updated` |
| **Záznam je odstraněn**    | `person.deleted`, `company.deleted`                        |

Všechny typy událostí jsou odesílány na adresu URL vašeho webhooku. Filtrování událostí může být přidáno v budoucích verzích.

## Formát payloadu

Každý webhook odesílá HTTP POST s tělem ve formátu JSON:

```json
{
  "event": "person.created",
  "data": {
    "id": "abc12345",
    "firstName": "Alice",
    "lastName": "Doe",
    "email": "[email protected]",
    "createdAt": "2025-02-10T15:30:45Z",
    "createdBy": "user_123"
  },
  "timestamp": "2025-02-10T15:30:50Z"
}
```

| Pole        | Popis                                                  |
| ----------- | ------------------------------------------------------ |
| `event`     | Co se stalo (např. `person.created`)                   |
| `data`      | Celý záznam, který byl vytvořen/aktualizován/odstraněn |
| `timestamp` | Kdy k události došlo (UTC)                             |

<Note>
Odpovězte se **stavem HTTP 2xx** (200–299) pro potvrzení přijetí. Odpovědi mimo 2xx se zaznamenávají jako selhání doručení.
</Note>

## Ověření Webhooku

Twenty kvůli bezpečnosti podepisuje každý požadavek webhooku. Ověřujte podpisy, abyste zajistili, že požadavky jsou autentické.

### Záhlaví

| Hlavička                     | Popis                    |
| ---------------------------- | ------------------------ |
| `X-Twenty-Webhook-Signature` | Podpis HMAC SHA256       |
| `X-Twenty-Webhook-Timestamp` | Časové razítko požadavku |

### Kroky ověření

1. Získejte časové razítko z `X-Twenty-Webhook-Timestamp`
2. Vytvořte řetězec: `{timestamp}:{JSON payload}`
3. Vypočítejte HMAC SHA256 pomocí vašeho tajného klíče webhooku
4. Porovnejte s `X-Twenty-Webhook-Signature`

### Příklad (Node.js)

```javascript
const crypto = require("crypto");

const timestamp = req.headers["x-twenty-webhook-timestamp"];
const payload = JSON.stringify(req.body);
const secret = "your-webhook-secret";

const stringToSign = `${timestamp}:${payload}`;
const expectedSignature = crypto
  .createHmac("sha256", secret)
  .update(stringToSign)
  .digest("hex");

const receivedSignature = req.headers["x-twenty-webhook-signature"];
const isValid = crypto.timingSafeEqual(
  Buffer.from(expectedSignature, "hex"),
  Buffer.from(receivedSignature, "hex")
);
```

## Webhooky vs. pracovní postupy

| Metoda                                    | Směr | Případ použití                                                  |
| ----------------------------------------- | ---- | --------------------------------------------------------------- |
| **Webhooky**                              | OUT  | Automaticky informujte externí systémy o jakékoli změně záznamu |
| **Pracovní postup + požadavek HTTP**      | OUT  | Odesílejte data ven s vlastní logikou (filtry, transformace)    |
| **Spouštěč webhooku v pracovním postupu** | IN   | Přijímejte data do Twenty z externích systémů                   |

Pro příjem externích dat viz [Nastavení spouštěče webhooku](/cs/user-guide/workflows/how-tos/connect-to-other-tools/set-up-a-webhook-trigger).