แก้ไขปัญหา X Bot: รายงาน, ตัวกรอง, ตารางเวลา, การเรียกเก็บเงิน

ดัชนีรวมของทุกเส้นทาง "มีบางอย่างดูผิดปกติ ทำยังไงต่อ" ตารางในหน้าการติดตั้ง / เมนู setup / ฝ่ายสนับสนุนก็อยู่ที่นี่ด้วย เพื่อให้ค้นหาได้จากหน้าเดียวแทนที่จะเป็นสามหน้า

เริ่มที่นี่: เปิด /setup → ℹ️ About ในกลุ่มของคุณ สี่บรรทัดในหน้าจอนั้น (chat ID, แผน, ตารางเวลา, ชื่อโปรเจกต์) คือสิ่งที่ฝ่ายสนับสนุนต้องการเพื่อวินิจฉัย คัดลอกไว้ก่อนทำอย่างอื่น

ขั้นตอนการวินิจฉัยด้วยตนเอง

ไล่ตามคำถามเหล่านี้ตามลำดับ ปัญหาส่วนใหญ่แก้ไขได้ที่การตรวจสอบสองข้อแรก

1.  บอทตอบสนองต่อ /setup เลยไหม?
    ├─ ไม่  → บอทถูกเตะหรือลดขั้นจากแอดมิน → เลื่อนขั้นใหม่แล้วลองอีกครั้ง
    └─ ใช่ → ไปต่อ

2.  /setup → 📊 Reports → ⚡ Generate report now สร้างโพสต์
    ภายใน 3 นาทีไหม?
    ├─ ไม่มี DM ไม่มีโพสต์            → ดูตารางใน §"รายงานไม่มา"
    ├─ DM "no posts found"           → ดู §"ตัวกรอง / ไม่มีโพสต์"
    ├─ DM "credit exhausted"         → ดู §"การเรียกเก็บเงินและเครดิต"
    ├─ โพสต์มาแล้วแต่แสดงผลผิด        → ดู §"คุณภาพการแสดงผล"
    └─ โพสต์มาถูกต้อง                → คุณโอเค

3.  รายงานตามตารางเวลามาตรงเวลาไหม?
    ├─ ไม่  → ดู §"ตารางเวลาไม่ทำงาน"
    └─ ใช่ → ทุกอย่างเรียบร้อย

4.  ปัญหา X Posts Auto-relay?
    └─ ดู §"X Posts Auto-relay"

หากไม่มีตารางไหนด้านล่างช่วยแก้ปัญหาได้ เลื่อนไปที่ การยกระดับ

รายงานไม่มา

อาการ	สาเหตุที่เป็นไปได้	วิธีแก้
บอทเคยทำงานปกติแล้วเงียบไปทันที	บอทถูกลดขั้นจากแอดมิน / ถูกเตะออกอย่างเงียบ ๆ	Telegram → แอดมินกลุ่ม → เลื่อนขั้นใหม่ หากยังเงียบ ติดต่อฝ่ายสนับสนุน — อาจเกิดการปิดใช้งานอัตโนมัติจาก chat-gone
Generate now แบบแมนนวลไม่สร้างอะไรเลย	บอทเป็นแอดมินแต่เครดิตเป็นศูนย์	/setup → 💳 Buy Credits หาก FREE "100/100 used" — รอรีเซ็ตรายเดือน (วันที่ 1 ของเดือน UTC) หาก PRO·credits ที่ REMAINING=0 — แชทถูกลดระดับเป็น FREE แล้ว /setup → 💳 → 💰 Buy เพื่อเติมยอด
Generate now แบบแมนนวล: DM "no posts found"	ตัวกรองแคบเกินไปหรือไม่มีโพสต์ในช่วงเวลา	/setup → 🎯 Filters ตรวจสอบ X API query ตัวจริงว่ามีการพิมพ์ผิดหรือไม่ ลองขยายหรือยกเลิกช่วงเวลา
ภาพแสดงผลแต่ข้อความว่างเปล่า	คำอธิบายจาก AI หมดเวลา	รันใหม่ เป็นเหตุการณ์ชั่วคราว หากเกิดต่อเนื่อง ติดต่อฝ่ายสนับสนุน
ภาพไม่แสดงผลเลย	ปัญหาการแสดงผลชั่วคราว	รันใหม่ หากล้มเหลวซ้ำ ๆ สำหรับแชทเดียว ติดต่อฝ่ายสนับสนุนพร้อม chat ID
ข้อผิดพลาด "Unauthorized" / "Forbidden" ใน DM แอดมิน	ปัญหาโทเค็น X API (ฝั่งผู้ให้บริการ)	ติดต่อฝ่ายสนับสนุน ไม่มีอะไรที่ผู้ใช้แก้ไขได้

