> 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/omnichannel-etkilesim/e-posta/e-posta-sablonu-olusturun.md).

# E-posta Şablonu Oluşturun

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

`Ayarlar` > `E-posta Şablonları` > `E-posta Şablonu Oluştur`

1. Aç **E-posta Şablonları**.
2. Tıklayın **E-posta Şablonu Oluştur**.
3. Ayarla **Şablon Etiketi** olmalı ve **E-posta Türü**.
4. Gönderen bilgilerini ve konu alanlarını doldurun.
5. Düzeni şu öğelerle oluşturun: **Yapılar** olmalı 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ümlerinde bozulmalar görülebilir, eğer **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 stillerini içerdiğinden** CSS bölümünde emin olun.

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

1. Şablonu açın ve Kod Düzenleyici’ye 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 sizin görebildiğiniz dahili ad. Şablonları hızlıca ayırt etmek 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, onaylar). Opt-in durumuna bakılmaksızın 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örebileceği, önceden kayıtlı gönderen e-posta adresi.</td></tr><tr><td><strong>Gönderen Adı</strong></td><td>Alıcılarınızın tanıyacağı görünen ad (ör. şirket adı).</td></tr><tr><td><strong>E-posta Konusu</strong></td><td>E-posta içeriğini yansıtan, net ve kısa e-posta konusu.</td></tr><tr><td><strong>E-posta Ö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 Abonelikten Çıkma Hakkında Ö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 aboneliği iptal etmemiş kullanıcılara gönderilir.
  {% endhint %}

## Netmera E-posta Düzenleyicisi

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

### Yapılar ve Modüller

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

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

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

Düzenleyicinin sol tarafında, simge tabanlı araç çubuğu (yeşil ile vurgulanmış) mevcut tüm içerik bloklarına erişim sağlar. Bloklar, e-posta içeriğini oluşturmak için önceden tanımlı düzenlerin 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ıklayınca isteğe bağlı bağlantı</li><li>Düzen 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 satın al, ş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ır ve okunabilirliği artırır</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 (örn. Instagram, X, LinkedIn)</li><li>Tıklanabilir 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 düzen</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ş düzenler için tam kontrol</li><li>E-posta istemcisi desteği değişiklik gösterebilir</li></ul></td><td>Özel bileşenler, özel hazırlanmış düzenler</td></tr><tr><td><strong>Afiş</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ıklayınca 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ğlanan video önizlemesi ekler.</td><td valign="top"><ul><li>Küçük resim + oynatma göstergesi</li><li>Tıklandığında videoyu harici olarak açar</li></ul></td><td>Ürün tanıtımları, web semineri davetleri</td></tr><tr><td><strong>Zamanlayıcı</strong></td><td valign="middle">Hedef tarih/saat için geri sayım sayacı ekler.</td><td valign="top"><ul><li>Belirli bir tarih/saat için geri sayar</li><li>Süre 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/öğe 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>Akordeon</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 aç/kapat etkileşimi</li></ul></td><td>SSS, kaydırma gerektirmeyen uzun form 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 butonu</li><li>Harici işleme/uç nokta gerektirir</li></ul></td><td>Anketler, RSVP’ler, hızlı potansiyel müşteri 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ştirme stilleri ve listeler ekleyin.
* **Afiş** – Vurgulanan bölümler için görsel ve metin kombinasyonları
* **HTML** – Gelişmiş düzenler için özel HTML/CSS ile öğ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ı

Doğrudan e-postadan 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)
* **Akordeon** – Yapılandırılmış içerik için genişletilebilir bölümler

{% hint style="warning" %}
**Not**: Akordeon 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:

* Akordeon içeriği **olmayacaktır** etkileşimli
* Form gönderimleri **olmayacaktır** e-postanın 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>

#### Düzen ve Yapı Blokları

Boşluk 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
* **Zamanlayıcı** – Geri sayım zamanlayıcı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

* Gelecekte kullanım için yeniden kullanılabilir içerik bloklarını veya tam şablonları kaydedin
* Modülleri ada veya etiketlere göre arayın ve filtreleyin
* İhtiyaç halinde modülleri 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, bölümünde bulunan genel stil ayarlarını ifade eder. **Genel Stiller ve Düzen** paneli.\
Bu ayarlar tüm e-posta şablonunu etkiler ve hangi blok seçilirse seçilsin etkin kalır.

Tipik kullanım senaryoları şunları içerir:

