# E-posta ile çalışma

##  E-posta mesajları göndermek için 

{% hint style="warning" %}
Lütfen dikkat edin!

E-posta mesajlarıyla çalışmak için işlevleri yürütürken, işlev şunu döndürür:

a) ya <mark style="color:yeşil;">**YOK**</mark> — işlevin başarıyla çalışması durumunda;

b) ya da <mark style="color:kırmızı;">**hata durumu**</mark> metin.
{% endhint %}

send\_email() | send\_email\_from\_bot() | send\_email\_template()

<details>

<summary>Açıklama</summary>

<mark style="color:varsayılan;background-color:blue;">**Bir e-posta mesajı göndermek için**</mark>

**send\_email(to\_email, subject, message)**&#x20;

Parametreler:

<mark style="color:kırmızı;">**!**</mark>**&#x20;to\_email - alıcının** e-posta adresi

<mark style="color:kırmızı;">**!**</mark>**&#x20;subject -** e-posta konusu

<mark style="color:kırmızı;">**!**</mark>**&#x20;message -** e-posta gövde metni

<mark style="color:varsayılan;background-color:blue;">**Bot aracılığıyla e-posta mesajları göndermek için**</mark>

**send\_email\_from\_bot(email\_bot, client\_email, email\_subject, text, attachment\_url)**&#x20;

Parametreler:

<mark style="color:kırmızı;">**!**</mark>**&#x20;email\_bot** - e-posta dağıtım kanalıyla bağlantılı e-posta adresi \ <mark style="color:kırmızı;">**!**</mark>**&#x20;client\_email** - mesajın gönderileceği müşterinin e-posta adresi\ <mark style="color:kırmızı;">**!**</mark>**&#x20;email\_subject** - e-posta konusu (başlık)\ <mark style="color:kırmızı;">**!**</mark>**&#x20;text** - e-postada gönderilen mesaj gövdesi \
**attachment\_url** - ek URL'si&#x20;

<mark style="color:varsayılan;background-color:blue;">**Bir taslak ya da gönderilmiş e-postayı iletmek için**</mark>

**send\_email\_template(mailing\_id, client\_email, email\_bot, date)**

Parametreler:

<mark style="color:kırmızı;">**!**</mark>**&#x20;mailing\_id** - e-posta şablonu kimliği (ister bir taslak ister hazır bir e-posta)

<mark style="color:kırmızı;">**!**</mark>**&#x20;client\_email** - alıcının e-posta adresi

**email\_bot** - göndericinin e-posta adresi; varsayılan olarak projeyle bağlantılı e-posta

**date** - e-posta gönderim tarihi ‘gg.aa.yyyy SS:dd’ biçiminde. Tarih geçmişteyse veya belirtilmemişse, e-posta işlev çağrısından hemen sonra gönderilecektir.

</details>

<details>

<summary>Örnek</summary>

Bir e-posta mesajı göndermek için:

<div data-with-frame="true"><figure><img src="/files/b6ec85a328b84b165230a14318f3f8623d55854f" alt=""><figcaption></figcaption></figure></div>

Bot aracılığıyla gönderim

<div data-with-frame="true"><figure><img src="/files/ac1ccf5a93fb661bb07e6cc545d6c8a71a8a5562" alt=""><figcaption></figcaption></figure></div>

Daha önce gönderilmiş bir e-postayı gönderme örneği:

Dağıtım listesinden değişkeni alıyoruz - id.

Bu örnekte bu 483'tür ve mailing\_id olarak kullanılacaktır.

Kurucuya gidip işlevi aşağıdaki parametrelerle çağırıyoruz:

Seçenek 1 – parametreleri açıkça belirtme:

`e_letter = send_email_template('483', "test@mail.ru", '', '09.08.2022 15:00')`

Seçenek 2 – parametreleri değişkenler kullanarak belirtme:

