> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Flowella'da HubSpot İş Akışı Tetikleyicileri ve Eylemleri

> Flowella'nın HubSpot tetikleyicilerini ve eylemlerini ayarlayın — Form Completed, Text Reply, Send WhatsApp Template, Send WhatsApp Message ve AI agent devri.

Flowella, HubSpot'ın iş akışı motoruna doğrudan entegre olur ve size WhatsApp olaylarında tetiklenen özel tetikleyiciler ile mesaj gönderen veya konuşmaları bir AI agent'a devreden eylemler sağlar. Bu kılavuz her tetikleyiciyi, her eylemi ve bunları birleştirmenin en etkili kalıplarını kapsar.

## Başlamadan önce

Şunlara sahip olduğunuzdan emin olun:

* HubSpot portalınıza bağlı bir Flowella hesabı
* Flowella uygulamasında oluşturulmuş en az bir WhatsApp şablonu (mesaj göndermek için gereklidir)
* HubSpot'ın iş akışı aracına erişim. İletişim tabanlı iş akışları Professional veya Enterprise planı gerektirir

<Note>
  Flowella iş akışı eylemlerinde kullanılan tüm telefon numarası özellikleri uluslararası E.164 biçiminde saklanmalıdır; `+` ile başlayıp ardından ülke kodu ve ulusal numara gelir (örneğin, `+447700900123`). Ayrıntılar için bkz. [Telefon Numarası Biçimi](/hubspot/phone-number-format).
</Note>

***

## Tetikleyiciler

HubSpot'ta yeni bir iletişim tabanlı iş akışı oluşturduğunuzda, mevcut tüm tetikleyicileri görmek için tetikleyici seçim panelinde **Flowella** araması yapın. Bunlar, belirli bir WhatsApp olayı gerçekleştiğinde tetiklenir ve ilgili iletişimi otomatik olarak iş akışına kaydeder.

| Tetikleyici        | Yön   | Ne zaman tetiklenir                                                                     | Tipik kullanım                                                                         | Anahtar filtrelenebilir özellikler        |
| ------------------ | ----- | --------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ----------------------------------------- |
| **Form Completed** | Gelen | Bir iletişim, Flowella aracılığıyla gönderilen bir WhatsApp Flow formunu gönderir       | Bir geri bildirim, rezervasyon veya KYC akışından sonra yapılandırılmış yanıtları işle | Form Name, Source, hs\_email, Occurred at |
| **Text Reply**     | Gelen | Bir iletişim, Flowella tarafından yönetilen bir konuşmada serbest metin yanıtı gönderir | Anahtar kelimelere göre yönlendir, izin yakala, niyet tespit et                        | Message                                   |
| **Message Read**   | Giden | Bir iletişim, gönderdiğiniz bir WhatsApp mesajını açar                                  | Yalnızca mesaj görüldükten sonra takip et                                              | Phone                                     |
| **Message Sent**   | Giden | Flowella aracılığıyla bir iletişime WhatsApp mesajı gönderilir                          | Giden etkinliği kaydet, bir takip zamanlayıcısı başlat                                 | Phone                                     |

### Form Completed (gelen)

Bu tetikleyici, bir iletişim Flowella aracılığıyla gönderilen bir WhatsApp Flow formunu tamamladığında tetiklenir. En sık kullanılan tetikleyicidir ve çoğu Flowella otomasyonunun bel kemiğini oluşturur.

Bu tetikleyiciyi aşağıdaki olay özellikleriyle daraltabilirsiniz:

* **Form Name**: yalnızca o formun tamamlanmasının iş akışını tetiklemesi için belirli bir forma göre filtreleyin
* **hs\_email**: olay sırasındaki iletişimin e-posta adresi
* **Occurred at**: formun tamamlandığı tarih ve saat
* **Source**: form gönderiminin kaynağı

**Tipik kullanım:** bir müşteri bir geri bildirim formunu, bir rezervasyon onayını, bir KYC anketini veya başka bir yapılandırılmış veri toplama akışını tamamladıktan sonra bir takip iş akışını tetikleyin.

### Text Reply (gelen)