* Tutarlı bir içerik genişliği tanımlama
* Şablon genelinde boşlukları ve kenar boşluklarını kontrol etme
* Arka plan renkleri veya arka plan görselleri uygulama
* Düzenin farklı cihazlarda doğru şekilde uyarlanmasını sağlama

> 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 Düzen

Kişi **Genel Stiller ve Düzen** paneli, tüm e-posta şablonuna uygulanan görsel ayarları yapılandırmanıza olanak tanır. Blok düzeyi ayarları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 stilleri 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ı Altı Çizili Yap** – Bağlantıların daha görünür olması için altı çizili gösterimini açıp kapatın.
* **Duyarlı Tasarım** – Düzenin mobil cihazlara doğru şekilde uyarlanmasını sağlayın.
* **RTL Metin Yönü** – Desteklenen diller için sağdan sola metin akışını etkinleştirin.
* **Arka Plan Görseli** – Arka plan görseli eklemek için PNG, JPG veya GIF yükleyin (maks. 1 MB) ya da 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şareti rengini ayarlayın.

#### Dinamik Davranış

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

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

Mevcut seçenekler, geçerli seçime bağlı olarak dinamik şekilde değişir.

> Mevcut ayarlar, seçilen öğeye bağlı olarak otomatik olarak değişir.

### Mesaj Ayarları

Kişi **Mesaj Ayarları** sekmesi, düzen 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österilen 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 Açıklamaları**\
  Gmail’in içinde teklifleri, indirimleri veya kampanyaları doğrudan vurgulamanızı sağlar. **Promosyonlar** sekmesinde, özellikle mobil cihazlarda.
* **UTM Parametreleri**\
  Kampanya takibini Google Analytics gibi araçlarda 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 bir şekilde ayırmaya ve okunabilirliği artırmaya yardımcı olurlar.

#### Şerit Bölümleri

* **Üst Bilgi:**\
  Metin boyutu, yazı tipi rengi, arka plan rengi, bağlantı rengi ve arka plan görseli seçenekleriyle şablonunuzun üst kısmı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 kontrast oluşturan arka plan renkleriyle okunabilirliği artırmak için kullanın.
* **Alt Bilgi:**\
  Arka plan renkleri, yazı tipi ve bağlantı renkleri ve 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ı burada ekleyin.
* **Bilgi Alanı:**\
  Tarih, saat veya harici işlemlere (örn. kayıt ya da bilet satın alma) bağlantılar gibi ayrıntılar için ayrı bir bölüm.

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

### Başlıklar

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

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

### Buton

Şablonunuzdaki butonların görünümünü kontrol edin:

* Buton ve yazı tipi renklerini ayarlayın
* Yazı tipi boyutunu ve stilini seçin (italik/kalın)
* Kenar kalınlığını, 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 görüntülenmesini iyileştirir.\
Etkinleştirildiğinde, butonlar farklı Outlook sürümlerinde tutarlı bir görünüm sağlamak için 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>

Düzen ve görünüm ayarlarını her cihaz için ayrı ayrı yapılandırmak üzere Masaüstü ve Mobil görünümleri 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ı görüntülenmeyi sağlamak için şablonu farklı cihazlar ve e-posta istemcilerinde önizlemeniz ve test etmeniz önerilir.

Düzenleyici, aralarında geçiş yapmanıza olanak tanır **Masaüstü** olmalı ve **Mobil** görünümleriyle e-posta düzeninin farklı ekran boyutlarına nasıl uyum sağladığını simüle edebilirsiniz.\
Bu, aşağıdaki gibi duyarlı davranışları doğrulamaya yardımcı olur:

* Mobilde içeriklerin alt alta gelmesi
* Görsel ve buton hizalaması
* Küçük ekranlarda metin okunabilirliği

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

şu seçeneği kullanabilirsiniz: **Genişlet** Düzenleyiciyi daha büyük bir görünümde açmak için butonunu kullanın; böylece düzenleme ve önizleme daha kolay olur.

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

Varsayılan düzenleyici görünümüne geri dönmek için **Daralt**.

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

1. şunu açın: **Stripo Düzenleyicisi**.
2. Tıklayın **Genişlet** düzenleyiciyi genişletilmiş görünümde açmak için.
3. E-posta şablonunuzu daha geniş ç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-postayı 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 düzen farklılıklarını belirlemek için kullanışlı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/omnichannel-etkilesim/e-posta/e-posta-sablonu-olusturun.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.