ตัวแปรที่ใช้ได้ในเวิร์กโฟลว์

ในการดำเนินการของเวิร์กโฟลว์ ส่วนที่เขียนเป็น {{ชื่อตัวแปร}} จะถูกแทนที่ด้วยค่าจริงของเพื่อนแต่ละคนเมื่อทำงาน บทความนี้อธิบายรายการตัวแปรที่ใช้ได้ ตำแหน่งที่ป้อนได้ และความแตกต่างจากตัวแปรของการส่งข้อความและข้อความส่งอัตโนมัติ

วิธีการทำงานของตัวแปร

ตัวแปรเขียนโดยครอบชื่อด้วยวงเล็บปีกกาคู่ {{ }} ช่องกรอกที่รองรับมีปุ่ม "แทรกตัวแปร" ให้เปิดรายการมาเลือกได้ และป้อนเองก็ได้เช่นกัน ปุ่ม "อีโมจิ" และ "อีโมจิ LINE" ข้าง ๆ ใช้แทรกอีโมจิได้ (อีโมจิ LINE ใช้ได้ในข้อความของการส่งข้อความ และข้อความคำถามแบบป้อนข้อมูลอิสระหรือตอบกลับด่วน)

ตัวอย่างเช่น เมื่อเขียนในเนื้อหาข้อความดังนี้ ระบบจะแทนที่ด้วยชื่อที่แสดงของเพื่อนเมื่อส่ง

สวัสดีคุณ {{line.displayName}}!

• มีหรือไม่มีช่องว่างหน้าหลังภายในวงเล็บก็ทำงานได้ ({{ line.displayName }} ก็ใช้ได้)
• ชื่อตัวแปรที่ไม่รองรับ หรือตัวแปรที่หาค่าไม่พบ จะไม่สามารถแทนที่ได้ (ยกเว้นเฉพาะตัวแปรคุณสมบัติที่มีชื่อบริการนำหน้า เช่น HubSpot ที่จะกลายเป็นค่าว่าง) หากในเนื้อหายังมีตัวแปรที่แทนที่ไม่ได้ค้างอยู่ ข้อความนั้นจะไม่ถูกส่ง
• หากเพิ่ม or 'ข้อความสำรอง' ต่อท้ายตัวแปร เมื่อหาค่าไม่พบจะแทรกข้อความสำรองแทน (ตัวอย่าง: {{line.displayName or 'คุณลูกค้า'}})
• การแทนที่เกิดขึ้นเมื่อเวิร์กโฟลว์ทำงาน เมื่อทดสอบ โปรดตรวจสอบการทำงานด้วยเพื่อนจริง

ข้อความสำรองเมื่อไม่มีค่า (ไวยากรณ์ or)

หากเพิ่ม or 'ข้อความสำรอง' ต่อท้ายตัวแปร เพื่อนที่ไม่มีค่าจะได้รับข้อความสำรองแทน ทำให้ข้อความอ่านเป็นธรรมชาติแม้ยังไม่ได้ตั้งค่าชื่อหรือคุณสมบัติ

สวัสดีคุณ {{line.displayName or 'ลูกค้า'}}!

ในตัวอย่างนี้ เพื่อนที่มีชื่อที่แสดงจะได้รับข้อความพร้อมชื่อจริง เช่น"สวัสดีคุณทาโร่!"ส่วนเพื่อนที่ไม่มีชื่อจะได้รับ"สวัสดีคุณลูกค้า!"

