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

1) เริ่มต้น: การยืนยันตัวตนด้วย API

ก่อนใช้งาน Walla API ต้องสร้าง API Key และตั้งค่าการยืนยันตัวตน

1.1 การสร้าง API Key

1. เข้าสู่ระบบ Walla Dashboard (app.walla.my)

2. ไปที่ การตั้งค่าทีม ที่ต้องการสร้าง API Key

3. ใน Team Settings > API สร้าง clientId / apiKey และเก็บไว้ในที่ปลอดภัย

1.2 ส่งคำขอยืนยันตัวตน

Walla API ใช้ Basic Authentication

• สร้างสตริง {clientId}:{apiKey} (เช่น myClientId:myApiKey)

• เข้ารหัสสตริงด้วย Base64

• ใส่ใน HTTP Header:

Authorization: Basic {โทเค็นที่เข้ารหัสด้วย Base64}

ตัวอย่าง cURL (Bash):

# 1. สร้างโทเค็น (macOS / Linux)
TOKEN=$(echo -n "YOUR_CLIENT_ID:YOUR_API_KEY" | base64)

# 2. ส่ง API Request
curl -X GET "https://walla-api.datalab.workers.dev/workspace/list" \
     -H "Authorization: Basic $TOKEN"

2) รายละเอียด API Endpoint

Base URL: https://walla-api.data-lab.workers.dev

2.1 เวิร์กสเปซ (Workspaces)

• GET /workspace/list
  ดึงรายชื่อเวิร์กสเปซทั้งหมดในทีม

ตัวอย่าง Response (JSON):

[
  {
    "workspaceName": "เวิร์กสเปซทีมการตลาด",
    "workspaceKey": "ws-key-12345",
    "createdAt": "2025-07-03T10:00:00Z",
    "creator": "user-uid-abcde",
    "storage": { "used": 102400 }
  }
]

• GET /workspace/{workspaceKey}
  ดึงข้อมูลเวิร์กสเปซที่ระบุ

• GET /workspace/query/projectKey?projectKey={projectKey}
  ค้นหา workspaceKey จาก projectKey

ตัวอย่าง Response (JSON):

{
  "workspaceKey": "ws-key-12345"
}

2.2 โปรเจกต์ (Projects)

• GET /workspace/{workspaceKey}/project/list
  ดึงรายชื่อโปรเจกต์ทั้งหมดในเวิร์กสเปซ

• GET /workspace/{workspaceKey}/project/{projectKey}
  ดึงรายละเอียดโปรเจกต์ที่ระบุ

2.3 คำตอบ (Responses)

• GET /workspace/{workspaceKey}/project/{projectKey}/response/list
  ดาวน์โหลดคำตอบทั้งหมดเป็นไฟล์ Parquet
  Content-Type: application/octet-stream

• GET /workspace/{workspaceKey}/project/{projectKey}/response/get/responseKey/{responseKey}
  ดึงคำตอบเดี่ยวโดยใช้ responseKey

• GET /workspace/{workspaceKey}/project/{projectKey}/response/get/customerKey/{customerKey}
  ดึงคำตอบเดี่ยวโดยใช้ customerKey

• GET /workspace/{workspaceKey}/project/{projectKey}/response/check/customerKey/{customerKey}
  ตรวจสอบว่ามีคำตอบที่ใช้ customerKey หรือไม่

ตัวอย่าง Response (JSON):

{
  "exists": true
}

• GET /workspace/{workspaceKey}/project/{projectKey}/response/query/dateRange?startDate=...&endDate=...
  ดึงคำตอบตามช่วงวัน

• GET /workspace/{workspaceKey}/project/{projectKey}/response/listCustomerKeys
  ดึงรายชื่อ customerKey ทั้งหมดที่ไม่เป็น null

ตัวอย่าง Response (JSON):

{
  "customerKeys": ["customer-001", "customer-002", "customer-003"]
}

2.4 คอลัมน์ (Columns)

• GET /workspace/{workspaceKey}/project/{projectKey}/columns
  ดึงโครงสร้างฟิลด์และ hidden field ของโปรเจกต์

ตัวอย่าง Response (JSON):

{
  "field_columns": [
    { "column_name": "field_abcd", "label": "ชื่อ", "type": "TEXT" }
  ],
  "hidden_field_columns": [
    { "column_name": "hf_1234", "label": "ช่องทางเข้าถึง", "type": "TEXT" }
  ]
}

3) กรณีการใช้งาน

ตัวอย่างที่ 1: ดาวน์โหลดคำตอบทั้งหมดเพื่อนำไปวิเคราะห์

1. ใช้ GET /workspace/list หรือ GET /workspace/query/projectKey เพื่อหา workspaceKey

2. ใช้ GET /workspace/{workspaceKey}/project/{projectKey}/response/list เพื่อดาวน์โหลดไฟล์ Parquet

3. วิเคราะห์ไฟล์ด้วย Pandas (Python) หรือ R

ตัวอย่างที่ 2: เชื่อม CRM เพื่อตรวจสอบประวัติคำตอบของลูกค้า

