การผสานรวม Webhook

จำเป็นต้องได้รับความช่วยเหลือจากนักพัฒนา

คุณจะต้องได้รับความช่วยเหลือจากทีมนักพัฒนาของคุณเพื่อตั้งค่าการผสานรวม โปรดแชร์คู่มือนี้กับพวกเขา

ภาพรวมการผสานรวม

การผสานรวมนี้ช่วยให้คุณสามารถตั้งค่า Webhook endpoint เพื่อรับข้อมูลแบบเรียลไทม์จาก Pushwoosh โดยเฉพาะ เหตุการณ์สถานะอีเมล เช่น Email Sent, Email Delivered, Email Bounced, Email Opened เป็นต้น

ประเภทของการผสานรวม

Source: ข้อมูลจะถูกส่งจาก Pushwoosh ไปยังระบบของคุณผ่าน webhook

อภิธานศัพท์

Webhook endpoint: URL ฝั่งเซิร์ฟเวอร์ที่รับคำขอ HTTP POST จาก Pushwoosh ไคลเอนต์สามารถระบุพอร์ตที่แน่นอนได้

• ตัวอย่างที่ไม่มีพอร์ต: https://clientdomainname.com/webhook_endpoint
• ตัวอย่างที่ระบุพอร์ต: https://clientdomainname.com:8081/webhook_endpoint

เอนทิตีที่ซิงโครไนซ์

เหตุการณ์สถานะอีเมล ที่ให้ข้อมูลเกี่ยวกับการโต้ตอบของผู้ใช้กับข้อความที่คุณส่ง

การตั้งค่าการผสานรวม

ในการตั้งค่าการผสานรวม:

1. ในบัญชี Pushwoosh ของคุณ ไปที่ Settings > 3rd Party Integrations และค้นหา Webhook Integration คลิก Configure

2. ในหน้าต่างที่เปิดขึ้นมา ให้ป้อน URL แบบเต็มของ webhook endpoint แล้วคลิก Apply

เมื่อกำหนดค่าสำเร็จแล้ว คุณจะเริ่มได้รับคำขอจาก Pushwoosh

วิธีตรวจสอบว่าการผสานรวมทำงานอยู่

เมื่อตั้งค่าการผสานรวมแล้ว คุณจะได้รับคำขอ HTTP POST จาก Pushwoosh ที่ webhook endpoint ที่ระบุ

เนื้อหาคำขอของ Webhook

Field name	Type	Required	คำอธิบาย	Example
event_name	string	Yes	ชื่อของเหตุการณ์	"Email Sent"
message_id	uint64	No	ID ที่ไม่ซ้ำกันของข้อความที่เกี่ยวข้องกับเหตุการณ์	200XXXX3258
message_code	string	Yes	รหัสของข้อความที่เกี่ยวข้องกับเหตุการณ์	"B780-XXXXXX3C-XXXX0375"
campaign_id	uint64	No	ID ที่ไม่ซ้ำกันของแคมเปญที่เกี่ยวข้องกับเหตุการณ์	96XXXX
platform	string	Yes	แพลตฟอร์มอุปกรณ์ที่เกี่ยวข้องกับเหตุการณ์ (เช่น iOS, Android, Email)	"Email"
application_code	string	Yes	รหัสของแอปพลิเคชันที่เกี่ยวข้องกับเหตุการณ์	"3XXXX-XXXX1"
hwid	string	Yes	ตัวระบุอุปกรณ์ (HWID) ที่เกี่ยวข้องกับเหตุการณ์	"example@gmail.com"
user_id	string	Yes	Pushwoosh User ID ที่เกี่ยวข้องกับเหตุการณ์	"15XXXX8"
payload	string	No	เนื้อหาที่เกี่ยวข้องกับข้อความขึ้นอยู่กับแพลตฟอร์ม สำหรับ Email events จะมี หัวเรื่องอีเมล สำหรับแพลตฟอร์มอื่น ๆ อาจมีเนื้อหาที่เกี่ยวข้องอื่น ๆ ที่เฉพาะเจาะจงกับเหตุการณ์ (เช่น เนื้อหาข้อความหรือหัวเรื่อง)	"Don't miss our summer sale!"
timestamp	int64	Yes	เวลาที่เกิดเหตุการณ์ในรูปแบบ UNIX timestamp	1723798222
journey_title	string	No	หัวเรื่องของ Journey ที่เกี่ยวข้องกับเหตุการณ์	"Summer sale"
journey_point_title	string	No	หัวเรื่องของจุดเฉพาะภายใน Journey ที่เกี่ยวข้องกับเหตุการณ์	"5_summer sale_new"

ตัวอย่างคำขอ

{
  "event_name": "Email Sent",
  "message_code": "B780-XXXXXX3C-XXXX0375",
  "campaign_id": 96XXXX,
  "platform": "Email",
  "payload": "Don't miss our summer sale!",
  "application_code": "3XXXX-XXXX1",
  "hwid": "example@gmail.com",
  "user_id": "15XXXX8",
  "timestamp": 1723798222,
  "journey_title": "Summer sale",
  "journey_point_title": "5_summer sale_promoemail"
}