Bu tetikleyici, bir iletişim Flowella tarafından yönetilen bir WhatsApp konuşmasına serbest metin yanıtı gönderdiğinde tetiklenir.

Bu tetikleyiciyi özellikle güçlü kılan, **mesaj içeriğine göre filtreleme** yeteneğidir. Tetikleyici ölçütlerini yapılandırırken, belirli anahtar kelimeleri veya ifadeleri eşleştirmek için "şunlardan birini içerir" gibi operatörler kullanarak **Message** özelliğine bir koşul ekleyin. Bu, bir iletişimin söylediklerine bağlı olarak farklı yanıt veren iş akışları oluşturmanıza olanak tanır.

**Tipik kullanım:** anahtar kelime yanıtlarına dayalı olarak iletişimleri yönlendirin. Örneğin, bir iletişim bir onay mesajına "evet" yanıtı verirse, onu bir iş akışına kaydedin; "iptal" veya "yardım" yanıtı verirse, başka bir iş akışına kaydedin. Bunu ayrıca opt-in onayı yakalamak, yükseltme yollarını tetiklemek veya yapılandırılmamış yanıtlardan niyet tespit etmek için de kullanabilirsiniz.

### Message Read (giden)

Bu tetikleyici, bir iletişim Flowella üzerinden gönderilen bir WhatsApp mesajını okuduğunda (açtığında) tetiklenir. Etkileşimi izlemek ve mesaj teslimi etrafında koşullu mantık oluşturmak için kullanışlıdır.

**Tipik kullanım:** yalnızca iletişimin ilk mesajınızı gördüğünü onayladıktan sonra bir takip dizisi başlatın veya belirli bir süre içinde mesajı okumayan iletişimleri işaretleyin.

### Message Sent (giden)

Bu tetikleyici, Flowella aracılığıyla bir iletişime bir WhatsApp mesajı başarıyla gönderildiğinde tetiklenir. İletişim tarafından alınmasından ziyade Flowella platformundan gönderimi onaylar. Bir HubSpot iş akışı dışından kaynaklanan gönderimler için bir tetikleyici olarak en kullanışlıdır; örneğin, Flowella gelen kutusundan bir temsilcinin gönderdiği bir yanıt veya otomatik bir Flow yanıtı gibi, çünkü bir iş akışı zaten kendisi gönderdiği mesajları bilir.

**Tipik kullanım:** giden mesajlaşma etkinliğini kaydedin, bir mesajın gönderildiğini kaydetmek için CRM özelliklerini güncelleyin veya takip eylemleri için bir zamanlayıcı başlatın.

### Flowella tetikleyicileriyle "Olay gerçekleşene kadar beklet" kullanımı

Flowella'yı HubSpot ile birleştirmenin en güçlü özelliklerinden biri **Olay gerçekleşene kadar beklet** eylemidir. Bu, bir iş akışının devam etmeden önce herhangi bir Flowella olayını duraklatıp beklemesine olanak tanır.

Örneğin, şu işlemleri yapan bir iş akışı oluşturabilirsiniz:

1. Bir iletişime WhatsApp Flow formu gönderir
2. Flowella olayına ayarlanmış **Olay gerçekleşene kadar beklet** kullanarak duraklar (bunlar seçicide **Flowella: WhatsApp Forms Integration: Form Completed** ve benzeri olarak görünür)
3. Seçtiğiniz zaman penceresi içinde olay ölçütlerinin karşılanıp karşılanmadığına göre dallandırır

Bu, otomasyonunuzun içinde gerçek bir istek-yanıt deseni oluşturur. Olay gecikme süresi içinde gerçekleşmezse, iş akışı alternatif bir yola dallanır, örneğin bir hatırlatma gönderme veya bir ekip üyesine yükseltme gibi.

Bu deseni herhangi bir Flowella olayıyla kullanabilirsiniz:

* **Form Completed bekle**: iletişim bir WhatsApp Flow'u tamamlayana kadar duraklatın, ardından yanıtlarını işleyin
* **Text Reply bekle**: iletişim yanıt verene kadar duraklatın, ardından mesaj içeriğine göre dallandırın
* **Message Read bekle**: iletişim mesajı açana kadar duraklatın, ardından takip etmeye mi karar verin yoksa daha mı beklemeye karar verin

