องค์ประกอบของการสนทนา

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

ข้อจำกัด

หากผู้ใช้ WhatsApp แตะที่ลิงก์สากล (เช่น ลิงก์ wa.me) ที่ได้รับการกำหนดค่าให้มีข้อความที่กรอกไว้ล่วงหน้า อินเทอร์เฟซผู้ใช้สำหรับประโยคเริ่มการสนทนาจะถูกยกเลิกโดยอัตโนมัติ

กำหนดค่าผ่านตัวจัดการ WhatsApp (WAM)

คุณสามารถกำหนดค่าฟีเจอร์ทั้งหมดเหล่านี้ได้ในตัวจัดการ WhatsApp ตามหมายเลขเฉพาะเจาะจงที่คุณเลือก

ไปที่ "แดชบอร์ดแอพของฉัน" ในเว็บไซต์ Meta for Developers
เลือกแอพของคุณ จากนั้นที่แผงด้านซ้าย เลือก การกำหนดค่า ในส่วน WhatsApp
ในส่วน "หมายเลขโทรศัพท์" ให้เลือก "จัดการหมายเลขโทรศัพท์"
ที่ด้านขวาสุดของหมายเลขโทรศัพท์ที่คุณต้องการกำหนดค่า ให้เลือกไอคอนรูปเฟือง ในส่วน "การตั้งค่า"
เลือก "ระบบอัตโนมัติ"
เมื่อเข้ามาแล้ว ให้กำหนดค่าองค์ประกอบของการสนทนา

ผู้ให้บริการโซลูชั่นสามารถกำหนดค่าฟีเจอร์เหล่านี้ให้กับลูกค้าได้ด้วยเช่นกัน หากผู้ให้บริการมีสิทธิ์เข้าถึงบัญชี WhatsApp Business ของลูกค้าในตัวจัดการ WhatsApp

ข้อความต้อนรับ

ขณะนี้ข้อความต้อนรับยังไม่ทำงานได้ตามที่มุ่งหวังไว้

ขออภัย เราไม่ได้กำหนดไทม์ไลน์ว่าจะมีการนำฟีเจอร์นี้มาใช้งานเมื่อใดในอนาคต

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

คุณจะได้รับการแจ้งเตือนทาง Webhook ทุกครั้งที่ผู้ใช้ WhatsApp เปิดแชทกับคุณเป็นครั้งแรก ข้อความนี้จะมีประโยชน์หากคุณต้องการตอบกลับผู้ใช้เหล่านี้ด้วยข้อความต้อนรับแบบพิเศษที่คุณออกแบบเอง

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

หากคุณเปิดใช้งานฟีเจอร์นี้และผู้ใช้ส่งข้อความถึงคุณ ไคลเอ็นต์ WhatsApp จะตรวจสอบเธรดข้อความที่มีอยู่ระหว่างผู้ใช้กับหมายเลขโทรศัพท์ธุรกิจของคุณ หากไม่มี ไคลเอ็นต์จะทริกเกอร์ Webhook messages พร้อมกับ type ที่ตั้งค่าเป็น request_welcome จากนั้นคุณจะสามารถตอบกลับผู้ใช้ด้วยข้อความต้อนรับของคุณเองได้

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

ข้อความเทมเพลตภาพสไลด์เป็นข้อความต้อนรับ

เพย์โหลด Webhook

{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
              "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>"
            },
            "contacts": [
              {
                "profile": {
                  "name": "<WHATSAPP_USER_NAME>"
                },
                "wa_id": "<WHATSAPP_USER_ID>"
              }
            ],
            "messages": [
              {
                "from": "<WHATSAPP_USER_PHONE_NUMBER_ID>",
                "id": "<WHATSAPP_MESSAGE_ID>",
                "timestamp": "<TIMESTAMP>",
                "type": "request_welcome"  // Indicates first time message from WhatsApp user
              }
            ]
          },
          "field": "messages"
        }
      ]
    }
  ]
}

ประโยคเริ่มการสนทนา

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

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

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

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

