รู้ทันทีที่มีคนส่งน้ำใจ แล้วให้ระบบทำงานต่อเอง
ภาษาคนทุกครั้งที่ทิปถูกยืนยัน Tipjai จะส่งข้อความสั้น ๆ ไปบอกบริการอย่าง Zapier แล้วคุณตั้งให้มันทำอะไรต่อก็ได้ เช่น จดลง Google Sheets หรือแจ้งเข้า Discord
ข้อจำกัดตอนนี้ปลายทางต้องเป็นลิงก์ของ Zapier, Make หรือ IFTTT เท่านั้น ตั้งได้ในหน้า เชื่อมต่อและแจ้งเตือน ของ Studio ที่การ์ด ส่งทิปต่อไปแอปอื่นอัตโนมัติ กด ตั้งค่า เพื่อเปิดช่องวางลิงก์
- จดทุกทิปลง Google Sheetsรับ webhook แล้วเพิ่มแถวใหม่ ชื่อ ยอด ข้อความ ครบในตาราง
- ขอบคุณในห้อง Discordส่งข้อความเข้าห้องทุกครั้งที่มีคนส่งน้ำใจ
- ไฟในห้องกระพริบต่อกับหลอดไฟอัจฉริยะ ให้ไฟวาบทุกครั้งที่ทิปเข้า
ต่อทิปเข้า Google Sheets อัตโนมัติ
ไม่ต้องเขียนโค้ด ใช้ Make หรือ Zapier ที่มีแพลนฟรี ถ้าแค่อยากได้ไฟล์ไว้ยื่นภาษี ปุ่มดาวน์โหลด CSV ในหน้า ทิป ของ Studio ง่ายกว่า
- 1สมัคร Make หรือ Zapier
- 2สร้าง scenario ใหม่ เลือก trigger Webhooks แล้ว Custom webhook คัดลอกลิงก์ที่ได้
- 3เปิดหน้า เชื่อมต่อและแจ้งเตือน ของ Studio กด ตั้งค่า ในการ์ด ส่งทิปต่อไปแอปอื่นอัตโนมัติ วางลิงก์นั้น แล้วกด บันทึก
- 4กด ส่งทดสอบ ปลายทางจะได้ event ที่มีฟิลด์ครบชุดเดียวกับทิปจริง เช่น supporter, amount และ message
- 5เพิ่ม action Google Sheets แบบ Add a Row แล้วลากแต่ละฟิลด์ลงคอลัมน์
- 6เปิด scenario ไว้ ทุกทิปจะลงชีตเอง
หนึ่งคำขอ แยกออกเป็นสามชั้น
ตัวอย่างนี้คำนวณลายเซ็นจริงด้วย secret ตัวอย่าง ลองเอาไปตรวจในกล่องด้านล่างได้
POST https://hooks.zapier.com/hooks/catch/… Content-Type: application/json; charset=utf-8 User-Agent: Tipjai-Webhook/1.0 Idempotency-Key: 8c2f4e1a-6b3d-4f7e-9a2c-1d5e8f0b3a47 X-Tipjai-Delivery: 8c2f4e1a-6b3d-4f7e-9a2c-1d5e8f0b3a47 X-Tipjai-Event: tip.confirmed X-Tipjai-Timestamp: 1790501464 X-Tipjai-Signature: v1=e8a89c93dfba1464…7ceba520
- ได้ id เดิมซ้ำ แปลว่าเป็นงานเดิมที่ส่งซ้ำ ข้ามได้เลย
- Timestamp เป็นเวลาแบบ Unix หน่วยวินาที คำนวณใหม่ทุกครั้งที่ส่ง รวมถึงตอนส่งซ้ำ
hmac_sha256( secret, "1790501464" + "." + body ดิบ ) → hex แล้วนำหน้าด้วย v1=
- เซ็นจาก body ดิบเท่านั้น ห้าม parse แล้วแปลงกลับเป็นข้อความก่อนตรวจ
{ "id": "8c2f4e1a-…-1d5e8f0b3a47",
"data": { "gift": { "id": "rose", "qty": 3, "name": "กุหลาบ" },
"amount": 30, "tip_id": "e7a1c3f5-…-9d1b3f5e7a2c",
"message": "สู้ ๆ นะครับ", "currency": "THB",
"supporter": "แฟนคลับหมายเลข 1", "verification": "verified" },
"event": "tip.confirmed",
"created_at": "2026-09-27T09:31:04.221+00:00",
"schema_version": 1 }- กุหลาบดอกละ ฿10 สามดอก ยอดจึงเป็น 30
ส่งยังไง และถ้าพลาดจะเกิดอะไร
- 1ทิปถูกยืนยัน
ตามการตั้งค่าของครีเอเตอร์ ระดับการยืนยันอยู่ในฟิลด์ verification
- 2เข้าคิวส่ง
งานถูกเก็บในคิวก่อน ไม่หายแม้ปลายทางล่มชั่วคราว
- 3ส่ง POST
รอคำตอบนานสุด 5 วินาที และไม่ตาม redirect
- 4ได้ 2xx คือสำเร็จ
ตอบ 200 ถึง 299 แปลว่ารับแล้ว จบงานนี้
- 5พลาดชั่วคราว ส่งซ้ำเอง
ได้ 5xx, 408, 409, 425, 429 หรือไม่ได้คำตอบใน 5 วินาที ระบบลองใหม่ด้วย id เดิม สูงสุด 10 ครั้งในเวลาประมาณ 2 ชั่วโมง ส่วน 4xx อื่นหยุดทันที
ปิด webhook หรือเปลี่ยนปลายทาง งานที่ยังค้างในคิวจะถูกยกเลิก ไม่ถูกส่งไปที่เดิมอีก
กด เปลี่ยน secret เมื่อไหร่ งานที่ค้างอยู่จะถูกเซ็นด้วย secret ใหม่ก่อนส่ง
งานที่ส่งไม่สำเร็จภายใน 7 วัน กด ส่งรายการค้างอีกครั้ง ในการ์ดเดียวกันได้ ระบบส่งไปที่ปลายทางและ secret ปัจจุบัน งานที่เก่ากว่า 1 วันจะลองส่งได้อีกครั้งเดียว
การ์ดเดียวกันสรุปการส่งเป็น ส่งสำเร็จ (delivered) รอส่ง/กำลังลองใหม่ (queued กับ retrying) และ ส่งไม่สำเร็จถาวร (dead-letter) ซึ่งเป็นสี่สถานะที่งานผ่าน คือ queued, retrying, delivered และ dead-letter
Paynoi ส่งเข้า Tipjai เพื่อยืนยันทิป
ถ้าเปิดยืนยันอัตโนมัติ (ของเสริม) เมื่อธนาคารของคุณยืนยันการรับเงิน Paynoi จะยิงเข้ามาที่ Webhook URL เฉพาะของคุณ Tipjai จะจับคู่กับทิปที่รอชำระ ยืนยัน และยิงการ์ดแจ้งเตือนให้อัตโนมัติ ฝั่งคุณไม่ต้องเขียนโค้ด เพียงวาง Webhook URL ในแดชบอร์ด Paynoi
POST https://tipjai.com/api/paynoi/<your-secret>
ตั้งค่าได้ใน Studio หน้า ช่องทางรับเงิน แถว ยืนยันอัตโนมัติ (Paynoi) Webhook URL ของคุณเป็นความลับเฉพาะตัว อย่าเปิดเผย
ระบบยืนยันด้วยการจับคู่กับทิปจริงที่รอชำระ และกันการส่งซ้ำ เงินยังเข้าบัญชีของคุณตรง ๆ เหมือนเดิม Tipjai ไม่ถือเงิน
มั่นใจว่ามาจาก Tipjai จริง
คัดลอก secret ได้จากการ์ดส่งทิปต่อไปแอปอื่นอัตโนมัติในหน้า เชื่อมต่อและแจ้งเตือน ของ Studio (กด เปลี่ยนการตั้งค่า ก่อน) ถ้าใช้ Zapier ให้เลือกตัวรับแบบ Catch Raw Hook เพื่อให้ได้ body ดิบ แล้วตรวจในขั้น Code by Zapier ด้วยโค้ดชุดเดียวกันนี้
import { createHmac, timingSafeEqual } from "node:crypto";
// rawBody คือข้อความดิบที่ได้รับ ยังไม่ผ่าน JSON.parse
export function verifyTipjai(rawBody, headers, secret) {
const ts = headers["x-tipjai-timestamp"];
const got = String(headers["x-tipjai-signature"] || "");
const want = "v1=" + createHmac("sha256", secret)
.update(`${ts}.${rawBody}`)
.digest("hex");
const fresh = Math.abs(Date.now() / 1000 - Number(ts)) < 300;
return fresh && got.length === want.length &&
timingSafeEqual(Buffer.from(got), Buffer.from(want));
}schema_version 1
| ฟิลด์ | ชนิด | คำอธิบาย |
|---|---|---|
id | uuid | รหัสของการส่งครั้งนี้ ค่าเดียวกับ Idempotency-Key |
event | string | tip.confirmed หรือ tip.test |
created_at | timestamp | เวลาที่ทิปถูกยืนยัน |
schema_version | number | ตอนนี้เป็น 1 |
data.tip_id | uuid | รหัสทิป ใน tip.test เป็น 00000000-0000-0000-0000-000000000000 |
data.supporter | string | ชื่อคนส่ง ถ้าเว้นว่างจะเป็น ผู้สนับสนุน |
data.amount | number | ยอดเงิน |
data.currency | string | สกุลเงิน ปกติเป็น THB |
data.message | string | ข้อความจากคนส่ง ไม่มีจะเป็นค่าว่าง |
data.verification | string | ระดับการยืนยัน เช่น verified หรือ creator_confirmed |
data.gift | object | null | id, name, qty เมื่อทิปมาพร้อมของขวัญ |
tip.confirmedส่งทุกครั้งที่ทิปถูกยืนยัน
tip.testกด ส่งทดสอบ จากการ์ดส่งทิปต่อไปแอปอื่นอัตโนมัติ ฟิลด์ครบเหมือนทิปจริง ยอดเป็น 0 verification เป็น test และ tip_id เป็น UUID ศูนย์ล้วน ซึ่งไม่ใช่รหัสของทิปใด
