n8n ile Gmail Otomasyonu Nasıl Yapılır?

n8n'de Gmail otomasyonu, Gmail node'uyla e-posta göndermek, okumak ve etiketlemek, Gmail Trigger node'uyla da gelen yeni e-postalarla bir workflow başlatmaktır. Workflow, n8n'de bir işi otomatik yapan adımların bütünüdür. Node ise workflow'un adımlarından biridir. n8n editörü, workflow'ların kurulup düzenlendiği ekrandır. Editörün ortasındaki canvas, node'ların eklenip birbirine bağlandığı çalışma alanıdır ve her node burada bir kutu olarak görünür. Workflow'un ilk node'u olan trigger node, workflow'u belirli bir olayda ya da zamanda başlatır.

n8n'de Gmail node'u ne yapar?

n8n belgelerine göre Gmail node'u, Gmail'i başka uygulamalara bağlamak ve Gmail'deki işleri otomatikleştirmek için kullanılır. Gmail node'u şu dört kaynak üzerinde işlem yapar: Draft (taslak), Message (e-posta), Label (etiket) ve Thread (e-posta konuşması). Bazı işlemler şunlardır:

API, bir yazılımın başka bir yazılıma istek gönderip cevap alabildiği arayüzdür. HTTP Request node'u, bir web adresine istek gönderip cevabı alan node'dur. Belgelere göre Gmail node'u istenen işlemi desteklemiyorsa HTTP Request node'uyla Gmail API'sine doğrudan istek gönderilebilir.

Örnek: Bir kişi, bir formdan gelen her başvuruya Message > Send işlemiyle bir teşekkür e-postası gönderen bir workflow kurar. Başvuru sahibi, formu gönderdikten sonra bu e-postayı alır.

Temel n8n kavramları n8n nedir yazısında anlatılır.

n8n Gmail'e nasıl bağlanır?

Credential, n8n'in bir hizmete bağlanmak için gereken giriş bilgisini sakladığı kayıttır. Bir node'un kullanacağı credential, node'un Credential to connect with alanında seçilir. OAuth2, bir uygulamanın kullanıcının şifresini görmeden hesabına erişim izni almasını sağlayan yöntemdir. n8n belgelerine göre n8n, Gmail node'u için OAuth2 yöntemini önerir.

n8n Cloud, n8n şirketinin işlettiği sunucularda çalışan ve tarayıcıdan kullanılan sürümdür. Managed OAuth2, n8n belgelerine göre Google'a n8n üzerinden doğrudan giriş yapmayı sağlar ve sadece n8n Cloud kullanıcılarına açıktır. Bu yöntemle Google'da ayrıca bir OAuth uygulaması oluşturulmaz. n8n Cloud'da bağlantı adımları şunlardır:

1. Canvas'taki bir node'un sağındaki "Add node" (+) düğmesine tıkla. n8n, node'ları arayıp seçebildiğin node panelini (nodes panel) açar.
2. Arama kutusuna "Gmail" yaz, Gmail'i ve ardından bir işlemi seç. n8n node'u canvas'a ekler ve ayarlarını açar.
3. Credential to connect with listesinde "Create new credential" seçeneğini seç. Credential penceresi açılır.
4. Credential penceresinde "Sign in with Google" düğmesine tıkla. Google'ın giriş penceresi açılır.
5. Gmail hesabını seç. Hesabın listede yoksa e-posta adresini ve şifreni gir. Google, n8n'in hesaba erişmek için izin istediğini gösteren bir pencere açar.
6. İzin penceresinde n8n'e erişim izni ver. Pencere kapanır ve credential penceresine dönülür.
7. "Save" düğmesine tıkla ve credential penceresini kapat. Yeni credential, node'un Credential to connect with alanında seçili görünür.

Örnek: Bir kişi n8n Cloud'da Gmail node'unu ekler ve "Sign in with Google" ile kendi Gmail hesabını seçer. Credential'ı kaydettikten sonra Credential to connect with alanında bu hesabın kaydı görünür.

Managed OAuth2, n8n'i kendi sunucusuna kuran kullanıcı için yoktur. Google Cloud Console, Google hizmetlerine bağlanan uygulamaların ayarlandığı Google sitesidir. Belgelere göre bu kullanıcı Google Cloud Console'da bir OAuth uygulaması oluşturur ve APIs & Services > Library sayfasında Gmail API'yi etkinleştirir.

n8n'i kendi sunucusunda çalıştırmak isteyen okur için kurulum yolları n8n kurulumu nasıl yapılır yazısındadır.

n8n ile Gmail'den nasıl e-posta gönderilir?

n8n belgelerine göre e-posta Message > Send işlemiyle gönderilir. Adımlar şunlardır:

1. Gmail node'unun ayarlarında Message kaynağının Send işlemini seç.
2. To alanına alıcının e-posta adresini yaz.
3. Subject alanına e-postanın konusunu yaz.
4. Email Type alanında düz metin için Text, biçimli e-posta için HTML seç.
5. Message alanına e-postanın metnini yaz.
6. Node'daki "Execute step" düğmesine tıkla.
7. Alıcının gelen kutusunu aç ve e-postanın geldiğini kontrol et.

