Mercateer
สำหรับนักพัฒนา

รับเหตุการณ์หน้าร้านของ Mercateer ผ่านเว็บฮุก

สมัครรับเหตุการณ์จาก Mercateer ที่ endpoint แล้วรับเพย์โหลดที่ถูกเซ็นทันทีเมื่อสายโทรจบ ลีดเข้ามา หรือมีการจองงาน ลงทะเบียนและจัดการ endpoint ผ่าน API หรือแดชบอร์ด และตรวจสอบทุกการส่งด้วย HMAC

Webhooks คืออะไร?

เว็บฮุกจะผลักดันเหตุการณ์หน้าร้านของ Mercateer ไปยัง URL ที่คุณควบคุมแบบเรียลไทม์ ทำให้ระบบของคุณสามารถตอบสนองได้ทันทีโดยไม่ต้องสอบถาม API ซ้ำๆ การส่งแต่ละครั้งเป็นเพย์โหลด JSON ที่ถูกเซ็นด้วย HMAC คุณสามารถลงทะเบียนและจัดการ endpoint ผ่าน API หรือแดชบอร์ด และหากการส่งล้มเหลว ระบบจะลองส่งซ้ำโดยเว้นระยะห่าง

สิ่งที่คุณทำได้กับ Webhooks

จับลีดใหม่ได้และสร้างรายชื่อผู้ติดต่อแล้ว
IntegrationPages.Conversation started, closed, or handoff requested
IntegrationPages.Call completed
จองนัดหมายแล้วและเลื่อนนัดหมายแล้ว
IntegrationPages.Quote accepted
เพย์โหลดที่ถูกเซ็นด้วย HMAC ซึ่งคุณตรวจสอบเมื่อได้รับ
ลงทะเบียนและจัดการ endpoint ผ่าน API หรือแดชบอร์ด

ติดตั้งภายในไม่กี่นาที

1

สร้าง endpoint

ลงทะเบียน URL ของคุณและเลือกเหตุการณ์ที่ต้องการสมัครรับ ผ่าน API หรือที่ Settings > Developer Mercateer จะส่ง signing secret สำหรับ endpoint นั้นให้ การเข้าถึง API รวมอยู่ในแผน Crew และ Fleet

2

ตรวจสอบลายเซ็น

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

จัดการการลองส่งซ้ำแบบ idempotent

ตอบกลับด้วยรหัส 2xx อย่างรวดเร็วเพื่อยืนยันการได้รับ หากการส่งล้มเหลว ระบบจะลองส่งซ้ำโดยเว้นระยะห่าง ดังนั้นให้ใช้ event ID เป็นคีย์ในแฮนเดลอร์ของคุณ เพื่อละเว้นข้อมูลซ้ำและประมวลผลแต่ละเหตุการณ์เพียงครั้งเดียว

คำถามที่พบบ่อย

ทำงานร่วมกับชุดเครื่องมือทั้งหมดของคุณ

Mercateer ใช้โปรโตคอลเดียวกันกับเครื่องมือที่คุณใช้อยู่แล้ว

เริ่มใช้งาน Mercateer กับ Webhooks

เริ่มใช้งานฟรีและเชื่อมแผนกหน้าบ้านของคุณภายในไม่กี่นาที

ไม่ต้องใช้บัตรเครดิต