ตัวกรอง / ไม่มีโพสต์

อาการ	สาเหตุที่เป็นไปได้	วิธีแก้
รายงานแสดง "0 posts" ทุกที่	ตัวกรองไม่ตรงกับอะไรเลยในช่วงเวลาที่ตั้งไว้	ขั้นที่ 1: /setup → 🎯 Filters — ยืนยัน query ขั้นที่ 2: /setup → 📊 Reports → 🗑 Clear period (24 ชม. หมุนเวียนยืดหยุ่นกว่า) ขั้นที่ 3: ขยายตัวกรอง (เพิ่ม cashtag สำรอง, ลดกลุ่มคำสำคัญที่เข้มงวด)
ลีดเดอร์บอร์ดแสดงผู้ใช้ที่ฉันไม่ได้เพิ่มในตัวกรอง	ตัวกรองเป็นแบบบวกเพิ่ม — ใครก็ตามที่ทวีต cashtag/คำสำคัญที่ติดตามจะถูกนับ	หากต้องการทั้งบัญชี และ cashtag ใช้ /set_x_filtering name from:@x cashtags:$Y (ตัวกรองที่ตั้งชื่อ, AND-ของ-หมวดหมู่)
ผู้ใช้คนเดียวกันสแปมลีดเดอร์บอร์ด	บอททำคะแนนทุกโพสต์อย่างถูกต้องตามจริง	/setup → 🎯 Filters → 🙈 Ignore → ➕ Add @spammer — จะถูกตัดออกจากผลลัพธ์หลังการดึงข้อมูล
Cashtag ที่มีอักขระแปลก ๆ ไม่ตรงกัน	X API ปรับตัวพิมพ์ใหญ่เล็กให้เป็นมาตรฐาน; ช่องว่างหน้า/หลังมีผล	เพิ่มใหม่ผ่าน /setup → 🎯 Filters → 💵 Cashtags → ➕ Add → ไม่ต้องใส่ $ ไม่มีช่องว่าง
Cashtag ที่ขึ้นต้นด้วยตัวเลข (เช่น $1INCH) ไม่ถูกติดตาม	พฤติกรรมการค้นหาของ X API กับตัวเลขนำหน้าอาจไม่แน่นอน	ใช้เป็นคำสำคัญแทน cashtag: "$1INCH" ใน 🔍 Keywords พร้อมเครื่องหมายคำพูด
การเลือก "Best Tweet" ดูผิดปกติ	การขจัดความซ้ำซ้อนของ AI เพิ่งเลือกทวีตที่คล้ายกัน	รอหนึ่งรอบ หากยังดูผิดปกติต่อเนื่อง แจ้งปัญหา — พรอมป์ปรับได้

ตารางเวลาไม่ทำงาน