## Eylemler

Tetikleyicilere ek olarak, Flowella dört özel iş akışı eylemi sağlar. Bunlar, herhangi bir HubSpot iletişim tabanlı iş akışına bir adım eklediğinizde eylem panelinde görünür.

### Send WhatsApp Template

Bu eylem, bir iletişime önceden onaylanmış bir WhatsApp şablon mesajı gönderir. Şablonlar Flowella uygulamasında oluşturulup yönetilir ve hem standart mesaj şablonlarını hem de etkileşimli WhatsApp Flow şablonlarını (formlar) içerir.

| Alan                                  | Açıklama                                                                                                                                                                                                  |
| ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Contact Phone Number**\*(zorunlu)\* | Alıcının WhatsApp telefon numarasını tutan HubSpot iletişim özelliğini seçin. Uluslararası biçimde olmalıdır (ör. `+447700900000`).                                                                       |
| **Template Name**\*(zorunlu)\*        | Flowella uygulamasında oluşturulan şablonların açılır menüsünden seçin. Bu, hem standart mesaj şablonlarını hem de Flow şablonlarını (etkileşimli formlar) içerir.                                        |
| **Contact Email**                     | İsteğe bağlı olarak iletişimin e-posta adresini eşleyin. Flowella bunu eşleştirme, zenginleştirme ve analiz için kullanabilir.                                                                            |
| **Template Variable 1 to 5**          | HubSpot iletişim veya şirket özelliklerini, şablonunuzda tanımlanan kişiselleştirme değişkenleriyle eşleyin. Örneğin, şablonunuz ad için `{{1}}` içeriyorsa, Template Variable 1'i Ad özelliğine eşleyin. |

**Önemli noktalar:**

* Flow şablonları (etkileşimli formlar) tam olarak standart mesaj şablonlarıyla aynı şekilde seçilir ve Flowella dönüşümü otomatik olarak halleder.
* Kayıtlı iletişim özellikleri, şirket özellikleri ve önceki iş akışı eylemlerinden gelen veriler dahil olmak üzere herhangi bir HubSpot veri belirteci kullanarak en fazla beş şablon değişkeni eşleyebilirsiniz.
* Gerekli bir şablon değişkeni eşlenmeden bırakılırsa, o iletişim için gönderim başarısız olabilir.
* Bu eylem rezervasyon onayları, geri bildirim istekleri, yenileme hatırlatmaları, randevu bildirimleri ve diğer yapılandırılmış veya şablonlu mesajlar için idealdir.

### Send WhatsApp Message

Bu eylem, bir iletişime doğrudan bir WhatsApp mesajı gönderir. Şablon eyleminin aksine, bu eylem iş akışı içinde anlık olarak bir mesaj oluşturmanıza olanak tanır ve birden fazla medya türünü destekler.

| Alan                                    | Açıklama                                                                                                                                                                                                                                                                                                   |
| --------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Message Type**\*(zorunlu)\*           | Şunlardan birini seçin: Metin Mesajı, Belge, Görüntü, Video veya Ses.                                                                                                                                                                                                                                      |
| **Recipient Phone Number**\*(zorunlu)\* | Alıcının WhatsApp telefon numarasını tutan HubSpot iletişim özelliğini seçin.                                                                                                                                                                                                                              |
| **Message Text**                        | Metin mesajları için mesaj içeriğini girin. Veri belirteci panelini tıklayarak herhangi bir HubSpot veri belirtecini kullanarak kişiselleştirin. Mevcut belirteçler kayıtlı iletişim özelliklerini, ilişkili kayıtları, tetikleyici ve olay verilerini ve önceki iş akışı eylemlerinin çıktılarını içerir. |

**Önemli noktalar:**

* Metin mesajları, iletişimin adı, bir anlaşma tutarı veya bir bilet referans numarası gibi dinamik içerikle tamamen kişiselleştirilebilir.
* Medya mesajları (görüntü, video, ses, belge) otomatik bir iş akışının parçası olarak doğrudan WhatsApp üzerinden zengin içerik göndermenize olanak tanır.
* Bu eylem, kişiselleştirilmiş teşekkür mesajları veya önceki iş akışı mantığı tarafından tetiklenen bağlamsal yanıtlar gibi önceden onaylanmış bir şablon gerektirmeyen takip mesajları için özellikle kullanışlıdır.

