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

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

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

ตัวแปรเขียนโดยครอบชื่อด้วยวงเล็บปีกกาคู่ {{ }} แล้วป้อนลงในช่องกรอกโดยตรง ไม่มีปุ่มแทรกเฉพาะ จึงต้องเพิ่มด้วยการป้อนเอง

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ทริกเกอร์เพิ่มเพื่อนและบล็อกไม่มีตัวแปรเฉพาะที่ใช้แทรกได้

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

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

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

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

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

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

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

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

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

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

หากตัวแปรแสดงเป็นข้อความตามเดิม โปรดตรวจสอบตามลำดับต่อไปนี้

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