Mercateer
Geliştirici

Mercateer ön ofis olaylarını webhook olarak alın

Bir uç noktayı Mercateer olaylarına abone edin ve bir çağrı sona erdiğinde, bir müşteri adayı geldiğinde veya bir iş randevusu alındığında imzalı bir yük alın. Uç noktaları API veya panelden kaydedin ve yönetin; her gönderimi HMAC ile doğrulayın.

Webhooks nedir?

Webhook’lar, Mercateer ön ofis olaylarını gerçek zamanlı olarak kontrol ettiğiniz bir URL’ye iter; böylece kendi sistemleriniz API’yi sorgulamadan tepki verebilir. Her gönderim HMAC ile imzalanmış bir JSON yüküdür; uç noktaları API veya panelden kaydedip yönetirsiniz ve başarısız gönderimler geri çekilmeli olarak yeniden dener.

Webhooks ile neler yapabilirsiniz

Yeni müşteri adayı yakalandı ve kişi oluşturuldu
IntegrationPages.Conversation started, closed, or handoff requested
IntegrationPages.Call completed
Randevu alındı ve randevu yeniden planlandı
IntegrationPages.Quote accepted
Alındığında HMAC ile imzalanmış yükleri doğrulayın
Uç noktaları API veya panelden kaydedin ve yönetin

Dakikalar içinde kurun

1

Bir uç nokta oluşturun

URL’nizi kaydedin ve API üzerinden veya Ayarlar > Geliştirici bölümünden abone olmak istediğiniz olayları seçin. Mercateer, bu uç nokta için bir imzalama sırrı (signing secret) döndürür. API erişimi, Crew ve Fleet planlarında dahildir.

2

İmzayı doğrulayın

IntegrationPages.On every delivery, read the timestamp (t) and signature (v1) from the signature header, then compute the HMAC-SHA256 of the string "{timestamp}_{raw request body}" with your signing secret and compare it to the v1 value_ Reject any request that does not match, or whose timestamp is more than 5 minutes old, so you only act on fresh payloads that truly came from Mercateer_ (Our SDK’s verify helper does all of this for you_)

3

Yeniden denemeleri idempotent şekilde işleyin

Gönderimi onaylamak için hızlıca 2xx yanıt verin. Başarısız gönderimler geri çekilmeli olarak yeniden denendiği için işleyicinizi olay kimliğine göre anahtarlayın; böylece yinelenenleri yok sayar ve her olayı yalnızca bir kez işlersiniz.

Sıkça Sorulan Sorular

Tüm araç setinizle uyumlu çalışır

Mercateer, zaten kullandığınız araçlarla aynı protokolleri kullanır.

Mercateer’ı Webhooks ile birlikte çalıştırın

Ücretsiz başlayın ve ön ofisinizi dakikalar içinde bağlayın.

Kredi kartı gerekmez