### Send WhatsApp Reply

Bu eylem, **24 saatlik müşteri hizmetleri penceresi kapalı olsa bile çalışan** kişisel hissettiren bir WhatsApp mesajı gönderir. İş akışı, müşterinin son gelen mesajından saatler veya günler sonra çalışabileceğinde **Send WhatsApp Message** yerine bunu kullanın.

| Alan                                    | Açıklama                                                                                                                                                             |
| --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Recipient Phone Number**\*(zorunlu)\* | Alıcının WhatsApp telefon numarasını tutan HubSpot iletişim özelliğini seçin. Uluslararası biçimde olmalıdır (ör. `+447700900000`).                                  |
| **Message**\*(zorunlu)\*                | Mesaj gövdesi. HubSpot veri belirteçleriyle (iletişim, şirket, anlaşma, bilet veya önceki eylem çıktıları) kişiselleştirin.                                          |
| **Skip if window is closed**            | İşaretlendiğinde, 24 saatlik pencere kapanmışsa eylem **hiçbir şey yapmaz**. Yalnızca aktif bir konuşmada hala olan iletişimleri dürtmek istiyorsanız bunu kullanın. |

**Nasıl çalışır:**

* **24 saatlik pencere içinde** — mesajınız normal bir serbest biçim WhatsApp metni olarak gönderilir.
* **Pencere dışında** — Flowella mesajınızı aktif [yeniden açma şablonu](/settings/reply-templates) içine sarar (değişken `{{3}}`). İletişimin adı (`{{1}}`) ve işletme adınız (`{{2}}`) otomatik olarak doldurulur. Bir Utility şablon konuşması açılır (genellikle ülkeye bağlı olarak gönderim başına \~0,045 \$ — bkz. [Fiyatlandırma ve konuşma kategorileri](/account/pricing-and-conversation-categories)).

**Ne zaman Send WhatsApp Message yerine kullanılır:**

* 24 saatlik sessizlikten sonra çalışabilen yeniden etkileşim, elde tutma ve müşteri başarısı kadansları.
* Uzun gecikmeler içeren iş akışlarında **Form Completed** tetikleyicilerine takip mesajları.
* Tek bir HubSpot eyleminin pencere durumundan bağımsız olarak "sadece çalışmasını" istediğiniz herhangi bir gönderim.

**İpucu:** Bu eylem çalışmadan önce açık ile kapalı pencereler için farklı mantığa ihtiyacınız varsa, Flowella tarafından gelende senkronize edilen `whatsapp_window_open_until` iletişim özelliğine göre dallandırın.

### Assign to Customer Agent

Bu eylem, bir konuşmayı bir HubSpot Breeze Customer Agent'a atar ve doğrudan Flowella WhatsApp kanalı içinde yapay zeka destekli bir konuşma başlatır.

| Alan                             | Açıklama                                                             |
| -------------------------------- | -------------------------------------------------------------------- |
| **Agent to assign**\*(zorunlu)\* | Konuşmayı hangi Breeze Customer Agent'ın işlemesi gerektiğini seçin. |
| **Record to assign**             | "Conversations: All associated" gibi atanacak kayıt türünü seçin.    |

Bu eylem aracılığıyla bir konuşmayı bir Breeze Customer Agent'a atadığınızda, AI agent Flowella kanalı aracılığıyla iletişime doğrudan WhatsApp'ta yanıt vermeye başlar. Bu, müşterilerinizin zaten içinde oldukları WhatsApp konuşmasından ayrılmadan akıllı, bağlamsal yanıtlar aldığı anlamına gelir.

Bu eylem özellikle şunlar için değerlidir:

* **Form sonrası destek**: bir müşteri bir sorgu formu gönderdikten sonra, AI agent takip sorularını hemen yanıtlayabilir
* **Çalışma saatleri dışı işleme**: ekibiniz uygun olmadığında WhatsApp konuşmalarını bir AI agent'a yönlendirin
* **Triyaj ve yükseltme**: AI agent'ın ilk soruları işlemesine izin verin ve yalnızca gerektiğinde bir insana yükseltin
* **Ürün ve hizmet sorguları**: canlı bir temsilci gerektirmeden bilgi tabanınızdan anlık yanıtlar sağlayın