อาการ	สาเหตุที่เป็นไปได้	วิธีแก้
ตารางเวลา "ถูกปฏิเสธ" ด้วย FREQUENCY_ERROR	Cron พยายามทำงานถี่กว่าทุก 12 ชม.	การตรวจสอบระยะห่างบังคับช่องว่าง ≥ 12 ชม. ข้อความข้อผิดพลาดระบุคู่ชั่วโมงที่ผิด เลือกช่องว่างที่กว้างขึ้น
ตั้งตารางเวลาแล้วแต่รายงานไม่มาตรงเวลา	Cron ตามตารางเวลาทำงานภายในประมาณ 1–2 นาทีของรอบ	รอ 5 นาทีหลังเวลาที่ตั้งไว้ก่อนสรุปว่าพลาด ความล่าช้าจากต้นทางเกิดขึ้นได้บ้างแต่จะแก้ไขเอง
Cron หลายรอบทำงานแค่ครั้งเดียว	รายการชั่วโมงเรียงไม่ถูกต้องหรือซ้ำ	cron(0 14,22 ? * * *) — ชั่วโมงเรียงจากน้อยไปมาก cron(0 22,14 ? * * *) จะถูกปฏิเสธ
ตารางเวลาบน staging ทำงานทุก 5 นาที แต่ prod ไม่	namespace RULE_NAME ต่างกัน	ยืนยันว่าคุณกำลังตรวจสอบสภาพแวดล้อมที่ถูกต้อง /setup → ℹ️ About แสดง env
โซนเวลาดูผิด	ตารางเวลาเป็น UTC โดยการออกแบบ	แปลงเวลาท้องถิ่นของคุณเป็น UTC ช่องกรอกตั้งตารางเวลารองรับชื่อโซนเวลาในบางกรณี — ตรวจสอบ docstring ของฟิลด์
X Posts Auto-relay ทำงานแต่รายงานไม่มา	Cron คนละตัวกัน	X Posts Auto-relay โพลทุก 5 นาทีต่อรีเลย์; รายงานใช้ cron ตารางเวลาหลักของแชท (โดยทั่วไปรายวัน) ทั้งสองเป็นอิสระต่อกัน

คุณภาพการแสดงผล

อาการ	สาเหตุที่เป็นไปได้	วิธีแก้
ชื่อ/สีที่กำหนดเองย้อนกลับข้ามคืน	แคชถูกล้าง การดึงข้อมูลถัดไปจะแสดงค่าใหม่	รอหนึ่งรอบรายงาน (~1 วัน) แคชการแสดงผลจะสร้างใหม่ในการดึงข้อมูลถัดไป
โลโก้เบลอ / ถูกครอบตัด	รูปต้นฉบับเล็กเกินไปหรือไม่เป็นสี่เหลี่ยมจัตุรัส	อัปโหลดใหม่ที่ ≥ 512×512 PNG อัตราส่วนสี่เหลี่ยมจัตุรัส /setup → 🎨 Customization → 🖼 Logo
ชื่อผู้ใช้ล้นในภาพลีดเดอร์บอร์ด	ชื่อที่แสดงยาวเกินไป	บอทตัดด้วยจุดไข่ปลา ไม่ต้องแก้ไขเว้นแต่เกิดต่อเนื่อง
ข้อความ best-tweet แสดง <a href> HTML ดิบ	parse mode ของ Telegram ไม่ตรงกัน	บั๊ก — กรุณาแจ้งปัญหาพร้อม URL ทวีต
ภาพรายงานต่างจากตัวอย่างใน Telegram	Telegram แคชไบต์ภาพแรกไว้ตาม URL; presigned URL มีการประทับเวลาทำให้แต่ละการดึงข้อมูลไม่ซ้ำกัน	ไม่ควรเกิดขึ้น หากเกิด ให้หมุนเวียนใหม่ผ่าน /recreate

X Posts Auto-relay

