WPP Marketing
Dil ve para birimi
Giriş Yap
Vaka çalışmaları Planlar
Sitede ara
Dil ve para birimi
Etkinlikler API'si

Mağazanızdan veya ERP'nizden etkinlikler göndererek WhatsApp'ta otomasyonları tetikleyin.

Kendi sisteminizin WPP Marketing’e sepet, sipariş, ödeme, gönderim, iptal veya müşteri oluşturma bilgisi iletmesi gerektiğinde Events API’yi kullanın.

Events API ticari olayı alır ve yapılandırılmış otomasyonları kullanır. Bir mesajı doğrudan göndermek için şunu kullanın: Messaging API. Teslimat, okuma ve hataları takip etmek için şunu kullanın: durum webhook'ları.

Akış

Sistemin olay bildirir. WPP Marketing otomasyonu belirler.

Events API, tak ve özelleştirilmiş mağazalar, ERP'ler, back office'lar ve plug-and-play konektörü olmayan entegrasyonlar için idealdir.

01 Olay gerçekleşir

Sipariş, sepet, ödeme, gönderim, iptal veya kayıt kaynak sistemde gerçekleşir.

02 Sistem payload gönderir

Backend'iniz, token, kimlik, müşteri, değerler ve kullanılabilir bağlantılar ile olayı gönderir.

03 Kural değerlendirilir

WPP Marketing, o etkinlik ve müşteri için aktif bir otomasyon olup olmadığını kontrol eder.

04 Mesaj gönderildi

Müşteri, kurtarma, ödeme, sipariş, gönderim, kampanya veya satış sonrası için WhatsApp mesajı alır.

Desteklenen ticari etkinlikler.

Nihai adlandırma ve zorunlu alanlar Events API dokümantasyonuna uygun olmalıdır.

POST cart.created

Satın alma niyetini kaydeder ve ilk takip otomasyonlarını etkinleştirir.

Carrinho
POST cart.abandoned

Kullanılabilir olduğunda hatırlatıcı ve geri dönüş bağlantısıyla sepet kurtarmayı tetikler.

Recuperação
POST order.created

İşlemsel mesajlar için oluşturulan veya ödemesi beklenen siparişi bildirir.

Pedido
POST order.paid

Ödemeyi onaylar ve onay mesajı, talimatlar ve sonraki adımlara izin verir.

Pagamento
POST order.shipped

Manuel talepleri azaltmak için gönderi güncellemeleri, izleme veya lojistik durum gönderir.

Envio
POST order.cancelled

Bu etkinlik için yapılandırılmış iletişimi tetiklemek üzere sipariş iptalini kaydeder.

Cancelamento
POST customer.created

Karşılama, ilişki yönetimi, etiketler ve kampanyalar için kişi veritabanını besler.

Cliente
Önerilen veriler

Etkinlik ne kadar iyi olursa, otomasyon o kadar iyi olur.

Events API, mesaj için müşteri, satın alma, tutar, durum ve faydalı bağlantıları tanımlamak için yeterli veriyi almalıdır.

Müşteri

Telefon numarası, isim, e-posta, ülke ve harici tanımlayıcı, çoğaltmayı önleme ve segmentasyona yardımcı olur.

Sipariş

Numara, harici kimlik, toplam, para birimi, durum, ödeme yöntemi ve öğeler mesajı daha faydalı hale getirir.

Bağlantılar

Ödeme (checkout), ödeme, takip veya sipariş sayfası otomatik mesajlarda kullanılabilir.

İdempotans (Idempotency)

external_id veya order.id sağlayın ve kaynağı sabit tutun. Çoğaltma önleme hesap, normalleştirilmiş kaynak, olay türü ve dış tanımlayıcıyı dikkate alır. Tekrarlanan olaylar Duplicate event ignored bildirimi ile HTTP 200 döner. Bu endpoint Messaging API'nin Idempotency-Key başlığını kullanmaz.

Yanıt

HTTP 200, olayın işlendiğini doğrular, bir mesajın teslim edildiğini değil. Gönderim için olay için aktif bir otomasyon, geçerli müşteri verileri ve yapılandırılmış bir bağlantı gerekir. Mesajı raporlar ve durum webhook’ları üzerinden takip edin.

Güvenlik

events:write yetkisine sahip bir kimlik bilgisi (credential) oluşturun ve olayları sunucudan gönderin. Jetonu frontend ve herkese açık depolardan uzak tutun. Telefon için customer.phone kullanın ve örnekte ve OpenAPI sözleşmesinde olduğu gibi customer ve order nesnelerini kullanın.

Özel bir mağaza veya ERP bağlamak mı istiyorsunuz?

Üretim olaylarını göndermeden önce payload'ları, kimlik doğrulamayı ve örnekleri doğrulamak için Events API dokümantasyonunu açın.

Swagger'ı Aç