***

## İş akışı kalıpları

İşte Flowella tetikleyicilerini, gecikmeleri ve eylemleri etkili bir şekilde birleştiren dört yaygın kalıp.

### Kalıp 1: Gönder ve bekle

Form tabanlı herhangi bir etkileşim için temel kalıp.

<Steps>
  <Step title="Formu gönder">
    Bir Flow form şablonuyla bir **Send WhatsApp Template** eylemi ekleyin.
  </Step>

  <Step title="Tamamlanmayı bekle">
    Bir **Olay gerçekleşene kadar beklet** eylemi ekleyin: Flowella: Form Completed.
  </Step>

  <Step title="Sonuca göre dallandır">
    Bir **Dal** eylemi ekleyin: olay ölçütlerinin karşılanıp karşılanmadığı.
  </Step>

  <Step title="Sonuca göre dallandır">
    Bir **Dal** eylemi ekleyin: olay ölçütlerinin karşılanıp karşılanmadığı.
  </Step>

  <Step title="Mutlu yol">
    Ölçütler karşılanırsa: form verilerini işleyin, CRM özelliklerini güncelleyin ve sonraki adımları tetikleyin.
  </Step>

  <Step title="Yedek yol">
    Ölçütler karşılanmazsa: bir hatırlatma gönderin veya bir ekip üyesine yükseltin.
  </Step>
</Steps>

***

### Kalıp 2: Anahtar kelime tabanlı yönlendirme

İletişimleri yanıtladıklarına göre doğru iş akışına yönlendirin.

<Steps>
  <Step title="Tetikleyiciyi ayarla">
    Message özelliğinin "book" veya "reserve" gibi anahtar kelimeler içerdiği yerde **Flowella: Text Reply** kullanın.
  </Step>

  <Step title="İlgili formu gönder">
    Rezervasyon Flow şablonunuzla bir **Send WhatsApp Template** eylemi ekleyin.
  </Step>

  <Step title="Bekle ve dallandır">
    Flowella: Form Completed'a ayarlanmış bir **Olay gerçekleşene kadar beklet** ekleyin, ardından yanıtları dallandırıp işleyin.
  </Step>

  <Step title="Bekle ve dallandır">
    Flowella: Form Completed'a ayarlanmış bir **Olay gerçekleşene kadar beklet** ekleyin, ardından yanıtları dallandırıp işleyin.
  </Step>
</Steps>

***

### Kalıp 3: Akıllı takiple geri bildirim

Geri bildirim toplayın ve puana bağlı olarak farklı eylemlerde bulunun.

<Steps>
  <Step title="Geri bildirim formunu gönder">
    Geri bildirim Flow şablonunuzla bir **Send WhatsApp Template** eylemi ekleyin.
  </Step>

  <Step title="Yanıtı bekle">
    Flowella: Form Completed'a ayarlanmış bir **Olay gerçekleşene kadar beklet** ekleyin.
  </Step>

  <Step title="Yanıtı bekle">
    Flowella: Form Completed'a ayarlanmış bir **Olay gerçekleşene kadar beklet** ekleyin.
  </Step>

  <Step title="Puana göre dallandır">
    Puan özelliğine dayalı bir **Eğer/o zaman dalı** kullanın:

    * Yüksek puan → bir inceleme bağlantısı ile bir teşekkür mesajı gönderin
    * Düşük puan → bir bilet oluşturun ve AI destekli kurtarma için bir Customer Agent'a atayın
  </Step>

  <Step title="Puana göre dallandır">
    Puan özelliğine dayalı bir **Eğer/o zaman dalı** kullanın:

    * Yüksek puan: bir inceleme bağlantısı ile bir teşekkür mesajı gönderin
    * Düşük puan: bir bilet oluşturun ve AI destekli kurtarma için bir Customer Agent'a atayın
  </Step>
</Steps>

***

### Kalıp 4: Konuşmaya dayalı AI devri