• ใส่ช่องว่างหน้าและหลัง or ตัวพิมพ์ใหญ่ OR ก็ใช้ได้
• ครอบข้อความสำรองด้วยเครื่องหมายคำพูด (' หรือ ") เครื่องหมายคำพูดแบบเต็มความกว้างจากแป้นพิมพ์ภาษาญี่ปุ่นก็ใช้ได้
• ใช้ได้กับตัวแปรคุณสมบัติที่มีชื่อบริการนำหน้าด้วย เช่น {{hubspot.… or 'ไม่มี'}}
• หากปล่อยข้อความสำรองว่างเป็น or '' เมื่อไม่มีค่าจะไม่แสดงอะไรเลย
• ตัวเลข 0 ถือว่ามีค่า จึงไม่ถูกแทนที่ด้วยข้อความสำรอง
• ตัวแปรของการส่งข้อความและข้อความส่งอัตโนมัติ (เช่น {{display_name or 'ลูกค้า'}}) ก็ใช้การเขียนแบบเดียวกันได้

การดำเนินการและช่องกรอกที่ใช้ตัวแปรได้

ตัวแปรใช้ได้ในช่องกรอกของการดำเนินการต่อไปนี้ ส่วนช่องกรอกอื่นนอกจากนี้จะไม่มีการแทนที่

ในตำแหน่งต่อไปนี้ใช้ตัวแปรไม่ได้

• ค่าเปรียบเทียบของเงื่อนไขแยกสาขา (เขียนตัวแปรในค่าของเงื่อนไขคุณสมบัติไม่ได้)
• การตั้งค่าของ แท็ก, หน่วงเวลา, อัปเดตริชเมนู และ ลงทะเบียนเวิร์กโฟลว์ HubSpot
• เนื้อหาของข้อความที่เลือกไว้ในการดำเนินการส่งอัตโนมัติหรือส่งข้อความแจ้งเตือน LINE (ในเนื้อหาของข้อความส่งอัตโนมัติ ใช้ได้เฉพาะตัวแปรของชื่อที่แสดงและคุณสมบัติที่เชื่อมต่อเท่านั้น หากต้องการแทรกคำตอบของคำถามหรือวันที่ ให้ใช้ข้อความของการดำเนินการส่งข้อความ)

ตัวแปรข้อมูลพื้นฐานของเพื่อน

ข้อมูลโปรไฟล์ LINE ของเพื่อนสามารถแทรกได้ทุกเมื่อ ไม่ว่าจะเป็นทริกเกอร์ประเภทใด

ช่องทางที่เพื่อนเข้ามา (เพื่อนมาจากที่ใด) ก็แทรกเป็นตัวแปรได้เช่นกัน "ครั้งแรก" คือช่องทางที่ถูกเพิ่มเพื่อนเป็นครั้งแรก ส่วน "ล่าสุด" คือช่องทางที่มีการสแกน QR โค้ดหรือเชื่อมโยงครั้งล่าสุด

สำหรับเพื่อนที่ไม่มีการบันทึกช่องทางที่เข้ามา ตัวแปรเหล่านี้จะถูกแทรกเป็นค่าว่าง เงื่อนไขแบบแยกสาขา (โปรไฟล์ LINE) ก็ใช้รายการเดียวกันนี้เป็นเงื่อนไขได้

เพื่อความเข้ากันได้กับเวิร์กโฟลว์ที่ย้ายมาจากผลิตภัณฑ์เดิม {{lha_line_user_id}} ก็จะถูกแทนที่ด้วย ID ผู้ใช้ LINE เช่นกัน

ตัวแปรของข้อความที่รับและการแตะปุ่ม

สามารถแทรกเนื้อหาของข้อความหรือการแตะปุ่มที่เป็นจุดเริ่มของทริกเกอร์ได้ เนื่องจากค่า ณ ตอนที่ทริกเกอร์ทำงานจะถูกเก็บไว้จนจบโฟลว์ จึงใช้ได้แม้ในการดำเนินการหลังจากมีหน่วงเวลาหรือคำถามคั่นอยู่

ตัวแปรคำตอบของคำถาม

{{answers.lastAnswer}} จะถูกแทนที่ด้วยเนื้อหาที่เพื่อนตอบในการดำเนินการคำถามก่อนหน้า ใช้สำหรับการทวนคำตอบ หรือการแนะนำที่ใช้คำตอบนั้นได้

ตัวอย่างเช่น เมื่อวางการดำเนินการส่งข้อความไว้ถัดจากคำถามแบบเลือกวันที่ แล้วตั้งเนื้อหาดังนี้ จะทวนวันที่ที่เลือกได้

{{answers.lastAnswer}} ใช่ไหมคะ รับทราบค่ะ!

ตัวแปรวันที่และเวลา

สามารถแทรกวันที่หรือเวลา ณ ตอนที่การดำเนินการทำงานได้ ใช้สำหรับการฝังวันที่ลงในการแจ้งเตือนหรือข้อความทักทายได้

วันที่และเวลาจะคำนวณตามโซนเวลาที่ตั้งไว้ในเวิร์กสเปซ (หากไม่ได้ตั้งค่า จะใช้เวลาญี่ปุ่น)

ตัวแปรคุณสมบัติของบริการที่เชื่อมต่อ

หากเชื่อมต่อกับ HubSpot, Klaviyo หรือ Shopify คุณสามารถระบุชื่อภายในของคุณสมบัติเพื่อแทรกค่าที่ซิงค์แล้วได้ ค่าที่แทรกได้จำกัดเฉพาะคุณสมบัติที่เลือกเป็นเป้าหมายการซิงค์ในการตั้งค่าการเชื่อมต่อของแต่ละบริการเท่านั้น

พฤติกรรมเมื่อหาค่าไม่พบจะต่างกันตามรูปแบบการเขียน

• แบบมีชื่อบริการนำหน้า (เช่น {{hubspot.…}}): หากเพื่อนยังไม่ได้เชื่อมโยง หรือยังไม่ได้ตั้งค่า จะถูกแทนที่ด้วยค่าว่าง
• แบบไม่มีชื่อบริการ ({{…}}): หากไม่มีคุณสมบัติที่ตรงกันในบริการใดเลย จะคงอยู่เป็นข้อความตามเดิม
• ทั้งสองแบบ หากระบุข้อความสำรองด้วย or เช่น {{hubspot.firstname or 'คุณลูกค้า'}} เมื่อยังไม่ได้เชื่อมโยงหรือยังไม่ได้ตั้งค่า จะแทรกข้อความสำรองแทน

ตัวแปรเฉพาะของทริกเกอร์

สามารถแทรกข้อมูลเฉพาะของทริกเกอร์แต่ละประเภทได้ในรูปแบบ {{trigger.ชื่อคีย์}} คีย์หลักมีดังนี้

ทริกเกอร์เพิ่มเพื่อนและบล็อกไม่มีตัวแปรเฉพาะของทริกเกอร์ หากต้องการแทรกช่องทางหรือหน้าที่เริ่มการเพิ่มเพื่อน ให้ใช้ตัวแปรช่องทางที่เข้ามาของเพื่อน ได้แก่ {{line.firstSourceType}}, {{line.firstSourceName}}, {{line.firstSourceCategory}} และ {{line.firstSourcePageUrl}}

การอ้างอิงข้อมูลสินค้า

ในทริกเกอร์ที่เชื่อมต่อ Shopify (ตะกร้าสินค้าที่ถูกทิ้ง, ซื้อสำเร็จ, จัดส่งแล้ว, สินค้าเติมเข้า, แจ้งเตือนการเรียกดู) และทริกเกอร์สินค้าเติมเข้า (Amp) ของการเชื่อมต่อ Amp Back in Stock สามารถอ้างอิงรายการสินค้าเป้าหมายพร้อมหมายเลขได้ โดยหมายเลข 0 คือสินค้าลำดับแรก

สำหรับสินค้าลำดับที่สองเป็นต้นไป ให้อ้างอิงโดยเปลี่ยนหมายเลข เช่น {{trigger.products.1.title}} หากไม่มีสินค้าในหมายเลขที่ระบุ จะคงอยู่เป็นข้อความตามเดิม

ความแตกต่างจากตัวแปรของการส่งข้อความและข้อความส่งอัตโนมัติ

ในเนื้อหาของการส่งข้อความและข้อความส่งอัตโนมัติก็ใช้ตัวแปรได้ แต่เป็นคนละประเภทกับตัวแปรของเวิร์กโฟลว์ แม้รูปแบบจะเป็นวงเล็บปีกกาคู่เหมือนกัน แต่ชื่อตัวแปรที่ใช้ได้ต่างกัน

ในเนื้อหาของการส่งข้อความและข้อความส่งอัตโนมัติ ใช้ได้เฉพาะตัวแปรของโปรไฟล์เพื่อนและคุณสมบัติที่เชื่อมต่อ

ความแตกต่างที่ควรจำมี 2 ข้อดังนี้

• ชื่อตัวแปรของชื่อที่แสดงต่างกัน ในการดำเนินการของเวิร์กโฟลว์คือ {{line.displayName}} ส่วนการส่งข้อความและข้อความส่งอัตโนมัติคือ {{display_name}} (ข้อยกเว้นคือข้อความคำถามของการดำเนินการคำถาม ซึ่งเขียนได้ทั้งสองแบบ)
• ตัวแปรของเวิร์กโฟลว์อย่าง {{answers.lastAnswer}}, {{trigger.…}}, {{date.…}} จะไม่ถูกแทนที่ในเนื้อหาของข้อความส่งอัตโนมัติ แม้จะส่งข้อความส่งอัตโนมัติจากเวิร์กโฟลว์ก็เช่นเดียวกัน

ตัวแปรของการส่งข้อความและข้อความส่งอัตโนมัติ นอกจากข้อความตัวอักษรแล้ว ยังใช้ในเนื้อหาของข้อความ Flex และข้อความประเภทการ์ดได้ด้วย สำหรับเพื่อนที่ยังไม่ได้ตั้งค่า จะแสดงเป็น"--"จึงควรระบุข้อความสำรองด้วย or เช่น {{display_name or 'ลูกค้า'}} หรือใช้คุณสมบัติที่ทุกคนมีค่า ตัวแปรเดียวกันยังใช้ใน "ค่า" ของเงื่อนไขการกรองของฟีดเนื้อหาได้ด้วย ฟีดจะเลือกสินค้าใหม่ตามเพื่อนแต่ละคนทุกครั้งที่ส่ง

เมื่อการแทนที่ไม่ทำงาน

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

• การสะกดชื่อตัวแปร: ตรวจสอบว่าตรงกับรายการหรือไม่ รวมถึงตัวพิมพ์ใหญ่และตัวพิมพ์เล็ก วงเล็บต้องเป็นปีกกาคู่ {{ }}
• การเขียนไวยากรณ์ or: ครอบข้อความสำรองด้วยเครื่องหมายคำพูด และใส่ช่องว่างหน้าหลัง or เช่น {{line.displayName or 'ลูกค้า'}} หากไม่มีเครื่องหมายคำพูด หรือใช้ or มากกว่า 1 ครั้งในตัวแปรเดียว จะไม่ถูกแทนที่
• ตำแหน่งที่ป้อน: ตัวแปรใช้ได้เฉพาะในช่องกรอกที่รองรับเท่านั้น ในค่าเปรียบเทียบของเงื่อนไขแยกสาขาหรือเนื้อหาของข้อความส่งอัตโนมัติ ตัวแปรของเวิร์กโฟลว์จะไม่ถูกแทนที่
• การใช้ร่วมกับทริกเกอร์: ค่าจะเข้าเฉพาะเมื่อทำงานด้วยทริกเกอร์ที่รองรับเท่านั้น เช่น {{message.text}} ใช้กับรับข้อความ และ {{trigger.params.date}} ใช้กับการแตะปุ่มเลือกวันเวลา
• การตั้งค่าซิงค์ของคุณสมบัติ: คุณสมบัติของบริการที่เชื่อมต่อ แทรกได้เฉพาะที่เลือกเป็นเป้าหมายการซิงค์เท่านั้น โปรดตรวจสอบคุณสมบัติที่ซิงค์ในการตั้งค่าการเชื่อมต่อ
• สถานะการเชื่อมโยงของเพื่อน: หากเพื่อนยังไม่ได้เชื่อมโยง (เชื่อมโยง ID) กับผู้ติดต่อ HubSpot เป็นต้น คุณสมบัติของบริการนั้นจะเป็นค่าว่าง