หากผู้ใช้ WhatsApp แตะที่ลิงก์สากล (ลิงก์ wa.me หรือ api.whatsapp.com) ที่ได้รับการกำหนดค่าให้มีข้อความที่กรอกไว้ล่วงหน้า อินเทอร์เฟซผู้ใช้สำหรับประโยคเริ่มการสนทนาจะถูกยกเลิกโดยอัตโนมัติ

เพย์โหลด Webhook

{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
              "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>"
            },
            "contacts": [
              {
                "profile": {
                  "name": "<WHATSAPP_USER_NAME>"
                },
                "wa_id": "<WHATSAPP_USER_ID>"
              }
            ],
            "messages": [
              {
                "from": "<WHATSAPP_USER_PHONE_NUMBER_ID>",
                "id": "<WHATSAPP_MESSAGE_ID>",
                "timestamp": "<TIMESTAMP>",
                "text": {
                  "body": "Plan a trip"
                },
                "type": "text"
              }
            ]
          },
          "field": "messages"
        }
      ]
    }
  ]
}

คำสั่ง

คำสั่งคือสตริงข้อความที่ผู้ใช้ WhatsApp สามารถดูได้โดยการพิมพ์เครื่องหมายทับหน้าในเธรดข้อความกับธุรกิจของคุณ

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

/imagine - Create images using a text prompt

เมื่อผู้ใช้ WhatsApp พิมพ์ /imagine cars racing on Mars จะทริกเกอร์ Webhook ข้อความที่ได้รับพร้อมกับสตริงข้อความที่แน่นอนที่กำหนดให้กับคุณสมบัติ body จากนั้นคุณก็สามารถสร้างและส่งกลับภาพการแข่งรถบนดาวอังคารได้

คุณสามารถกำหนดได้มากถึง 30 คำสั่ง โดยแต่ละคำสั่งมีอักขระสูงสุด 32 ตัว และแต่ละคำแนะนำมีอักขระสูงสุด 256 ตัว ระบบไม่รองรับอีโมจิ

เพย์โหลด Webhook

{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
              "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>"
            },
            "contacts": [
              {
                "profile": {
                  "name": "<WHATSAPP_USER_NAME>"
                },
                "wa_id": "<WHATSAPP_USER_ID>"
              }
            ],
            "messages": [
              {
                "from": "<WHATSAPP_USER_PHONE_NUMBER_ID>",
                "id": "<WHATSAPP_MESSAGE_ID>",
                "timestamp": "<TIMESTAMP>",
                "text": {
                  "body": "/imagine cars racing on Mars"
                },
                "type": "text"
              }
            ]
          },
          "field": "messages"
        }
      ]
    }
  ]
}

การกำหนดค่าผ่าน API

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

API สำหรับองค์ประกอบของการสนทนาประกอบด้วยตำแหน่งข้อมูลสองรายการ

POST </PHONE_NUMBER_ID>/conversational_automation ซึ่งใช้เพื่อกำหนดค่าองค์ประกอบของการสนทนาบนหมายเลขโทรศัพท์ที่ให้ไว้

GET /<PHONE_NUMBER_ID>/conversational_automation ซึ่งจะส่งคืนค่าปัจจุบันสำหรับคำสั่งและช่องป้อนคำสั่ง enable_welcome_message บนหมายเลขโทรศัพท์ที่ให้ไว้

กำหนดค่าองค์ประกอบของการสนทนาผ่าน API

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

รูปแบบคำสั่งของคำขอ

// Enable or disable the Welcome Message for the given phone number ID
POST /<PHONE_NUMBER_ID>/conversational_automation?enable_welcome_message=<ENABLE_DISABLE>

// Configure Commands with names and descriptions
POST /<PHONE_NUMBER_ID>/conversational_automation?commands=<COMMAND_LIST>

// Configure Prompts
POST /<PHONE_NUMBER_ID>/conversational_automation?prompts=<PROMPT>

คุณสมบัติของเนื้อความ

ตัวยึดตำแหน่ง คำอธิบาย ตัวอย่างค่า

