Ana içeriğe geç

PDF Generator

PDF Generator, bir HTML şablonu artı verilerden bir PDF oluşturur ve tamamlanmış dosyaya bir bağlantı döndürür. Akışınızın ardından gönderebileceği faturalar, makbuzlar, raporlar veya onaylar üretmek için kullanın — örneğin bir WhatsApp veya e-posta mesajına ekleyin.

Bunu bir Agent node içinde (ajan uygun olduğunda bir PDF üretir) ya da sabit, belirlenimci bir doküman için bağımsız bir Araç node olarak kullanın.

Bir akışa ekleme​

Araç node'unun araç seçicisinde PDF Generator'ı seçin, bir kaynak seçin (kayıtlı bir şablon veya kendi HTML'iniz) ve onu dolduracak veriyi sağlayın.

Kurulum / kimlik bilgileri​

PDF Generator çoğu durumda bir credential olmadan çalışır. İsteğe bağlı olarak, oluşturma çağrısını güvence altına almak için bir Chat Akışı API credential bağlayabilirsiniz — bir tane bağlandığında PDF hizmeti bunu gerektirir. Kurulumunuz gerektiriyorsa Bağlantı Bilgisi Seç ile ekleyin.

Girdiler​

ParametreAçıklamaZorunlu
SourceKayıtlı bir Şablon ID veya kendi HTML'inizi oluştur.Evet
ŞablonOluşturulacak kayıtlı sunucu şablonu (Source, Şablon ID olduğunda).Şablon kullanılırken
HTMLData'dan doldurulan {{variables}} kullanarak yazdığınız Handlebars HTML/CSS (Source, HTML olduğunda).HTML kullanılırken
DataŞablona birleştirilen değerleri sağlama şekliniz: Form (anahtar → değer satırları) veya JSON.Evet
FieldsVeri nesnesini oluşturan anahtar → değer satırları (Form modu).Data Form olduğunda
JSONVerinin bir JSON nesnesi (JSON modu) — iç içe veya karmaşık veri için en iyisi.Data JSON olduğunda
Veri sağlamanın iki yolu

Form modu basit bir anahtar → değer tablosudur — birkaç alan için harikadır ve her değer bir değişken çekebilir. JSON modu düz bir JSON nesnesidir — şablonunuz iç içe veya liste verisine ihtiyaç duyduğunda kullanın.

Çıktılar​

Araç, oluşturulan PDF'e imzalı bir URL döndürür (veya iş kuyruğa alınmışsa bir oluşturma id'si). Tek çıktılı bir araçtır. Sonraki bir node'un dokümanı gönderebilmesi veya bağlayabilmesi için URL'yi flow state'e kaydedin.

Örnek​

Bir sipariş makbuzunu PDF olarak gönderme

  1. PDF Generator içeren bir Araç node ekleyin.
  2. Source'u HTML olarak ayarlayın ve {{customerName}}, {{orderNumber}} ve {{total}} kullanarak küçük bir makbuz şablonu yazın.
  3. Data (Form modu) içinde bu anahtarları toplanan sipariş değerlerine eşleyin.
  4. Dönen URL'yi, makbuzu iletmek için bir WhatsApp doküman mesajına besleyin.
Kayıtlı şablonlar daha fazlasını yapabilir

Bazı kayıtlı şablonlar sunucu taraflıdır: kendi verilerini tutar ve dokümanı kendileri düzenler, bu yüzden akışınız tüm gövde yerine kısa bir tanım gönderir. inspection şablonu böyle çalışır — bkz. Denetim Raporları.

İpuçları​

  • Handlebars ile yazın. HTML'iniz, sağladığınız Data'dan doldurulan {{placeholders}} kullanır.
  • Listeler için JSON modunu kullanın. Şablon öğeler üzerinde döngü kuruyorsa (fatura satır kalemleri gibi), veriyi JSON olarak sağlayın.
  • Dönen URL'yi saklayın. Gönderim adımının (e-posta/WhatsApp) referans verebilmesi için onu flow state'te tutun.
  • Chat Akışı API credential'ını yalnızca PDF hizmetiniz isteğin kimliğinin doğrulanmasını gerektiriyorsa bağlayın.

İlgili​