อาการ	สาเหตุที่เป็นไปได้	วิธีแก้
รีเลย์ส่งต่อเธรด 6 ทวีตในครั้งเดียว	การตอบกลับตัวเองข้าม exclude=replies ของ X API	/setup → 📡 X Posts Auto-relay → @account → ปิด ☐ Thread continuations บอทจะเก็บเฉพาะหัวเธรด
รีเลย์หยุดกลางวัน	ถึงเพดานรายวัน	หน้าจอต่อรีเลย์แสดง Today: N/N forwarded แตะ ✏️ Cap แล้วเพิ่ม รีเซ็ตเที่ยงคืน UTC
รีเลย์แสดง ⏸ Paused แต่ฉันไม่เคยหยุดมัน	หยุดอัตโนมัติเมื่อ Telegram แจ้ง chat-gone (ถูกเตะ / บล็อก / อัปเกรดแชท)	บอทหยุดตารางการโพลด้วย เพื่อกู้คืน: /setup → 📡 X Posts Auto-relay → @account → ▶️ Resume หากยังล้มเหลว แชทอาจเปลี่ยน ID (อัปเกรดเป็นซูเปอร์กรุ๊ป) — เพิ่มบอทใหม่ในแชทใหม่
การโพลครั้งแรกของรีเลย์ส่งต่อ 50 โพสต์	Bootstrap ไม่ควรทำแบบนี้ — ควรตั้งค่า LAST_POST_ID เท่านั้นโดยไม่ส่งต่อ	หากพบแบบนี้ กรุณาแจ้งปัญหา การแก้ไขที่เพิ่มใน 2026-04 ควรป้องกันสิ่งนี้
ทวีตอ้างอิงยังคงปรากฏแม้ปิดตัวเลือกแล้ว	X API ไม่มี exclude=quotes ฝั่งเซิร์ฟเวอร์ — บอทกรองฝั่งไคลเอนต์หลังการดึงข้อมูล	ตัวเลือกทำงานถูกต้อง แต่คุณยังจ่ายเครดิตสำหรับทวีตอ้างอิงที่ API ส่งคืนมา ประหยัดแค่ความสวยงามเท่านั้น
รีเลย์โพลต่อไปแม้แชทถูกลบแล้ว	รีเลย์เวอร์ชันเก่า — เพิ่มการล้างข้อมูลอัตโนมัติใน 2026-05	ขอให้ฝ่ายสนับสนุนบังคับหยุดรีเลย์ การติดตั้งใหม่จะล้างข้อมูลเองอัตโนมัติ

การเรียกเก็บเงินและเครดิต

อาการ	สาเหตุที่เป็นไปได้	วิธีแก้
ซื้อเครดิตแล้วยอดไม่เปลี่ยน	Webhook ของ Stripe ล่าช้า	รอ 5 นาที หากยังไม่ถูกต้อง ติดต่อฝ่ายสนับสนุนพร้อมใบเสร็จ Stripe + chat ID
จำนวนเครดิตสูงกว่าที่คาดไว้	รีเลย์โพลหลายครั้งในช่วงที่บัญชีที่ติดตามกระตือรือร้น	X Posts Auto-relay เรียกเก็บต่อโพสต์ แตะรีเลย์ → ตรวจสอบตัวนับ Today
ค่าใช้จ่ายส่วนเกินบน PRO·sub แม้ฉันโพสต์น้อย	การใช้งานอื่นในแชท (รีเลย์, รายงาน, การลองดึงข้อมูลซ้ำ)	/setup → 💳 Buy Credits → Usage this month เปรียบเทียบกับค่าใช้จ่ายที่วัดผล
แชท FREE ถูกเรียกเก็บเงิน	ไม่ควรเกิดขึ้น — FREE ไม่มีลูกค้า Stripe	แจ้งปัญหาทันที นี่เป็นบั๊กด้านการเรียกเก็บเงิน
การสมัครสมาชิกแสดง "canceled" แต่ฉันไม่ได้ยกเลิก	การยกเลิกของ Stripe อาจเกิดจากการต่ออายุบัตรอัตโนมัติล้มเหลว	ตรวจสอบอีเมลใบเสร็จ Stripe อัปเดตบัตรผ่าน /setup → 💳 → 🛠 Manage subscription (Stripe Customer Portal)
ยกเลิกการสมัครสมาชิกแล้ว แต่ยังเป็น PRO	Cancel-at-period-end: เป็น PRO จนสิ้นสุดรอบที่ชำระแล้ว	เป็นไปตามที่คาดไว้ จะกลับเป็น FREE เมื่อสิ้นสุดรอบเรียกเก็บเงินถัดไป

แดชบอร์ดสาธารณะ

