# Webhooks

goodcryptoX ช่วยให้คุณทำงานเทรดแบบอัตโนมัติผ่าน TradingView webhooks — กลไกทรงพลังสำหรับสั่งออเดอร์และการทำงานของบอทโดยตรงจากสัญญาณของคุณ

แตกต่างจากบางการใช้งานที่ปฏิบัติต่อ webhook เสมือนเป็น API ที่เขียนโปรแกรมได้ (ซึ่งคุณส่งคำสั่งแบบมีพารามิเตอร์เช่น "ซื้อ 3 BTC") goodcryptoX ขณะนี้รองรับโมเดลแบบทริกเกอร์เท่านั้น โดยแต่ละ webhook จะเพียงแค่เปิดใช้งานการกระทำที่กำหนดไว้ล่วงหน้าบนออเดอร์หรือบอทเฉพาะ — ไม่มีการตีความพารามิเตอร์หรือคำสั่งใด ๆ

ในอนาคตอันใกล้ เราจะเปิดตัว [บอทกลยุทธ์ TradingView](https://docs.goodcrypto.app/goodcryptox-th/perp-dexs-1/upcoming-functionality/tradingview) ที่รองรับคำสั่งกลยุทธ์แบบเต็มผ่าน webhooks รวมถึงการเลือกสัญลักษณ์แบบไดนามิก ปริมาณ ประเภทออเดอร์ และตรรกะหลายสัญลักษณ์ — ทำหน้าที่เสมือนชั้น API โปรดติดตาม

> ตอนนี้ยอมรับ webhooks จากเซิร์ฟเวอร์ของ TradingView เท่านั้น — ไม่รองรับ IP กำหนดเองหรือแหล่งภายนอก\
> หากคุณต้องการใช้แหล่ง webhook แบบกำหนดเอง โปรดติดต่อเราได้ที่ <support@goodcrypto.app> เพื่อขอสิทธิ์เข้าถึง

### วิธีการทำงานของ webhooks ใน goodcryptoX

* ทุกออเดอร์หรือบอท **การกระทำ** มี URL ของ webhook เฉพาะของตัวเอง
* คุณต้องสร้างออเดอร์หรือบอทก่อนเพื่อรับ URL (พวกมันจะปรากฏใน **Webhooks** ของออเดอร์หรือบอทในส่วน **รายละเอียด**)
* การส่ง **ข้อความใด ๆ** ไปยัง URL นั้นจะทริกเกอร์การกระทำดังกล่าว

> URL ของ Webhook เป็นแบบตามการกระทำ ไม่ใช่ตามผู้ใช้ คุณต้องสร้างหนึ่ง webhook ต่อหนึ่งการกระทำ เช่น หนึ่งสำหรับเข้า หนึ่งสำหรับทำกำไร หนึ่งสำหรับตัดขาดทุน ฯลฯ สำหรับทุกบอทหรือออเดอร์

### การกระทำของออเดอร์และบอทที่รองรับ

หากคุณต้องการให้ออเดอร์หรือบอทของคุณถูก **ทริกเกอร์ด้วย webhook**, คุณต้องเลือก webhook เป็น **เงื่อนไขทริกเกอร์ระหว่างการตั้งค่า**. สิ่งนี้ใช้กับ:

* ออเดอร์ stop-market / stop-limit ทริกเกอร์
* การเปิดใช้งานออเดอร์ Trailing (เริ่ม trailing)
* ทริกเกอร์ทำกำไรและตัดขาดทุน&#x20;
* เงื่อนไขการเข้า DCA bot

<figure><img src="https://1416017980-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FOtmSJHlKDJLkbCquvUfC%2Fimage.png?alt=media&#x26;token=c152200c-d5ad-4d69-861d-7c66700cd569" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://1416017980-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2F278uiG55cCWY8A3XpJxm%2Fimage.png?alt=media&#x26;token=7d852fc3-0ef4-45ab-921d-eab0d2287e97" alt="" width="563"><figcaption></figcaption></figure>

หลังจากสร้างแล้ว คุณจะพบ URL ของ webhook ที่มีทั้งหมดใน **รายละเอียด** ของออเดอร์หรือบอทของคุณ:

<figure><img src="https://1416017980-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FKTTUr7eaKAlb7x0U818J%2Fimage.png?alt=media&#x26;token=6b2a978f-fd3c-48b0-b01a-40da32d44696" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://1416017980-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FNoneMggO61H3EFmkwTrP%2Fimage.png?alt=media&#x26;token=f6f48a58-1585-41e3-8778-b69fe9564902" alt="" width="563"><figcaption></figcaption></figure>

> **ยกเลิก** webhook — มีอยู่เสมอในทุกออเดอร์และบอท
>
> **ปิดสถานะ** webhook — มีอยู่เสมอในรายละเอียดของ DCA bot

สรุป:

| การกระทำ                    | รองรับหรือไม่? | หมายเหตุ                                              |
| --------------------------- | -------------- | ----------------------------------------------------- |
| ยกเลิกออเดอร์               | ✅              | แสดงในรายละเอียดเสมอ                                  |
| ทริกเกอร์ออเดอร์ Stop       | ✅              | ต้องเลือก webhook ตอนตั้งค่า                          |
| เปิดใช้งานออเดอร์ Trailing  | ✅              | เริ่ม trailing = webhook                              |
| ทริกเกอร์ทำกำไร / ตัดขาดทุน | ✅              | อาจใช้ webhook เป็นตัวทริกเกอร์ได้                    |
| DCA bot - เข้า              | ✅              | เข้า ซื้อ/ขาย ผ่าน webhook (ต้องตั้งค่าไว้ตอนตั้งค่า) |
| DCA bot - ออก               | ✅              | ปิดสถานะผ่าน webhook (มีอยู่เสมอ)                     |
| Grid bot - เข้า             | 🚫             | ยังไม่รองรับ                                          |

{% hint style="info" %}
**เป้าหมายทำกำไรหลายระดับด้วย webhooks**

หากคุณตั้งค่ากลุ่มทำกำไรโดยใช้ webhook เป็นวิธีทริกเกอร์ พวกมันจะใช้ URL ของ webhook เดียวกัน ทุกครั้งที่ webhook ถูกทริกเกอร์ ออเดอร์ TP ถัดไปในลำดับจะถูกดำเนินการทีละรายการ
{% endhint %}

### วิธีตั้งค่าแจ้งเตือนใน TradingView

เมื่อคุณได้สร้างออเดอร์หรือบอทใน goodcryptoX และคัดลอก URL ของ webhook สำหรับการกระทำที่เฉพาะเจาะจงแล้ว ต่อไปนี้คือวิธีเชื่อมโยงเข้ากับการแจ้งเตือนใน TradingView ของคุณ:

1. ไปที่กราฟของคุณใน TradingView
2. สร้างการแจ้งเตือนใหม่ตามกลยุทธ์ อินดิเคเตอร์ หรือเงื่อนไขของคุณ
3. ใน **การตั้งค่าการแจ้งเตือน**, เปิดใช้งานช่องทำเครื่องหมาย **“Webhook URL”**
4. วาง URL ของ webhook เฉพาะจากส่วน Webhooks ใน goodcryptoX
5. เว้น **ช่องข้อความ** ไว้ตามเดิม (ใส่อะไรก็ได้ — ตอนนี้ goodcryptoX จะเพิกเฉยต่อ payload)
6. บันทึกการแจ้งเตือน

### กลยุทธ์ซ้ำ (ผ่าน DCA bot)

ออเดอร์ที่ถูกทริกเกอร์ด้วย webhook (เช่น stop-market พร้อม TP และ SL) เป็น **การตั้งค่าแบบครั้งเดียว**. เมื่อออเดอร์ถูกดำเนินการและ TP หรือ SL ที่เชื่อมโยงทำงาน เทรดทั้งหมดก็เสร็จสิ้น หากคุณต้องการให้โครงสร้างนี้ **ทำซ้ำโดยอัตโนมัติ**, จะทำไม่ได้ด้วยออเดอร์ — แต่สามารถทำได้แล้วด้วยการใช้ DCA bot

เราจะเปิดตัว [บอทกลยุทธ์ TradingView](https://docs.goodcrypto.app/goodcryptox-th/perp-dexs-1/upcoming-functionality/tradingview) โดยเฉพาะในเร็ว ๆ นี้เพื่อรองรับการเทรดหลายการกระทำแบบวนซ้ำ แต่ในระหว่างนี้ DCA bot ให้วิธีที่ยืดหยุ่นสำหรับการทำซ้ำกลยุทธ์ที่ขับเคลื่อนด้วย webhook ของคุณ

#### โหมดวนลูปด้วย webhook ล้วน ๆ

วิธีตั้งค่าบอทที่เข้าโพซิชันด้วย webhook ออกด้วย webhook แล้วทำซ้ำ:

1. ตั้งค่า **เงื่อนไขการเข้า** = webhook
2. ตั้งค่า **ออเดอร์ถัวเฉลี่ย** = 0 (ปิดการถัวเฉลี่ย)
3. ปิดการใช้งานทั้ง **ทำ**-**กำไร** และ **ตัดขาดทุน**
4. เปิดใช้งาน **"ทำซ้ำเมื่อปิดสถานะ"**&#x20;

<figure><img src="https://1416017980-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FCquwy7JurEJkuO9rQeWn%2Fimage.png?alt=media&#x26;token=542f9526-7ecb-4033-8b1c-740aef270b51" alt="" width="375"><figcaption></figcaption></figure>

เมื่อบอทถูกเริ่มทำงาน คุณจะเห็น URL ของ webhook ต่อไปนี้ภายใต้ **รายละเอียด → Webhooks** ของบอท:

* **เข้าสู่ ซื้อ (Enter Buy)** — เปิดสถานะ Long
* **เข้าสู่ ขาย (Enter Sell)** — เปิดสถานะ Short
* **ปิดสถานะ** — ปิดสถานะที่เปิดอยู่ (long หรือ short)
* **ยกเลิก** — หยุดบอท

**ตรรกะการดำเนินการ**

* เมื่อบอทได้รับ **เข้าสู่ ซื้อ (Enter Buy)**, จะเปิดสถานะ long
* เมื่อได้รับ **เข้าสู่ ขาย (Enter Sell)**, จะเปิดสถานะ short
* บอทจะ **ตอบสนองต่อ webhook การเข้าแรกเท่านั้น** ที่ได้รับขณะว่าง
* ขณะมีสถานะเปิดอยู่:
  * สัญญาณเข้าเพิ่มเติมใด ๆ จะถูก **เพิกเฉย**
  * บอทจะไม่เพิ่มหรือกลับทิศทางสถานะปัจจุบันเมื่อได้รับสัญญาณเข้า
  * สัญญาณที่ยอมรับได้มีเพียง **ปิดสถานะ** หรือ TP/SL ที่ถูกทริกเกอร์ (ถ้าตั้งค่าไว้)
* เมื่อสถานะถูกปิด (ด้วยมือ โดย webhook หรือโดย SL/TP) บอทจะรีเซ็ตและรอสัญญาณ Entry webhook ถัดไป

ลูปนี้จะดำเนินต่อไปตราบใดที่บอทยังทำงานอยู่ ทำให้คุณสามารถทำซ้ำวงจร เข้า → ออก → รีเซ็ต ได้ไม่จำกัด

#### โหมด webhook ล้วน เทียบกับการตั้งค่าแบบไฮบริด

DCA bot รองรับหลายชั้นของการควบคุมที่สามารถผสมผสานเพื่อสร้างกลยุทธ์ที่ยืดหยุ่นได้:

* **การเข้า**: ผ่าน webhook, สัญญาณ หรือ asap
* **การออก**: ผ่าน webhook หรือ TP/SL แบบอิงราคาในตัว
* **การถัวเฉลี่ย**: เป็นตัวเลือก; สามารถปิดได้

คุณสามารถ:

* รันบอทผ่านสัญญาณ webhook ทั้งหมด (เข้าและออก)
* เพิ่ม TP/SL แบบอิงราคาเป็นแผนสำรอง แม้ว่าคุณจะใช้การออกด้วย webhook
* เพิ่มออเดอร์ถัวเฉลี่ยเพื่อการป้องกันเพิ่มเติม

สิ่งนี้ทำให้สามารถออกแบบได้ว่า:

* กลยุทธ์วนลูปอัตโนมัติเต็มรูปแบบ (webhook ล้วน)
* บอทขับเคลื่อนด้วยสัญญาณพร้อมการสำรองแบบแมนนวล
* การตั้งค่าแบบไฮบริดที่มีการออกหลายชั้น

### ตัวอย่างกลยุทธ์ webhook เชิงปฏิบัติ

#### ตัวอย่างที่ 1: ออเดอร์ครั้งเดียว + ทำกำไรหลายระดับ (เด้งจาก Bollinger Band)

**เป้าหมาย:** ซื้อเมื่อราคาทะลุเส้นล่างของ Bollinger Band ขายแบบทยอยเมื่อราคาขึ้น

**การตั้งค่าใน goodcryptoX**

* สร้างออเดอร์ stop-market โดยมีเงื่อนไขทริกเกอร์ = webhook
* เพิ่มเป้าหมายทำกำไรสามระดับ ทริกเกอร์ TP = webhook

<figure><img src="https://1416017980-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FU5f3sdUx8rAIkSpfuLd0%2Fimage.png?alt=media&#x26;token=2772d1dd-038b-435b-bcd6-1aad6f95575d" alt="" width="563"><figcaption></figcaption></figure>

**การตั้งค่าใน TradingView**

สร้างการแจ้งเตือนสี่รายการ:

1. ราคาทะลุเส้นล่าง → ส่งไปที่ **Trigger** ของออเดอร์หลัก (webhook URL)
2. ราคาไหลกลับเข้ามาในกรอบ → ส่งไปที่ **ทริกเกอร์ทำกำไร (Take Profit Trigger)** ของออเดอร์หลัก (webhook URL)
3. ราคาทะลุเส้นกลาง → ส่งไปที่ **ทริกเกอร์ทำกำไร (Take Profit Trigger)** ของออเดอร์หลัก (webhook URL)
4. ราคาทะลุเส้นบน → ส่งไปที่ **ทริกเกอร์ทำกำไร (Take Profit Trigger)** ของออเดอร์หลัก (webhook URL)

<figure><img src="https://1416017980-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrFKhEXxJL95YqC19XHlF%2Fuploads%2FW35WIYkwAwONvOjjPukZ%2Fimage.png?alt=media&#x26;token=8562ad00-e7fe-4d26-8a34-38eff5c05207" alt="" width="563"><figcaption></figcaption></figure>

ใน **การตั้งค่าการแจ้งเตือน**, เปิดใช้งานช่องทำเครื่องหมาย **“Webhook URL”**

วาง URL ของ webhook เฉพาะจากส่วน Webhooks ของ goodcryptoX เว้นช่อง Message ไว้ตามเดิม — ไม่ได้ใช้งาน

#### ตัวอย่างที่ 2: กลยุทธ์วนซ้ำด้วย DCA bot (Golden/Death Cross)

**เป้าหมาย:** เข้า long เมื่อเกิด Golden Cross เข้า short เมื่อเกิด Death Cross ออกด้วยกำไร 10% หรือเมื่อ RSI > 70 และวนซ้ำตลอดไป

**การตั้งค่าใน goodcryptoX**

สร้าง DCA bot

* เงื่อนไขการเข้า = webhook
* การถัวเฉลี่ย = ปิด (ตั้งค่าเป็น 0)
* ทำกำไร = 10%
* ตัดขาดทุน = ปิด
* เปิดใช้งาน: "ทำซ้ำเมื่อ TP"

**การตั้งค่าใน TradingView**

* สร้างการแจ้งเตือนสามรายการบนกราฟเดียวกัน:
  1. SMA50 ตัดขึ้นเหนือ SMA200 → ส่งไปที่ **เข้าสู่ ซื้อ (Enter Buy)** webhook
  2. SMA50 ตัดลงใต้ SMA200 → ส่งไปที่ **เข้าสู่ ขาย (Enter Sell)** webhook
  3. RSI > 70 → ส่งไปที่ **ปิดสถานะ** webhook

{% hint style="info" %}
DCA bot จะถือเพียงหนึ่งสถานะในแต่ละครั้ง ขณะอยู่ในสถานะ จะเพิกเฉยต่อ webhook การเข้าใหม่จนกว่าสถานะจะถูกปิด

หากคุณต้องการสามารถเข้า Long และ Short บนเครื่องมือเดียวกันแบบขนาน ให้สร้างบอทสองตัวแยกกัน และส่ง Enter Buy ไปตัวยหนึ่งและ Enter Sell ไปอีกตัวหนึ่ง
{% endhint %}

### สรุป

| แนวคิด            | คำอธิบาย                                                                   |
| ----------------- | -------------------------------------------------------------------------- |
| โมเดลทริกเกอร์    | แต่ละการกระทำมี URL ของ webhook ของตนเอง                                   |
| ขั้นตอนการตั้งค่า | สร้างออเดอร์ → คัดลอก URL ของ webhook → วางลงในการแจ้งเตือนของ TradingView |
| กลยุทธ์แบบวนซ้ำ   | ใช้ DCA bot พร้อมเปิดใช้การทำซ้ำ                                           |

### วิดีโอสอน

#### **แนะนำการเทรดด้วย webhook**

{% embed url="<https://youtu.be/JDkJFOwjjzk?si=m0GBGwTt6GTau-9X>" %}

#### **การใช้ DCA bot กับ webhooks**

{% embed url="<https://youtu.be/gHXB2S6qdXU?si=i9ZobjRsxFAe7zcJ>" %}

#### **การทำกำไรหลายระดับด้วย webhooks**

{% embed url="<https://youtu.be/xF-O7ZDoDtU?si=apfiF8uyTn-p4Vh4>" %}