Webhooks

Twenty trimite o solicitare HTTP POST către URL-ul tău ori de câte ori o înregistrare este creată, actualizată sau ștearsă. Toate tipurile de obiecte sunt acoperite, inclusiv obiectele personalizate.

Creați un webhook

Mergeți la Setări → API-uri și Webhooks → Webhooks
Faceți clic pe + Creează webhook
Introduceți URL-ul webhook-ului dvs. (trebuie să fie accesibil public)
Faceți clic pe Salvează

Webhook-ul se activează imediat și începe să trimită notificări.

Gestionați webhook-urile

Editează: Faceți clic pe webhook → Actualizați URL-ul → Salvează Șterge: Faceți clic pe webhook → Șterge → Confirmă

Evenimente

Twenty trimite webhook-uri pentru aceste tipuri de evenimente:

Eveniment	Exemplu
Înregistrare creată	`person.created`, `company.created`, `note.created`
Înregistrare actualizată	`person.updated`, `company.updated`, `opportunity.updated`
Înregistrare ștearsă	`person.deleted`, `company.deleted`

Toate tipurile de evenimente sunt trimise către URL-ul webhook-ului dvs. Filtrarea evenimentelor poate fi adăugată în versiunile viitoare.

Formatul payload-ului

Fiecare webhook trimite un HTTP POST cu un corp JSON:

{
  "event": "person.created",
  "data": {
    "id": "abc12345",
    "firstName": "Alice",
    "lastName": "Doe",
    "email": "alice@example.com",
    "createdAt": "2025-02-10T15:30:45Z",
    "createdBy": "user_123"
  },
  "timestamp": "2025-02-10T15:30:50Z"
}

Câmp	Descriere
`event`	Ce s-a întâmplat (de ex., `person.created`)
`data`	Înregistrarea completă care a fost creată/actualizată/ștearsă
`timestamp`	Când a avut loc evenimentul (UTC)

Răspundeți cu un status HTTP 2xx (200-299) pentru a confirma primirea. Răspunsurile non-2xx sunt înregistrate ca eșecuri de livrare.

Validarea Webhook-ului

Twenty semnează fiecare cerere webhook din motive de securitate. Validați semnăturile pentru a vă asigura că cererile sunt autentice.

Anteturi

Antet	Descriere
`X-Twenty-Webhook-Signature`	Semnătură HMAC SHA256
`X-Twenty-Webhook-Timestamp`	Marcaj temporal al cererii

Pași de validare

Obțineți marcajul temporal din X-Twenty-Webhook-Timestamp
Creați șirul: {timestamp}:{JSON payload}
Calculați HMAC SHA256 folosind secretul webhook-ului dvs.
Comparați cu X-Twenty-Webhook-Signature

Exemplu (Node.js)

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")
);

Webhook-uri vs Fluxuri de lucru

Metodă	Direcție	Caz de utilizare
Webhook-uri	OUT	Notificați automat sistemele externe despre orice modificare a unei înregistrări
Flux de lucru + Cerere HTTP	OUT	Trimiteți date în exterior cu logică personalizată (filtre, transformări)
Declanșator webhook în fluxul de lucru	IN	Primiți date în Twenty din sisteme externe

Pentru a primi date externe, consultați Configurați un declanșator Webhook.

Prezentare generală

Aplicații

API

Autogazda

Contribuie

Creați un webhook

Gestionați webhook-urile

Evenimente

Formatul payload-ului

Validarea Webhook-ului

Anteturi

Pași de validare

Exemplu (Node.js)

Webhook-uri vs Fluxuri de lucru

​Creați un webhook

​Gestionați webhook-urile

​Evenimente

​Formatul payload-ului

​Validarea Webhook-ului

​Anteturi

​Pași de validare

​Exemplu (Node.js)

​Webhook-uri vs Fluxuri de lucru

Creați un webhook

Gestionați webhook-urile

Evenimente

Formatul payload-ului

Validarea Webhook-ului

Anteturi

Pași de validare

Exemplu (Node.js)

Webhook-uri vs Fluxuri de lucru