API ile e-posta otomasyonu: CRM, form ve bildirim senaryoları

E-posta kutunuza elle bakmak yerine uygulamalarınızın e-posta göndermesini ve okumasını istiyorsanız API doğru araçtır. COREMAIL JSON API, size ait posta kutularına anahtar tabanlı ve yetki kapsamlı erişim sunar.

Başlamadan önce: doğru anahtar

Panelde API anahtarları sayfasından her entegrasyon için ayrı bir anahtar oluşturun ve yalnızca gereken yetkileri verin:

• Yalnızca bildirim gönderen bir form: messages:send
• Gelen kutusunu okuyan bir raporlama aracı: messages:read
• İletileri işleyip arşive taşıyan bir bot: messages:read + messages:write

Anahtara bir son kullanma tarihi ve makul bir istek sınırı ekleyin. Anahtarı kaynak koduna değil, sunucunuzdaki bir ortam değişkenine yazın.

Senaryo 1: Web formu bildirimi

Web sitenizdeki teklif formu doldurulduğunda satış ekibine e-posta gönderin:

curl -X POST https://alanadiniz.com/api/v1/mailboxes/3/send \
  -H "Authorization: Bearer $COREMAIL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to": ["[email protected]"], "subject": "Yeni teklif talebi",
       "text": "Ad: Burak Aydın\nTelefon: ...\nMesaj: ..."}'

İleti, seçtiğiniz posta kutusunun kendi SMTP hesabıyla gönderilir ve Gönderilenler klasörüne kopyası eklenir.

Senaryo 2: CRM'den müşteriye e-posta

CRM'inizde bir fırsat aşaması değiştiğinde müşteriye otomatik bilgilendirme gönderebilirsiniz. Yanıt zincirini korumak için önceki iletinin message_id değerini in_reply_to alanında gönderin; müşterinin e-posta uygulaması iletileri aynı konuşmada gösterir.

Senaryo 3: Destek kutusunu işlemek

Bir zamanlanmış görev her 5 dakikada bir okunmamış iletileri alır, yardım masası sisteminize kayıt açar ve iletiyi okundu olarak işaretler:

GET  /api/v1/mailboxes/2/messages?folder=inbox&per_page=20
GET  /api/v1/mailboxes/2/messages/{uid}?folder=inbox
PATCH /api/v1/mailboxes/2/messages/{uid}?folder=inbox   {"seen": true}

Hata yönetimi

Her hata yanıtı makinenin okuyabileceği bir code içerir. Özellikle şunları ele alın:

• rate_limited (429): Retry-After başlığındaki süre kadar bekleyin.
• mailbox_locked (409): Posta kutusu parolası doğrulanmamış; kullanıcının panelden doğrulaması gerekir.
• insufficient_scope (403): Anahtara gerekli yetki verilmemiş.

Güvenlik kontrol listesi

• Her entegrasyona ayrı anahtar, en az yetki
• Anahtarlar ortam değişkeninde, kodda değil
• Son kullanma tarihi tanımlı
• Kullanılmayan anahtarlar iptal edildi

Tüm uç noktalar için API sayfamıza göz atın.