`mailing_id = '483'`\
`client_email = 'test@mail.ru' # alıcının e-posta adresi`\
`email_bot = ''`\
`date = '09.08.2022 15:00' # gönderim anında tarih zaten geçmişte olduğu için, e-posta işlev çağrısı üzerine hemen gönderilecektir`\
`e_letter = send_email_template(mailing_id, client_email, email_bot, date)`

<div data-with-frame="true"><figure><img src="/files/e15410a205a93098bf64bb4b1e97ac46dfed5bcf" alt=""><figcaption><p>Bir e-posta göndermek için örnek ayar</p></figcaption></figure></div>

Sonuç olarak, işlev çağrıldığında, önceden hazırlanmış e-postanın şablonu <test@mail.com> adresine gönderildi.

</details>

<details>

<summary>Kopyalama için kod örneği</summary>

```
send_email('john.smith@gmail.com', 'Bu bir başlıktır', 'Ve bu da bir metindir')

/*bot aracılığıyla*/
mailing = send_email_from_bot('test_channel@test.com', 'test_client@gmail.com', 'E-posta konusu. Sadece basit', 'Merhaba, size mesajımı gönderiyorum', 'https://sun9-82.userapi.com/impg/L3ZYWHnlseIQsqZO')
```

</details>

## Müşterinin e-posta adresine gönderimleri onaylamak için

confirm\_email\_subscription()

<details>

<summary>Açıklama</summary>

**confirm\_email\_subscription(email, sender\_name, bot\_email, callback,client\_name)**

{% hint style="info" %}
Bu işlev, e-posta kampanyaları göndermek için müşterilerden onay toplamayı amaçlar.

Bir müşteri e-posta adresini mesajlaşma uygulaması üzerinden verdiğinde, önce bir onay isteği gönderilir.
&#x20;Bir e-posta müşterisi, ancak müşteri onayını doğruladıktan sonra oluşturulur.

Sonuç olarak, onayı doğrulanmış e-posta adresleri daha güvenilir kabul edilir; bu da genel e-posta teslim edilebilirliğinizi ve gönderen itibarınızı iyileştirmeye yardımcı olur.
{% endhint %}

{% hint style="warning" %}
Önemli!&#x20;

Müşterinin onayı olmadan potansiyel olarak promosyon içeriği içeren gönderimler yapamazsınız.

Yaptırımlardan kaçınmak için bu bilgiyi göz ardı etmeyin.
{% endhint %}

Parametreler:

**email** - doğrulama ve ekleme için müşterinin e-posta adresi

**sender\_name** - bültenleri almayı kabul etmesi için onay istediğiniz şirket adı

**bot\_email** - yeni e-posta müşterisinin bağlanacağı bot e-posta adresi

**callback** - e-posta adresini onaylayan müşteriler ve yeni bir e-posta müşterisi için geri çağırmalar gerekli mi (veya değil mi) (varsayılan: False)

**client\_name** - bir e-posta müşterisine atanacak ad

Gönderilen geri çağırmalar şu biçimde olacaktır:

"client\_accept\_email\_subscription: #{email}" - e-posta adresini onaylayan müşteriye yönelik geri çağırma

"email\_client\_accepted\_by ID:#{@client.id}" - yeni müşteriye yönelik geri çağırma (onaylayan müşterinin kimliği client\_father\_id değişkeninde saklanacaktır)

Kullanıcı e-posta adresini verdikten sonra adresi doğrulamak için bir mesaj gönderin.

Kullanıcı şirketten bülten almak için onayını doğruladıktan sonra, listenize yeni bir e-posta müşterisi eklenecektir.

Bu sayede kampanyalarınızda hiçbir "ölü potansiyel müşteri" olmayacak ve e-posta veritabanınız yalnızca ürünlerinizle gerçekten ilgilenen müşterilerin adreslerinden oluşacaktır.

</details>


---

# Agent Instructions: 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:

```
GET https://docs.mavibot.ai/doc/tr/chatbot/functions/hesap-makinesi/email.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.