Ana içeriğe atla

Documentation Index

Fetch the complete documentation index at: https://docs.twenty.com/llms.txt

Use this file to discover all available pages before exploring further.

Webhook tetikleyicileri, harici hizmetlerin benzersiz bir URL’ye veri göndererek iş akışlarınızı başlatmasına olanak tanır. Formları, üçüncü taraf uygulamaları ve özel entegrasyonları bağlamak için bunları kullanın.

​
Webhook’lar Ne Zaman Kullanılır

Kullanım alanıÖrnek
Web formlarıİletişim formu gönderimleri potansiyel müşteri oluşturur
Üçüncü taraf uygulamalarStripe ödemesi → müşteri kaydı oluşturur
Özel entegrasyonlarUygulamanız → Twenty otomasyonu
Kod gerektirmeyen araçlarZapier, Make, n8n bağlantıları

​
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

POST istekleri için beklenen gövde 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"
}
  1. Kaydet’e tıklayın—bu, sonraki adımlarda kullanabileceğiniz değişkenler oluşturur

​
Adım 4: Eylemler ekleyin

Şimdi webhook verisini kullanan eylemler ekleyin: Örnek: Bir Kişi kaydı oluşturun
  1. Kayıt Oluştur eylemini ekleyin
  2. Kişiler nesnesini seçin
  3. Alanları eşleyin:
AlanDeğer
İsim{{trigger.body.firstName}}
Soyadı{{trigger.body.lastName}}
E-posta{{trigger.body.email}}
Şirket{{trigger.body.company}} temelinde ara veya oluşturun

​
Adım 5: Webhook’u test edin

Etkinleştirmeden önce, webhook’unuzu test edin: cURL kullanarak: 
curl -X POST https://api.twenty.com/webhooks/workflow/abc123... \
  -H "Content-Type: application/json" \
  -d '{"firstName":"Test","lastName":"User","email":"test@example.com"}'
Postman veya benzerini kullanarak:
  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

Test edildikten sonra, iş akışını yayına almak için Etkinleştir’e tıklayın.

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

​
İç içe veri

Webhook’unuz iç içe veri gönderiyorsa: 
{
  "contact": {
    "name": "John Doe",
    "email": "john@example.com"
  },
  "source": "website"
}
Şu şekilde referans verin: {{trigger.body.contact.email}}

​
Diziler

Veri diziler içeriyorsa: 
{
  "items": [
    {"name": "Product A", "qty": 2},
    {"name": "Product B", "qty": 1}
  ]
}
Dizileri nasıl ele alacağınız kullanım durumunuza bağlıdır: Bilinmeyen öğe sayısı → Iterator kullanın Dizideki her öğeyi işlemeniz gerekiyorsa (ör. her biri için bir kayıt oluşturmak), diziyi ayrıştırmak için bir Kod eylemi ekleyin, ardından Iterator kullanın: 
export const main = async (params: { items: any }) => {
  const items = typeof params.items === "string"
    ? JSON.parse(params.items)
    : params.items;
  return { items };
};
Ardından döngü için Iterator kullanın: {{code.items}} Bilinen/belirli alanlar → Adlandırılmış alanlara ayıklayın Dizi, ayrı ayrı erişmek istediğiniz belirli alanlar içeriyorsa (ör. konum 0 her zaman “first name”, konum 1 her zaman “last name” ise), bunları ayıklamak için bir Kod eylemi ekleyin: 
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
    }
  };
};
Artık sonraki adımlarda product.name ve product.qty öğelerini ayrı ayrı seçebilirsiniz.
Dizileri ele alma hakkında daha fazla ayrıntı için bkz. Kod Eylemlerinde Dizileri Ele Alma.

​
İlgili