Bir Webhook Tetikleyicisi Ayarlayın

​

Webhook’lar Ne Zaman Kullanılır

​

Adım adım kurulum

​

Adım 1: İş akışını oluşturun

1. Ayarlar → İş Akışları bölümüne gidin
2. + Yeni İş Akışı’na tıklayın
3. Adlandırın (ör. “Website Form Submission”)

​

Adım 2: Webhook tetikleyicisini yapılandırın

1. Tetikleyici bloğuna tıklayın
2. Webhook’u seçin
3. Şuna benzer benzersiz bir webhook URL’si alacaksınız:
   https://api.twenty.com/webhooks/workflow/abc123...
   
4. Bu URL’yi kopyalayın—harici hizmetiniz için buna ihtiyacınız olacak

​

Adım 3: Beklenen veri yapısını tanımlayın

1. Beklenen gövdeyi tanımla’ya tıklayın
2. Hizmetinizin göndereceğiyle eşleşen örnek bir JSON girin:

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

3. Kaydet’e tıklayın—bu, sonraki adımlarda kullanabileceğiniz değişkenler oluşturur

​

Adım 4: Eylemler ekleyin

1. Kayıt Oluştur eylemini ekleyin
2. Kişiler nesnesini seçin
3. Alanları eşleyin:

​

Adım 5: Webhook’u test edin

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. Webhook URL’nize bir POST isteği oluşturun
2. Content-Type üst bilgisini application/json olarak ayarlayın
3. Test JSON gövdenizi ekleyin
4. Gönderin ve iş akışı çalıştırmalarını kontrol edin

​

Adım 6: Etkinleştir

​

Farklı veri yapılarıyla çalışma

​

İç içe veri

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

​

Diziler

{
  "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
    }
  };
};

​

İlgili

• İş Akışı Tetikleyicileri
• İş Akışı Eylemleri