อาการ	สาเหตุที่เป็นไปได้	วิธีแก้
โปรเจกต์ไม่อยู่บน xbot.ninja	ไม่ผ่านเกณฑ์ (คะแนนสูงสุด ≥ 300, โพสต์ ≥ 5, ผู้ใช้ที่กระตือรือร้น ≥ 2 ในเดือนนี้)	URL โดยตรงยังใช้งานได้ รอจนกว่าเมตริกจะถึงเกณฑ์ การตั้งค่า KOL อิสระถูกซ่อนจากโชว์เคสโดยตั้งใจ
โปรเจกต์อยู่บน xbot.ninja แต่โลโก้หายไป	ยังไม่เคยอัปโหลดโลโก้ หรืออัปโหลดล้มเหลว	/setup → 🎨 Customization → 🖼 Logo ส่งไฟล์ PNG สี่เหลี่ยมจัตุรัส
URL สาธารณะแสดงชื่อโปรเจกต์เก่า	รีเฟรชในรอบรายงานถัดไป	เปลี่ยนชื่อผ่าน /setup → 🎨 Customization → 🏷 Name สลัก URL + การ์ดจะรีเฟรชเมื่อรายงานถัดไปทำงาน
URL แสดง 404	แชทถูกลบถาวรแล้ว หรือยังไม่ผ่านเกณฑ์ทำให้โชว์เคสซ่อนไว้	ยืนยัน chat ID ผ่าน /setup → ℹ️ About ทดสอบ URL โดยตรง https://xbot.ninja/?chatId=<id>

การยกระดับ

เมื่อตารางข้างต้นไม่สามารถแก้ปัญหาได้ ติดต่อฝ่ายสนับสนุนด้วยเทมเพลตด้านล่าง:

Project:        <your project name>
Chat ID:        <from /setup → ℹ️ About>
Plan:           FREE / PRO·credits / PRO·sub
What's wrong:   <1–2 sentences>
What you tried: </setup → … → … steps you ran>
When it broke:  <approx UTC time>
Recent change:  <any new filter / schedule / payment in the last 24 h>

chat ID เพียงอย่างเดียวให้ข้อมูลวินิจฉัย 80% แก่ฝ่ายสนับสนุน — กรุณาแนบมาด้วยเสมอ

ช่องทางติดต่อ:

• ฝ่ายสนับสนุนทั่วไป: แบบฟอร์มติดต่อ bws.ninja
• GitHub issues (สำหรับผู้ที่ทราบว่าเป็นโอเพนซอร์ส): bws-api-telegram-xbot/issues
• Telegram โดยตรง: @BlockchainWebServices

เวลาตอบกลับตามระดับความรุนแรง:

• วิกฤต (บอทออฟไลน์ทั้งแพลตฟอร์ม, ปัญหาการเรียกเก็บเงิน): 1 ชั่วโมงทำการในช่วงเวลาทำการที่ทับซ้อนกันของ EU+US
• สูง (รายงานไม่ส่งสำหรับหนึ่งแชท): วันทำการเดียวกัน
• ปกติ (คำถามเกี่ยวกับฟีเจอร์, ความช่วยเหลือเรื่องการตั้งค่า): 1–2 วันทำการ

คำสั่งวินิจฉัยที่มีประโยชน์

คำสั่ง	แสดงอะไร
/setup → ℹ️ About	Chat ID, แผน, ตารางเวลา, โปรเจกต์ — คัดลอกใส่คำขอความช่วยเหลือโดยตรง
/setup → 🎯 Filters	สตริง X API query ตัวจริง
/setup → 💳 Buy Credits → 📊 Usage this month	ตัวนับ fetched_posts รายวัน + รายเดือน — ตรวจจับความล้มเหลวแบบเงียบ (พยายามสูง โพสต์เป็นศูนย์ → มักเป็น 402s)
/setup → 📡 X Posts Auto-relay → @account	สถานะต่อรีเลย์ (ทำงาน/หยุด, จำนวนส่งต่อวันนี้, เพดานรายวัน)
/get_chatid	Chat ID เท่านั้น (บรรทัดเดียวหาก About มากเกินไป)

ไปที่ไหนต่อ

• การติดตั้ง — ติดตั้งใหม่แบบสะอาดหากทุกอย่างล้มเหลว
• เมนู /setup — คู่มือเมนูฉบับเต็ม
• ราคา — การแก้ไขปัญหาฝั่งการเรียกเก็บเงิน
• ฝ่ายสนับสนุน — คำถามที่พบบ่อย + การติดต่อยกระดับ