Örnek: Bir kişi To alanına kendi e-posta adresini, Subject alanına "Deneme" yazar ve Message alanına tek satırlık bir metin ekler. Node'u çalıştırdıktan sonra e-posta kendi gelen kutusuna gelir.

Belgelere göre Gmail node'u, gönderilen her e-postanın sonuna varsayılan olarak "This email was sent automatically with n8n" cümlesini ekler. Bu cümleyi kaldırmanın adımları şunlardır:

1. Node'un Options bölümünde "Add option" düğmesine tıkla.
2. Listeden Append n8n attribution seçeneğini seç.
3. Seçeneğin açma kapama düğmesini kapat.

Options bölümünde CC, BCC ve Attachments (ek dosya) seçenekleri de vardır. CC ve BCC, e-postanın kopyasının gideceği ek alıcılardır. BCC'deki alıcılar diğer alıcılara görünmez.

Gelen e-postayla n8n workflow'u nasıl başlatılır?

Belgelere göre Gmail Trigger node'u tek bir olayı destekler: Message Received. Node, Poll Times ayarında seçilen sıklıkta Gmail'i kontrol eder ve yeni e-posta geldiğinde workflow'u başlatır.

Belgelere göre Poll Times ayarındaki Mode seçenekleri Every Hour, Every Day, Every Week, Every Month, Every X ve Custom'dır. Every X seçeneğinde sıklık dakika ya da saat olarak yazılır. Custom seçilirse sıklık Cron Expression alanına yazılır. Cron Expression, bir işin hangi saniye, dakika, saat ve günlerde çalışacağını gösteren kısa bir yazımdır.

Örnek: Belgelere göre Cron Expression alanına 30 8 4 * * * yazılırsa workflow her gün saat 04.08.30'da başlar. Bu yazımdaki alanlar sırasıyla saniyeyi, dakikayı, saati, ayın gününü, ayı ve haftanın gününü gösterir. Yıldız (*) işareti her değer demektir.

n8n belgelerine göre Gmail Trigger node'unun filtreleri hangi e-postaların workflow'u başlatacağını belirler:

Belgelere göre her kontrolde en fazla Max Emails per Poll ayarındaki kadar e-posta çekilir. Varsayılan değer 10, üst sınır 50'dir. Max Emails per Poll ayarındaki sayıdan fazla okunmamış e-posta varsa kalanlar sıraya alınır ve bir sonraki kontrolde çekilir.

Örnek: Bir kişi, Gmail Trigger node'unun Search alanına from: ve ardından bir tedarikçinin e-posta adresini yazar. Workflow sadece bu tedarikçiden gelen e-postalarla başlar ve her e-postanın konusunu bir Google Sheets tablosuna yazar.

n8n ile onay isteyen e-posta nasıl gönderilir?

n8n belgelerine göre Message > Send and Wait for Approval işlemi bir e-posta gönderir ve alıcı onay verene kadar workflow'u bekletir. Onay düğmesinin varsayılan etiketi Approve, ret düğmesininki Decline'dır. Belgeler bu işlemi basit onay süreçleri için uygun bulur. Daha karmaşık onaylar için Wait node'unu önerir. Wait node'u, workflow'u belirli bir süre geçene ya da bir olay gerçekleşene kadar bekletir.

Örnek: Bir ekip, yeni bir blog yazısını yayımlamadan önce Send and Wait for Approval ile editöre bir e-posta gönderir. Editör e-postadaki Approve düğmesine tıklayınca workflow devam eder ve yazıyı yayımlar.

n8n Gmail'de hangi hatalar çıkar?

n8n belgelerine göre sık görülen hatalar ve çözümleri şunlardır:

• "Forbidden" hatası en sık, credential olarak Service Account kullanıldığında ve Impersonate a User ayarı kapalıyken görülür. Service Account, bir uygulamanın kişi yerine kendi adına kullandığı Google hesabıdır. Çözüm için credential'da Impersonate a User ayarını aç. Bu ayar, Service Account'un bir kullanıcı adına işlem yapmasını sağlar.
• 401 unauthorized_client hatası, credential'ın izinlerinde bir sorun olduğunu gösterir. Çözüm için OAuth2 kullanılıyorsa Gmail API'yi APIs & Services > Library sayfasında etkinleştir.
• "Bad request" hatası en sık var olmayan bir Message ID, Thread ID ya da Label ID girildiğinde görülür. Çözüm için kimliği ilgili Get işlemiyle, örneğin Message > Get ile doğrula.
• n8n belgelerine göre Audience ayarında External seçilen OAuth uygulaması Testing modunda başlar. Bu modda sadece test kullanıcısı olarak eklenen Google hesapları giriş yapabilir. Erişim jetonu (token), Google'ın n8n'e verdiği ve hesaba erişim izni sağlayan koddur. Testing modunda izin ve erişim jetonları yedi gün sonra sona erer ve bağlantı kopar. Çözüm için n8n'deki credential penceresinden yeniden bağlan.

Sonraki adım

n8n'de yeni bir workflow aç ve bir Gmail node'u ekle. Credential'ı oluştur ve Message kaynağının Send işlemini seç. Kendi e-posta adresine bir deneme e-postası gönder. Gelen kutunda e-postanın sonunda "This email was sent automatically with n8n" cümlesinin göründüğünü kontrol et.