Webhook olaylarını yönetin

Webhook, seçtiğiniz MailGraf olaylarını gerçekleştiği anda başka bir servise gönderir. Bir kişinin aboneliği onaylandığında CRM kaydını güncellemek gibi, API'yi düzenli aralıklarla sorgulamadan işlem başlatmanız gereken durumlarda kullanın.

Endpoint ekleyin

1. Ayarlar > Webhook sayfasını açın

   Yeni bağlantı için Endpoint ekle butonuna tıklayın.

2. Hedef adresi girin

   İsteğe bağlı bir Ad ve Endpoint URL girin. URL, HTTPS kullanmalı ve internete açık bir adrese çözülmelidir.

3. Olayları seçin

   Olaylar bölümünde en az bir olay seçin. Yalnızca karşı servisin işleyeceği olayları ekleyin.

4. Test olayı gönderin

   Endpointi kaydedin ve Test olayı gönder butonuna tıklayın. Test olayı hemen bir kez gönderilir ve başarısız olursa yeniden denenmez.

Karşı servis yedi saniye içinde 2xx yanıtı vermelidir. MailGraf yönlendirmeleri izlemez. Bu nedenle 3xx yanıtı başarısız teslim sayılır.

Doğru olayları seçin

Kişi hareketleri

• contact.subscribed: kişi aboneliğini onaylar.
• contact.unsubscribed: kişi abonelikten ayrılır.
• contact.complained: alıcı bir emaili spam olarak bildirir.
• contact.tag_added ve contact.tag_removed: tek bir etiket üyeliği değişir.
• contact.list_added ve contact.list_removed: tek bir liste üyeliği değişir.

Etiket ve liste üyeliği olayları kişi panelindeki tekil işlemlerden, otomasyonlardan, formlardan ve public API'den gelir. Toplu içe aktarma ve toplu işlemler, her üyelik değişimi için ayrı webhook olayı oluşturmaz.

Kampanya ve email hareketleri

• campaign.sent: kampanya tamamlanır. MailGraf bu olayı her alıcı için değil, kampanya için bir kez gönderir.
• email.delivered: email teslim edilmiş olarak kabul edilir.
• email.bounced: email geri döner.

Form hareketleri

• form.submitted: form gönderilir. Bu olay çift onay tamamlanmadan önce oluşur. Bu nedenle gönderilen veride henüz kişi kimliği bulunmayabilir.

Karşı servis yalnızca onaylanmış aboneliklerde çalışacaksa contact.subscribed olayını kullanın. Form gönderildiği anda çalışacaksa form.submitted olayını kullanın.

Başarısız teslimleri izleyin

30 günlük saklama süresi içindeki son 50 denemeyi görmek için Son teslimler bölümünü açın. Her kayıt olay türünü, yanıt durumunu, deneme sayısını ve teslim zamanını gösterir.

MailGraf normal bir olay teslimini toplam beş kez dener. İlk deneme başarısız olursa 1 dakika, 5 dakika, 30 dakika ve 2 saat sonra yeniden dener. Başarısız bir teslimde Şimdi tekrar dene seçeneğine tıklamadan önce karşı servisteki sorunu giderin. Elle yeniden deneme, yeni bir teslim döngüsü başlatır.

Tam referans nerede

MailGraf public API sözleşmesini API referansında bulabilirsiniz. Webhook teslimleri, olay seçimi ve imza işlemleri Ayarlar > Webhook bölümünde yönetilir.