Configurați un declanșator webhook

​

Când să folosiți webhook-uri

​

Configurare pas cu pas

​

Pasul 1: Creați fluxul de lucru

1. Accesați Setări → Fluxuri de lucru
2. Faceți clic pe + Flux de lucru nou
3. Denumiți-l (de ex., “Trimitere formular site”)

​

Pasul 2: Configurați declanșatorul webhook

1. Faceți clic pe blocul declanșator
2. Selectați Webhook
3. Veți primi un URL de webhook unic, de exemplu:
   https://api.twenty.com/webhooks/workflow/abc123...
   
4. Copiați acest URL — veți avea nevoie de el pentru serviciul dvs. extern

​

Pasul 3: Definiți structura de date așteptată

1. Faceți clic pe Define expected body
2. Introduceți un exemplu JSON care corespunde cu ceea ce va trimite serviciul dvs.:

{
  "firstName": "John",
  "lastName": "Doe",
  "email": "john@example.com",
  "company": "Acme Inc",
  "message": "Interested in your product"
}

3. Faceți clic pe Salvați — aceasta creează variabile pe care le puteți utiliza în pașii următori

​

Pasul 4: Adăugați acțiuni

1. Adăugați acțiunea Create Record
2. Selectați obiectul People
3. Asociați câmpurile:

​

Pasul 5: Testați webhook-ul

curl -X POST https://api.twenty.com/webhooks/workflow/abc123... \
  -H "Content-Type: application/json" \
  -d '{"firstName":"Test","lastName":"User","email":"test@example.com"}'

1. Creați o cerere POST către URL-ul webhook-ului
2. Setați antetul Content-Type la application/json
3. Adăugați corpul JSON de test
4. Trimiteți și verificați rulările fluxului de lucru

​

Pasul 6: Activați

​

Gestionarea diferitelor structuri de date

​

Date îmbricate

{
  "contact": {
    "name": "John Doe",
    "email": "john@example.com"
  },
  "source": "website"
}

​

Tablouri

{
  "items": [
    {"name": "Product A", "qty": 2},
    {"name": "Product B", "qty": 1}
  ]
}

export const main = async (params: { items: any }) => {
  const items = typeof params.items === "string"
    ? JSON.parse(params.items)
    : params.items;
  return { items };
};

export const main = async (params: { items: any }) => {
  const items = typeof params.items === "string"
    ? JSON.parse(params.items)
    : params.items;

  return {
    product: {
      name: items[0]?.name || "",
      qty: items[0]?.qty || 0
    }
  };
};

​

Conexe

• Declanșatoare ale fluxurilor de lucru
• Acțiuni ale fluxurilor de lucru