1. ซิงก์ Customer ID ของ CRM กับ customerKey ใน Walla

2. เวลาดูข้อมูลลูกค้า ใช้ GET .../response/check/customerKey/{customerKey} เพื่อตรวจสอบ

3. ถ้ามีคำตอบ (exists: true), ใช้ GET .../response/get/customerKey/{customerKey} เพื่อดึงรายละเอียดและแสดงใน CRM

4) หมายเหตุและ FAQ

• เวอร์ชัน API: v1.0 อาจมีเวอร์ชันใหม่ในอนาคต

• การจัดการข้อผิดพลาด: คืนค่า HTTP Status ปกติ (400, 401, 404 เป็นต้น) พร้อมรายละเอียดเพิ่มเติม

• Rate Limiting: จำกัดจำนวนการเรียกเพื่อป้องกันการใช้งานเกินกำลัง สามารถตรวจสอบได้จาก response header

• หากพบปัญหา ติดต่อ Walla Help Center

สรุป

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

✔️ บทความที่เกี่ยวข้อง

• การจัดการข้อมูลส่วนบุคคลของผู้ใช้ในประเทศไทย: ทำความเข้าใจกฎหมาย PDPA และแนวทางปฏิบัติของ Walla

• PDPA ไทยยังสับสนอยู่ใช่ไหม? คู่มือสรุปใจความสำคัญที่ทุกธุรกิจต้องรู้

• 'ช่วงเวลาทอง' 72 ชั่วโมงเมื่อข้อมูลรั่วไหล: คู่มือฉบับสมบูรณ์เกี่ยวกับหน้าที่การแจ้งเหตุภายใต้ PDPA ของไทย

• การตลาดผ่าน LINE Official Account (OA): คู่มือฉบับสมบูรณ์เพื่อการปฏิบัติตาม PDPA ของไทย

• ยิงปืนนัดเดียวได้นกสองตัว: กลยุทธ์ UX เพื่อ “ขอความยินยอม” สำหรับนักการตลาดไทย เพิ่มทั้ง Conversion Rate และความสอดคล้องกับ PDPA

• ตั้งแต่การจ้างงานจนถึงการลาออก: แนวทางปฏิบัติ PDPA ที่ทีม HR ในไทยต้องรู้

• "สร้างเอง" หรือ "ใช้โซลูชันสำเร็จรูป": วิธีการรวบรวมข้อมูลที่เหมาะสมที่สุดสำหรับบริษัทของคุณในยุค PDPA ของไทยคืออะไร?

• วิธีสร้างแบบสำรวจที่ปลอดภัยสำหรับโรงเรียนในประเทศไทย

• เครื่องมือสำรวจออนไลน์ที่ดีที่สุดสำหรับองค์กรในไทย: เจาะลึกด้านความปลอดภัย, การเชื่อมต่อ, และการสร้างแบรนด์

• ตัวเลือกที่ดีที่สุดแทน Google Forms (ฟรี) ในไทย: สร้างฟอร์มที่สวยและฉลาดกว่า

• ฟอร์มบิลเดอร์ที่เชื่อมต่อ API ได้: เชื่อม Walla เข้ากับเวิร์กโฟลว์ขององค์กร

• Tally vs. Walla: บทวิเคราะห์เปรียบเทียบเครื่องมือสร้างฟอร์มที่สมบูรณ์แบบสำหรับธุรกิจ B2B และ B2C

• Microsoft Forms vs. Walla: พันธมิตรด้านผลิตภาพ ปะทะ ผู้เชี่ยวชาญด้าน Data Intelligence

• Jotform vs. Walla: ขุมพลังแห่งฟีเจอร์ ปะทะ ป้อมปราการแห่งความปลอดภัย, คู่มือตัดสินใจฉบับสมบูรณ์สำหรับธุรกิจของคุณ

• การสร้างแบบสำรวจที่สมบูรณ์แบบ: คู่มือการออกแบบแบบสำรวจเพื่อผลลัพธ์ที่ประสบความสำเร็จ

• สิ่งที่ HR ต้องรู้: การจัดการประสบการณ์พนักงานและการใช้แบบสำรวจ

• เคล็ดลับการปรับปรุงประสบการณ์ลูกค้า: สร้างลูกค้าประจำด้วยแบบสำรวจอย่างสม่ำเสมอ

• วิธีการออกแบบแบบสำรวจเพื่อยกระดับประสบการณ์ลูกค้า

• คู่มือการ Onboarding พนักงานใหม่ที่มีประสิทธิภาพด้วยแบบสำรวจ

• กลยุทธ์แบบสำรวจเพื่อเพิ่มการรับรู้แบรนด์

• สร้าง Form Builder เฉพาะสำหรับบริษัทของคุณ: Walla On-Premise

• แบรนด์รถยนต์ไฟฟ้าพรีเมียมจากสวีเดน Polestar ออกแบบประสบการณ์ลูกค้าด้วย Walla

• Under Armour: การจัดการอีเวนต์อย่างชาญฉลาดด้วย Walla

• Olive Young Pop-up: เก็บข้อมูลลูกค้าได้ง่ายและชาญฉลาดด้วย Walla