ตัวยึดตำแหน่ง	คำอธิบาย	ตัวอย่างค่า
`<PHONE_NUMBER_ID>` จำนวนเต็ม	จำเป็นต้องระบุ ID หมายเลขโทรศัพท์บนบัญชี WhatsApp Business	`+12784358810`
`<ENABLE_DISABLE>` บูลีน	ระบุหรือไม่ก็ได้ บูลีนสำหรับเปิดหรือปิดใช้งานข้อความต้อนรับบนหมายเลขโทรศัพท์	`true`
`<COMMAND_LIST>` JSON	ระบุหรือไม่ก็ได้ รายการคำสั่งสำหรับกำหนดค่า	"commands": { "command_name": "generate" "command_description": "Create a new image", “command_name”: “rethink” “command_description”: “Generate new images from existing images”, }
`<PROMPTS>` รายการสตริง	ระบุหรือไม่ก็ได้ คำสั่งสำหรับกำหนดค่า	`"prompts": ["Book a flight","plan a vacation"]`

<PHONE_NUMBER_ID>

จำนวนเต็ม

จำเป็นต้องระบุ

ID หมายเลขโทรศัพท์บนบัญชี WhatsApp Business

+12784358810

<ENABLE_DISABLE>

บูลีน

ระบุหรือไม่ก็ได้

บูลีนสำหรับเปิดหรือปิดใช้งานข้อความต้อนรับบนหมายเลขโทรศัพท์

true

<COMMAND_LIST>

JSON

ระบุหรือไม่ก็ได้

รายการคำสั่งสำหรับกำหนดค่า

"commands": {
     "command_name": "generate"
     "command_description": "Create a new image",
     “command_name”: “rethink”
     “command_description”: “Generate new images from existing images”,
}

<PROMPTS>

รายการสตริง

ระบุหรือไม่ก็ได้

คำสั่งสำหรับกำหนดค่า

"prompts": ["Book a flight","plan a vacation"]

ตัวอย่างคำขอ

   curl -X POST \
 'https://graph.facebook.com/v19.0/PHONE_NUMBER_ID/conversational_automation' \
 -H 'Authorization: Bearer ACCESS_TOKEN' \
 -H 'Content-Type: application/json' \
 -d '{
   "enable_welcome_message": true/false,
   "commands": [
     {
       "command_name": "tickets",
       "command_description": "Book flight tickets",
     },
     {
       "command_name": "hotel",
       "command_description": "Book hotel",
     }
   ],
 "prompts": ["Book a flight","plan a vacation"]
}'

ตัวอย่างการตอบกลับ

{
  "success": true
}

ดูการกำหนดค่าปัจจุบันผ่าน API

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

รูปแบบคำสั่งของคำขอ

GET  /<PHONE_NUMBER_ID>?fields=conversational_automation

ตัวอย่างการตอบกลับ

{
  "conversational_automation": {
    "enable_welcome_message": true
    "prompts": [
      "Find the best hotels in the area",
      "Find deals on rental cars"
    ],
    "commands": [
      {
        "command_name": "tickets",
        "command_description": "Book flight tickets",
      },
      {
        "command_name": "hotel",
        "command_description": "Book hotel",
      }
    ],
  }
  "id": "123456"
}

การทดสอบ

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

สำหรับข้อความต้อนรับและประโยคเริ่มการสนทนา หากคุณมีเธรดการแชทกับหมายเลขโทรศัพท์ธุรกิจอยู่แล้ว คุณต้องลบเธรดการแชทนั้นก่อน ดังนี้

เปิดเธรดในไคลเอ็นต์ WhatsApp
แตะโปรไฟล์ของหมายเลขโทรศัพท์ธุรกิจ
แตะล้างแชท > ล้างข้อความทั้งหมด
ลบแชท
เริ่มเธรดแชทใหม่ด้วยธุรกิจนี้

จากนั้นคุณจะสามารถส่งข้อความไปยังหมายเลขโทรศัพท์ธุรกิจได้ ซึ่งจะทริกเกอร์ Webhook request_welcome