Gelen yanıtları doğrudan bir AI agent'a devredin.

<Steps>
  <Step title="Tetikleyiciyi ayarla">
    Herhangi bir gelen mesajı yakalamak için **Flowella: Text Reply** kullanın.
  </Step>

  <Step title="Alındığını onayla">
    Mesajlarını aldığınızı onaylamak için bir **Send WhatsApp Message** eylemi ekleyin.
  </Step>

  <Step title="AI agent'a ata">
    Bir **Assign to Customer Agent** eylemi ekleyin. Ardından Breeze Customer Agent, konuşmayı WhatsApp'ta yerel olarak işler.
  </Step>
</Steps>

***

## Tarih ve saat değişkenleri

HubSpot, tarih ve tarih-saat özelliklerini **epoch milisaniye** olarak saklar. Bu özelliklerden birini bir Flowella şablon değişkenine eşlediğinizde, Flowella değeri alıcının saat diliminde **`dd.MM.yyyy HH:mm`** olarak görüntüler — örneğin, `27.06.2026 14:30`.

Bu üç yerde geçerlidir:

* **Send WhatsApp Template** — bir HubSpot tarih veya tarih-saat özelliğine eşlenen herhangi bir `Template Variable n`.
* **Send WhatsApp Message** — mesaj gövdesinde kullanılan satır içi tarih belirteçlerine aynı biçimlendirme uygulanır.
* **Eski `variable_*` belirteç yükleri** — açık tür meta verisi olmadan epoch değerleri gönderen eski API entegrasyonları algılanır ve aynı şekilde görüntülenir.

<Note>
  Harici HubSpot uygulamalarından (örneğin, "sonraki randevu" özelliği yazan zamanlama araçları) enjekte edilen randevu tarihi belirteçleri artık aynı `dd.MM.yyyy HH:mm` deseniyle görüntülenir. Daha önce teslim edilen mesajda ham epoch sayıları gördüyseniz, hiçbir şey yapmanız gerekmez — platform düzeyinde düzeltildi.
</Note>

<Tip>
  Farklı bir biçime ihtiyacınız varsa, tarihi metin olarak biçimlendiren bir **HubSpot hesaplanmış özellik** oluşturun (örneğin, `27 Haziran 2026, 14:30`) ve bunu şablon değişkenine eşleyin. Flowella metin özelliklerini olduğu gibi işler.
</Tip>

## İpuçları ve en iyi uygulamalar

<Tip>
  **Uluslararası telefon numarası biçimi kullanın.** WhatsApp telefon numaralarını her zaman E.164 biçiminde saklayın (ör. İngiltere için `+44`, ABD için `+1`). Flowella mesajları başarılı bir şekilde teslim etmek için bunu gerektirir.
</Tip>

<Tip>
  **Şablonlarınızı net bir şekilde adlandırın.** Flowella uygulamasında şablon oluştururken, HubSpot'ın açılır menüsünde kolayca tanımlanabilir açıklayıcı adlar kullanın. "Rezervasyon Onayı Restoran", "Şablon 1"den daha nettir.
</Tip>

<Tip>
  **Güvenilirlik için tetikleyicileri gecikmelerle birleştirin.** "Gönder ve bekle" kalıbı, iş akışınızın yalnızca tetikleyicilere güvenmek yerine hem yanıt veren hem de yanıt vermeyen iletişimleri zarif bir şekilde işlemesini sağlar.
</Tip>

<Tip>
  **Konuşmaya dayalı yönlendirme için Text Reply tetikleyicisini kullanın.** Mesaj içeriğine göre filtreleyerek, tam bir chatbot olmadan hafif konuşma arayüzleri oluşturabilirsiniz. Basit anahtar kelime eşleştirmesi iletişimleri minimum sürtünme ile doğru iş akışına yönlendirebilir.
</Tip>

<Tip>
  **Önce küçük kitlelerle test edin.** Yeni iş akışları oluştururken, tam iletişim listenize sunmadan önce küçük bir test grubunu kaydederek başlayın. Bu, şablon değişkenleri, telefon numarası biçimlendirmesi veya dallandırma mantığı ile ilgili sorunları erken yakalamanıza yardımcı olur.
</Tip>
