Bu rehberde: Gmail veya Google Workspace posta kutunuzu Google hesabınızla (OAuth) bağlarsınız. Müşteri adaylarına giden e-postalar bu kutudan çıkar; yanıtlar, otomatik yanıtlar, geri dönen e-postalar ve "beni listeden çıkarın" yanıtları 2 dakikada bir okunup adaylara işlenir. Uygulama şifresi veya SMTP ayarı gerekmez.
⏱ 5 dakika (platformun Google uygulaması hazırsa)
Kimlik kartı
| Alan | Değer |
|---|---|
| Sağlayıcı anahtarı | GMAIL |
| Kategori | Mesajlaşma (müşteri adayı posta kutusu) |
| Kimlik doğrulama | Google izin ekranı (OAuth 2.0) – GA4 / Search Console ile aynı Google istemcisi, ayrı izin |
| Kapsam | Proje bazlı |
| Webhook | Hayır (yanıtlar 2 dakikada bir Gmail API ile okunur) |
| Yetenekler | Mesaj gönderme, mesaj alma (yanıt takibi) |
| Kullanan kutular | E-posta gönder, Toplu mesaj (e-posta), Kampanyalar |
| Kullanan ajanlar | Outreach Agent (send_email, takip e-postaları), Gelen Kutusu yanıtları |
Ne işe yarar?
- Gönderim: Her e-posta, Email (SMTP) entegrasyonundaki kurallarla hazırlanır: yasal alt bilgi (gönderici bilgileri + tek tıkla abonelikten çıkma bağlantısı),
List-Unsubscribe/List-Unsubscribe-Postbaşlıkları, takiplerde aynı yazışma dizisi (In-Reply-To/References, "Re: "). Takip e-postaları Gmail'deki "Gönderilenler" klasöründe de aynı konuşmanın içinde görünür. - Gönderen adı: Bağlanırken Gmail'in varsayılan "Farklı gönder" kimliği okunur ve
"Ad Soyad" <adres>olarak kullanılır (Gmail ayarlarında ad boşsa Google hesabınızdaki ad). - Yanıt takibi: Gelen Kutusu'na düşen yeni e-postalar salt okunur biçimde okunur (hiçbiri okundu işaretlenmez, taşınmaz veya silinmez). Yanıt, gönderdiğimiz e-postanın Message-ID'sine veya gönderen adrese göre adaya eşlenir:
- Yanıt → konuşma Gelen Kutusu'nda açılır, aday "Yanıtladı" olur, bekleyen takipler durur.
- Otomatik yanıt (izin, tatil) → aday etkinliğine not düşülür; takipler sürer.
- Geri dönen e-posta (bounce) → adayın adresi "geri döndü" işaretlenir, bu adaya e-posta gönderimi durur.
- "Listeden çıkarın", "unsubscribe" → aday abonelikten çıkarılır; kampanya adımları atlanır.
- Hiçbir adaya eşlenmeyen e-postalar saklanmaz.
- Günlük limit: Her posta kutusu için günde en fazla 50 aday e-postası (ayarlanabilir). Limit dolunca e-posta silinmez, ertesi gün (UTC) gönderilir.
Önemli: Gmail izinleri ve Google doğrulaması
Gmail izinleri Google'ın en sıkı denetlenen izinleridir:
| Kapsam | Google sınıfı | Neden gerekli |
|---|---|---|
https://www.googleapis.com/auth/gmail.send | Hassas (sensitive) | E-posta göndermek |
https://www.googleapis.com/auth/gmail.readonly | Kısıtlı (restricted) | Yanıtları, geri dönmeleri ve abonelikten çıkma isteklerini okumak; gönderilen e-postanın gerçek Message-ID'sini almak |
openid, https://www.googleapis.com/auth/userinfo.email | Hassas değil | Bağlanan hesabın e-posta adresi |
- Platform herkese açık kullanıma geçmeden önce Google'ın OAuth uygulama doğrulamasından geçmelidir.
gmail.readonlykısıtlı kapsam olduğu için buna ek olarak yetkili bir değerlendiriciyle CASA güvenlik değerlendirmesi (Cloud Application Security Assessment, yılda bir yenilenir) gerekir. Bu süreç haftalar sürebilir ve ücretlidir. - Doğrulama tamamlanana kadar uygulama Testing durumunda kalır: yalnızca Audience → Test users listesine eklenen (en fazla 100) Google hesabı bağlanabilir ve bu hesapların yetkisi 7 günde bir düşer (yeniden yetkilendirme gerekir).
- Kullanıcı izin ekranında "E-postalarınızı görüntüleme" kutusunun işaretini kaldırırsa bağlantı yalnızca gönderim modunda kurulur: e-postalar gider ama yanıt takibi kapalıdır (kartta ve ayrıntı panelinde uyarı görünür). Gönderim izni (
gmail.send) verilmezse bağlantı kurulmaz.
Ön koşullar
- Bir Gmail (
@gmail.com) veya Google Workspace hesabı. - Workspace'te yöneticiniz üçüncü taraf uygulamaları kısıtladıysa: Yönetici konsolu → Güvenlik → API denetimleri → Uygulama erişimi denetimi bölümünde OrqLabs'a güvenin.
- Kurumsal alan adı kullanıyorsanız SPF, DKIM ve DMARC kayıtları Google Workspace için ayarlı olmalı (bkz. Email (SMTP) → DNS kayıtları).
Adım adım kurulum
A) Google Cloud Console (platform yöneticisi)
- APIs & Services → Library → Gmail API → Enable.
- Google Auth Platform → Data Access → Add or remove scopes →
gmail.send,gmail.readonly,openid,.../auth/userinfo.emailkapsamlarını ekleyin → Save. - Clients → mevcut Web application istemcisi (
GOOGLE_CLIENT_ID) → Authorized redirect URIs →https://api.orqlabs.com/api/v1/integrations/oauth/gmail/callback→ Save. - Audience: doğrulama bitene kadar bağlanacak hesapları Test users listesine ekleyin.
- Verification Center: marka doğrulaması (ana sayfa, gizlilik politikası, alan adı doğrulaması), her kapsam için kullanım gerekçesi ve demo videosu; ardından
gmail.readonlyiçin CASA değerlendirmesi.
B) OrqLabs'ta bağlama
- Entegrasyonlar → Gmail → Bağla → ① Proje. İsterseniz Günlük aday e-postası limiti ve Yanıt takibi alanlarını doldurun (boş: 50 / açık).
- ② Bağla → posta kutusunun Google hesabını seçin → izin ekranında iki kutuyu da işaretli bırakın → Devam.
- Kartta adresiniz görünür. Ayrıntı panelinde Posta kutusu ayarları: günlük limit, yanıt takibi ve son yanıt kontrolünün zamanı.
- Bağlantıyı test et: posta kutusu adresi ve yanıt takibinin durumu görünür.
- Projede birden çok e-posta hesabı varsa (SMTP, Outlook, Resend), adaylara giden e-postalar için kutu veya ajan ayarlarında bu hesabı seçin; seçilmezse projenin ilk e-posta hesabı kullanılır.
Gönderim limitleri
| Hesap | Google'ın günlük sınırı | Önerimiz |
|---|---|---|
@gmail.com | yaklaşık 500 alıcı | günde 30–50 |
| Google Workspace | 2.000 ileti | günde 50–150, yeni hesaplarda kademeli artış |
Sınırı aşmak hesabın geçici olarak gönderimden engellenmesine yol açar. OrqLabs limiti varsayılan olarak günde 50 tutar ve fazlasını ertesi güne erteler.
Sık karşılaşılan hatalar
| Hata | Olası neden | Çözüm |
|---|---|---|
access_denied / "uygulama doğrulanmadı" | Hesap test kullanıcısı değil (uygulama Testing durumunda) | Platform yöneticisi hesabı Test users listesine eklemeli |
| "Google izin ekranında gerekli izin verilmedi (gmail.send)" | Gönderim kutusunun işareti kaldırıldı | Yeniden bağlanın, tüm kutuları işaretleyin |
| Kartta "Yanıt takibi kapalı" | gmail.readonly verilmedi | Yeniden yetkilendir → tüm kutuları işaretleyin |
CONFIG – "Gmail API … etkin değil" | Gmail API Cloud projesinde açık değil | Platform yöneticisi Gmail API'yi etkinleştirmeli |
AUTH – invalid_grant, kart "Süresi doldu" | İzin iptal edildi, parola değişti veya Testing modunda 7 gün doldu | Yeniden yetkilendir |
RATE_LIMIT | Gmail günlük/dakikalık kotası | Günlük limiti düşürün; gönderim otomatik yeniden denenir |
| Yanıt adaya eşlenmedi | Yanıt başka bir adresten geldi ve adres adayda kayıtlı değil | Adayın e-postasını güncelleyin; eşlenmeyen e-postalar saklanmaz |
Sonraki adım
- Email (SMTP) – kendi SMTP sunucunuzla aynı akış
- Outreach Agent
- Google Takvim – yanıt veren adayla toplantı ayarlamak için