> For the complete documentation index, see [llms.txt](https://user.netmera.com/netmera-user-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://user.netmera.com/netmera-user-guide/netmera-user-guide-tr/panel-ayarlari/ayarlar/mesajlasma-ve-icerik/e-posta-sablonlari.md).

# E-posta şablonları

**Yol:** `Ayarlar > Mesajlaşma ve İçerik > Mail Şablonları`

## Mail Şablonu Oluştur

{% hint style="info" %}
**Hızlı Adımlar Rehberi**

`Ayarlar` > `Mesajlaşma ve İçerik`> `Mail Şablonları` > `E-posta Şablonu Oluştur`

1. Açın **Mail Şablonları**.
2. Tıklayın **E-posta Şablonu Oluştur**.
3. Ayarla **Şablon Etiketi** ve **E-posta Türü**.
4. Gönderen bilgilerini ve konu alanlarını doldurun.
5. Düzeni şu ögelerle oluşturun: **Yapılar** ve **Bloklar**.
6. Önizleyin, test edin, ardından **Kaydedin.**
   {% endhint %}

### Windows Outlook Yapılandırmaları <a href="#windows-outlook-configurations" id="windows-outlook-configurations"></a>

Windows Outlook'un bazı sürümleri, **CSS tanımları** ise **eksikse** veya **düzgün uygulanmamışsa**. Tüm e-posta istemcilerinde, özellikle Outlook'ta tutarlı bir görünüm sağlamak için şablonunuzun **medya stilleri içerdiğinden** CSS bölümünde emin olun.

**CSS bölümüne medya stilleri ekleme:**

1. Şablonu açın ve Kod Editörü'ne geçin.
2. Sağ üst köşedeki CSS sekmesini açın.
3. Medya stil tanımlarınızı ekleyin ve kaydedin.
4. Test: Birkaç farklı istemcide önizleyin (Outlook, Gmail, Apple Mail).

Örnek:

```css
@media only screen and (max-width: 600px) {
  body {
    background-color: lightblue;
  }
}
```

### Şablon Özellikleri

<figure><img src="/files/c71443384c6d05b8f95e35d88eeaf3aac1b6d663" alt="" width="563"><figcaption></figcaption></figure>

<table><thead><tr><th width="156.70953369140625">Özellik</th><th>Açıklama</th></tr></thead><tbody><tr><td><strong>Şablon Etiketi</strong></td><td>Yalnızca size görünür olan dahili ad. Şablonları hızlıca tanımlamak için açıklayıcı adlar seçin.</td></tr><tr><td><strong>E-posta Türü</strong></td><td>Birini seçin:<br>- <strong>Bildirim</strong>: İşlemsel e-postalar için (şifre sıfırlama, onaylama). Opt-in durumundan bağımsız olarak tüm kullanıcılara gönderilir.<br>- <strong>Kampanya/Reklam</strong>: Yalnızca opt-in olan kullanıcılara gönderilen pazarlama e-postaları.</td></tr><tr><td><strong>Gönderen Adresi</strong></td><td>Alıcıların göreceği önceden kayıtlı gönderen e-posta adresi.</td></tr><tr><td><strong>Gönderici Adı</strong></td><td>Alıcılarınızın tanıyacağı görünen ad (ör. şirket adı).</td></tr><tr><td><strong>Mail Konusu</strong></td><td>E-posta içeriğini yansıtan net ve kısa bir konu satırı.</td></tr><tr><td><strong>Mail Ön Başlığı</strong></td><td>Konu satırından sonra gösterilen isteğe bağlı önizleme metni (en az 40 karakter önerilir).</td></tr><tr><td><strong>Yanıt E-postası</strong></td><td>Alıcıların doğrudan yanıt vermesini istiyorsanız isteğe bağlı yanıt adresi. Devre dışı bırakmak için boş bırakın.</td></tr></tbody></table>

{% hint style="warning" %}

#### E-posta Türü ve Opt-Out'larla İlgili Önemli Notlar

* **Bildirim e-postaları** opt-in tercihlerini atlar ve tüm kullanıcılara gönderilir; temel bilgiler için tasarlanmıştır.
* **Kampanya e-postaları** opt-in durumuna uyar ve yalnızca abonelikten çıkmamış kullanıcılara gönderilir.
  {% endhint %}

## Netmera E-posta Editörü

<figure><img src="/files/9e716ff99b4cb1b1ed6da80a6505e28d62b45028" alt=""><figcaption></figcaption></figure>

### Yapılar ve Modüller

İçeriği düzenleyen önceden tanımlı yerleşimler (ör. tek sütunlu, çift sütunlu). Şablon çalışma alanına kolayca sürüklenebilir. Kenarlıkları (boyut, renk, yuvarlatılmış kenarlar) tek tek veya toplu olarak özelleştirebilirsiniz.

<figure><img src="/files/381840edf8e122b7ab27480f6301c93d532a2651" alt="" width="563"><figcaption></figcaption></figure>

### Bloklar (Simge Araç Çubuğu)

Editörün sol tarafında yer alan simge tabanlı araç çubuğu (yeşil ile vurgulanmış), tüm kullanılabilir içerik bloklarına erişim sağlar. Bloklar, e-posta içeriği oluşturmak için önceden tanımlı yerleşimler içinde kullanılan sürükle-bırak öğeleridir. Özelleştirilebilir özellikler arasında yazı tipi, hizalama, renkler, iç boşluk ve boyut bulunur.

<table><thead><tr><th width="118.27545166015625">Blok Türü</th><th width="165.36749267578125" valign="middle">Açıklama</th><th width="268.45458984375" valign="top">Temel Özellikler</th><th>Kullanım Senaryoları</th></tr></thead><tbody><tr><td><strong>Görsel</strong></td><td valign="middle">E-postanıza bir görsel (veya GIF) ekler.</td><td valign="top"><ul><li>Kütüphanenizden yükleyin veya bir URL kullanın</li><li>Tıklamada isteğe bağlı bağlantı</li><li>Yerleşim içinde duyarlı boyutlandırma</li></ul></td><td>Logolar, ana görseller, ürün görselleri</td></tr><tr><td><strong>Metin</strong></td><td valign="middle">Biçimlendirilmiş metin içeriği ekler.</td><td valign="top"><ul><li>Başlıklar, paragraflar, listeler</li><li>Bağlantılar</li></ul></td><td>Gövde metni, yasal uyarılar, duyurular</td></tr><tr><td><strong>Buton</strong></td><td valign="middle">Bir eylem çağrısı (CTA) butonu ekler.</td><td valign="top"><ul><li>Özel etiket + bağlantı</li><li>Tüm e-posta istemcilerinde çalışır</li></ul></td><td>Şimdi alışveriş yap, şifreyi sıfırla, e-postayı onayla</td></tr><tr><td><strong>Boşluk</strong></td><td valign="middle">Bloklar arasında dikey boşluk ekler.</td><td valign="top"><ul><li>Sabit yükseklikte boşluk</li></ul></td><td>Bölümleri ayırın ve okunabilirliği artırın</td></tr><tr><td><strong>Sosyal</strong></td><td valign="middle">Profil bağlantılarıyla sosyal medya simgeleri ekler.</td><td valign="top"><ul><li>Yaygın ağlar (ör. Instagram, X, LinkedIn)</li><li>Tıklama bağlantıları</li></ul></td><td>Alt bilgi sosyal bağlantıları</td></tr><tr><td><strong>Menü</strong></td><td valign="middle">Web sitesi başlıklarına benzer gezinme bağlantıları ekler.</td><td valign="top"><ul><li>Birden fazla bağlantı</li><li>Yatay veya dikey yerleşim</li><li>İsteğe bağlı ayırıcılar</li></ul></td><td>Bültenler ve çok bölümlü e-postalar için gezinme</td></tr><tr><td><strong>HTML</strong></td><td valign="middle">Özel HTML/CSS ekler.</td><td valign="top"><ul><li>Gelişmiş yerleşimler için tam kontrol</li><li>E-posta istemcisi desteği değişiklik gösterebilir</li></ul></td><td>Özel bileşenler, özel yerleşimler</td></tr><tr><td><strong>Banner</strong></td><td valign="middle">Belirgin bir görselle bir kampanyayı öne çıkarır.</td><td valign="top"><ul><li>Görsel + isteğe bağlı başlık/açıklama</li><li>Tıklamada isteğe bağlı bağlantı</li></ul></td><td>Kampanyalar, öne çıkan duyurular</td></tr><tr><td><strong>Video</strong></td><td valign="middle">Bir video URL'sine bağlantı veren video önizlemesi ekler.</td><td valign="top"><ul><li>Küçük resim + oynat simgesi</li><li>Tıklandığında videoyu harici olarak açar</li></ul></td><td>Ürün demoları, webinar davetleri</td></tr><tr><td><strong>Sayaç</strong></td><td valign="middle">Hedef tarih/saat için bir geri sayım sayacı ekler.</td><td valign="top"><ul><li>Belirli bir tarih/saat'e geri sayar</li><li>Süresi dolduktan sonra gizlenebilir veya değiştirilebilir</li></ul></td><td>Flaş indirimler, sınırlı süreli teklifler</td></tr><tr><td><strong>Karusel</strong></td><td valign="middle">Bir kaydırıcı içinde birden fazla görsel/öge gösterir.</td><td valign="top"><ul><li>Bağlantılı birden fazla görsel</li><li>Otomatik oynatma veya manuel kontroller</li></ul></td><td>Ürün galerileri, öne çıkanlar, referanslar</td></tr><tr><td><strong>Akkordeon</strong></td><td valign="middle">Uzun içerikler için genişletilebilir bölümler (yalnızca AMP).</td><td valign="top"><ul><li>Birden fazla bölüm (başlık + gövde)</li><li>AMP destekli istemcilerde genişlet/daralt etkileşimi</li></ul></td><td>SSS, kaydırma gerektirmeyen uzun biçimli içerik</td></tr><tr><td><strong>Form</strong></td><td valign="middle">E-posta içinde giriş toplar (yalnızca AMP).</td><td valign="top"><ul><li>Giriş alanları + gönder düğmesi</li><li>Harici işleme/uç nokta gerektirir</li></ul></td><td>Anketler, RSVP'ler, hızlı lead toplama</td></tr></tbody></table>

<figure><img src="/files/cd777fdb4eeb67dd0b316c5f59a0b92f6068c3ac" alt=""><figcaption></figcaption></figure>

#### İçerik Blokları

E-posta içinde statik veya özel içerik göstermek için kullanılır.

* **Görsel** – Görselleri ve GIF'leri yükleyin ve düzenleyin.
* **Metin** – Metin, başlıklar, birleşik stiller ve listeler ekleyin.
* **Banner** – Vurgulu bölümler için görsel ve metin kombinasyonları
* **HTML** – Gelişmiş yerleşimler için özel HTML/CSS içeren öğe ekleyin

<div><figure><img src="/files/63a89c52a801db4ebf6ca087b68f2d3273ddaf80" alt=""><figcaption></figcaption></figure> <figure><img src="/files/79897e543b69bd0d3c49ecd6781328459f467549" alt=""><figcaption></figcaption></figure> <figure><img src="/files/aaea1d78bb709246166161e34c85f9bd619cbb81" alt=""><figcaption></figcaption></figure></div>

#### Eylem ve Etkileşim Blokları

E-postadan doğrudan etkileşimi teşvik etmek için tasarlanmıştır.

* **Buton** – Eylem çağrısı öğeleri
* **Form** – Kullanıcı girdisi toplayın (anketler, RSVP'ler, iletişim formları; harici olarak işlenir)
* **Akkordeon** – Yapılandırılmış içerik için genişletilebilir bölümler

{% hint style="warning" %}
**Not**: Akkordeon ve Form blokları AMP tabanlı bileşenlerdir. Yalnızca e-postanın AMP HTML sürümünde desteklenirler. Alıcının e-posta istemcisi AMP'yi desteklemiyorsa:

* Akkordeon içeriği **etkileşimli olmayacak** olacak
* Form gönderimleri **etkileşimli olmayacak** e-posta içinde çalışır. Form gönderimleri her zaman harici işleme gerektirir.
  {% endhint %}

<div><figure><img src="/files/ac189dd73e77d7ad0487d22c6115e8015d27ca8f" alt=""><figcaption></figcaption></figure> <figure><img src="/files/f9fa23ccaf492e525062a827620b24dd5c2ab5c9" alt=""><figcaption></figcaption></figure> <figure><img src="/files/3a428a8758eaa65dc3e433c4e3122023ed37dbcc" alt=""><figcaption></figcaption></figure></div>

#### Yerleşim ve Yapı Blokları

Boşluğu ve gezinmeyi kontrol etmek için kullanılır.

* **Boşluk** – Dikey boşluk ekleyin
* **Menü** – Gezinme bağlantılarını görüntüleyin

<div><figure><img src="/files/1dc9553f7d6d6c256986afb2841fd0a6ad7dc676" alt=""><figcaption></figcaption></figure> <figure><img src="/files/4d48463ef700c98d800e3dda271d0b739a219195" alt=""><figcaption></figcaption></figure> <figure><img src="/files/e35130341a1c7269dfa3e0af281c01233f85386d" alt=""><figcaption></figcaption></figure></div>

#### Dinamik / Medya Blokları

Dinamik veya zamana bağlı içerik eklemek için kullanılır.

* **Karusel** – Dönen görseller veya içerik
* **Sayaç** – Geri sayım sayaçları
* **Video** – Video önizlemeleri veya küçük resimler

<div><figure><img src="/files/a4bf6f1e30f9285f3b4bcafb6310ccf254e3f2f8" alt=""><figcaption></figcaption></figure> <figure><img src="/files/c23cffc7a658e21819a7a4d4438ee50fe6555548" alt=""><figcaption></figcaption></figure> <figure><img src="/files/b4cec154fb7209238e7f770355831f890a575458" alt=""><figcaption></figcaption></figure></div>

#### Sosyal ve Yardımcı Bloklar

E-postalarda yaygın olarak kullanılan destekleyici öğeler.

* **Sosyal** – Sosyal medya simgeleri ve profil bağlantıları

<div><figure><img src="/files/2b1e6d7c3d22f49dcd3d7ef1cc89f6e950450098" alt=""><figcaption></figcaption></figure> <figure><img src="/files/9b040c8e215010e54751d83cf787307313caf5a4" alt=""><figcaption></figcaption></figure></div>

### Modüller

* Yeniden kullanılabilir içerik bloklarını veya tam şablonları gelecekte kullanmak üzere kaydedin
* Modülleri ada veya etikete göre arayın ve filtreleyin
* Modülleri gerektiğinde düzenleyin veya silin

<div><figure><img src="/files/05b7701e307ab9e8bfa7f196b8ab3e9aa41e65b6" alt=""><figcaption></figcaption></figure> <figure><img src="/files/54852d83e5d661d5d9bc0382e2496384ac7fbc0c" alt=""><figcaption></figcaption></figure></div>

### Görsel Yapılandırma

Görsel Yapılandırma, şu bölümde bulunan genel stil ayarlarını ifade eder: **Genel Stiller ve Yerleşim** paneli.\
Bu ayarlar tüm e-posta şablonunu etkiler ve hangi blok seçili olursa olsun etkin kalır.

Tipik kullanım senaryoları şunlardır:

* Tutarlı bir içerik genişliği belirleme
* Şablon genelinde boşlukları ve kenar boşluklarını kontrol etme
* Arka plan renkleri veya arka plan görselleri uygulama
* Yerleşimin farklı cihazlarda doğru şekilde uyum sağlamasını garanti etme

> Bu yapılandırmalar genel olarak uygulanır ve tek tek içerik bloklarından bağımsızdır.

<div align="left"><figure><img src="/files/5153a86daa04ccd04b4a0d1b736830deedb292f3" alt="" width="301"><figcaption></figcaption></figure> <figure><img src="/files/eaf2691f23c2b037cdfda128308cfbe372ff92e1" alt=""><figcaption></figcaption></figure> <figure><img src="/files/1b536056f30f3c684a58140f8abcf0dc8a43113c" alt="" width="301"><figcaption></figcaption></figure></div>

### Genel Görünüm ve Yerleşim

Bu **Genel Stiller ve Yerleşim** paneli, tüm e-posta şablonuna uygulanan görsel ayarları yapılandırmanıza olanak tanır. Blok düzeyi ayarlarının aksine, bu paneldeki seçenekler hangi içerik bloğu seçilirse seçilsin etkin kalır.

* **Varsayılan İç Boşluk** – İçerik ile şablon kenarları arasındaki boşluğu genel olarak veya bölüm bazında kontrol edin.
* **Arka Plan Rengi** – Tüm şablon için temel bir arka plan rengi belirleyin.
* **Yazı Tipi ve Satır Aralığı** – Okunabilirliği artırmak için yazı tipi stillerini seçin ve satır aralığını ayarlayın.
* **Paragraf Alt Boşluğu** – Paragraflar arasındaki boşluğu tanımlayın.
* **Bağlantıların Altını Çiz** – Bağlantıları daha görünür kılmak için alt çizgiyi açın veya kapatın.
* **Duyarlı Tasarım** – Yerleşimin mobil cihazlara doğru şekilde uyum sağlamasını garanti edin.
* **RTL Metin Yönü** – Desteklenen diller için sağdan sola metin akışını etkinleştirin.
* **Arka Plan Görseli** – Bir PNG, JPG veya GIF yükleyin (en fazla 1 MB) ya da arka plan görseli eklemek için bir URL kullanın.
* **Özel Liste Stilleri** – Liste girintisini, listelerin üst ve alt boşluğunu, öğe aralığını, liste türünü (madde işaretli veya numaralı) ve liste işaretçisi rengini ayarlayın.

#### Dinamik Davranış

Ayarlar paneli, seçili öğeye göre otomatik olarak güncellenir:

* Hiçbir blok seçili değilken genel e-posta ayarları görüntülenir.
* Bir içerik bloğu seçildiğinde (ör. Buton, Görsel, Form), bloğa özel ayarlar görünür.

Kullanılabilir seçenekler, mevcut seçime bağlı olarak dinamik şekilde değişir.

> Kullanılabilir ayarlar, seçili öğeye bağlı olarak otomatik şekilde değişir.

### Mesaj Ayarları

Bu **Mesaj Ayarları** sekmesi, yerleşim veya içerik bloklarıyla ilgili olmayan e-posta düzeyi özellikleri yapılandırmak için kullanılır.

Bu ayarlar, e-postanın alıcının gelen kutusunda nasıl göründüğünü belirler **açılmadan önce**.

Aşağıdaki seçenekleri yapılandırabilirsiniz:

* **Konu / Başlık**\
  Gelen kutusunda görüntülenen e-posta konu satırını tanımlar.\
  \&#xNAN;*Önerilen uzunluk: en fazla 65 karakter.*
* **Gizli Ön Başlık**\
  Gelen kutularında konu satırının yanında gösterilen kısa önizleme metni.\
  \&#xNAN;*Önerilen uzunluk: 50–100 karakter.*
* **Gmail için E-posta Notları**\
  Gmail'in **Promosyonlar** sekmesinde, özellikle mobil cihazlarda teklifleri, indirimleri veya kampanyaları doğrudan öne çıkarmanızı sağlar.
* **UTM Parametreleri**\
  Google Analytics gibi araçlarda kampanya takibini desteklemek için e-postadaki tüm bağlantılara otomatik olarak UTM etiketleri ekler.

### Şeritler

Şeritler, şablonu yapılandırmak için kullanılan yatay bölümlerdir. İçeriği net biçimde ayırmaya ve okunabilirliği artırmaya yardımcı olurlar.

#### Şerit Bölümleri

* **Başlık:**\
  Metin boyutu, yazı tipi rengi, arka plan rengi, bağlantı rengi ve arka plan görseli seçenekleriyle şablonunuzun üst bölümünü özelleştirin.
* **İçerik:**\
  Metin boyutu, yazı tipi rengi, bağlantı rengi ve içerik arka planı gibi ana gövde ayarlarını düzenleyin.

  **İpucu:** Bu alanı, net yazı tipleri ve kontrastlı arka plan renkleriyle okunabilirliği artırmak için kullanın.
* **Alt Bilgi:**\
  Arka plan renkleri, yazı tipi ve bağlantı renkleri ile isteğe bağlı bir arka plan görseli seçenekleriyle alt bölümü tasarlayın.

  **İpucu:** İletişim bilgilerini ve sosyal medya bağlantılarını buraya ekleyin.
* **Bilgi Alanı:**\
  Tarihler, saatler veya harici işlemlere bağlantılar (ör. kayıt veya bilet satın alma) gibi ayrıntılar için ayrı bir bölüm.

  **İpucu:** Etkinlikle ilgili bilgileri öne çıkarmak için idealdir.

### Başlıklar

Şablon genelinde başlıkların görünümünü özelleştirin:

* Yazı tipi türünü ve boyutunu ayarlayın
* Satır aralığını ve rengi ayarlayın
* İtalik veya kalın stil uygulayın

### Buton

Butonların şablonunuzda nasıl görüneceğini kontrol edin:

* Buton ve yazı tipi renklerini ayarlayın
* Yazı tipi boyutunu ve stilini seçin (italik/kalın)
* Kenarlık boyutunu, rengini ve köşe yarıçapını ayarlayın

{% hint style="info" %}
**Outlook desteği**

Bu seçenek, Microsoft Outlook e-posta istemcilerinde butonların işlenmesini iyileştirir.\
Etkinleştirildiğinde, farklı Outlook sürümlerinde tutarlı bir görünüm sağlamak için butonlar Outlook ile uyumlu işaretleme kullanılarak oluşturulur.

> Not: Bu seçeneğin etkinleştirilmesi, her buton için e-posta boyutunu biraz artırabilir.
> {% endhint %}

<div><figure><img src="/files/c5f70fe618c197eecd56da9e85aa3315ba2c0f32" alt="" width="202"><figcaption></figcaption></figure> <figure><img src="/files/d89dceac4a3b9cea8a1e0543c8d4624beed8938e" alt="" width="225"><figcaption></figcaption></figure></div>

Yerleşim ve görünüm ayarlarını her cihaz için ayrı ayrı yapılandırmak üzere Masaüstü ve Mobil görünümler arasında geçiş yapabilirsiniz.

### Önizleme ve Test

<div align="center" data-full-width="false"><figure><img src="/files/a4f3d2e6b744d0aed4cfa4bd90025b799d23b517" alt="" width="375"><figcaption></figcaption></figure></div>

Bir e-posta kampanyası göndermeden önce, tutarlı bir görüntüleme sağlamak için şablonu farklı cihaz ve e-posta istemcilerinde önizlemeniz ve test etmeniz önerilir.

Editör, şu görünümler arasında geçiş yapmanıza olanak tanır: **Masaüstü** ve **Mobil** görünümleri, e-posta yerleşiminin farklı ekran boyutlarına nasıl uyum sağladığını simüle eder.\
Bu, şu gibi duyarlı davranışları doğrulamaya yardımcı olur:

* Mobilde içeriğin alt alta dizilmesi
* Görsel ve buton hizalaması
* Daha küçük ekranlarda metin okunabilirliği

#### Genişletilmiş Görünümde E-posta Editörünü Kullanma

Şunu kullanabilirsiniz: **Genişlet** düğmesi, daha kolay düzenleme ve önizleme için editörü daha büyük bir görünümde açar.

Bu görünüm, özellikle daha küçük ekranlarda e-posta içeriğiyle çalışmayı kolaylaştıran daha geniş bir çalışma alanı sağlar.

Varsayılan editör görünümüne dönmek için şuna tıklayın: **Daralt**.

#### Nasıl Çalışır

1. Şunu açın: **Stripo Editörü**.
2. Tıklayın **Genişlet** editörü genişletilmiş görünümde açmak için.
3. E-posta şablonunuzu daha büyük çalışma alanında düzenleyin ve önizleyin.
4. Tıklayın **Daralt** varsayılan görünüme dönmek için.

{% hint style="success" %}
E-postanın gerçek e-posta istemcilerinde nasıl görüneceğini görmek için harici önizleme seçeneğini kullanabilirsiniz.\
Bu, e-posta istemcisi sınırlamalarından kaynaklanan yerleşim farklılıklarını belirlemek için faydalıdır.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://user.netmera.com/netmera-user-guide/netmera-user-guide-tr/panel-ayarlari/ayarlar/mesajlasma-ve-icerik/e-posta-sablonlari.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.