showFunctionButtonWidget

Cập nhật lần cuối: 10/04/2025

Bắt đầu hỗ trợ ở phiên bản:

• SDK: 2.39.0

Widget Function Button: Khi người dùng nhấn vào button này, Mini App sẽ nhận được 1 message token (có giá trị trong 7 ngày) để gửi tin nhắn tới người dùng. Chi tiết hướng dẫn gửi tin nhắn thông qua message token tham khảo tại đây

Parameters

Object object

Property	Type	Default	Required	Description	Minimum Version
id	string		true	ID của element, nơi cần hiển thị widget
type	string		true	Hiện tại chỉ hỗ trợ giá trị: ORDER
text	string		true	Chuỗi hiển thị trong button. Phải là một trong các giá trị sau đây: Thanh toán Đặt món Đặt xe Đặt hàng Mua vé Booking Đặt chỗ Tạo đơn hàng Đặt trước Mua hàng Đặt lịch Tra cứu Kiểm tra
fontSize	string	16px		Kích thước font chữ. Giá trị nhỏ nhất là 14px
color	string	#0068FF		Màu chủ đạo của widget. Giá trị phải là chuỗi hex
textColor	string	#FFFFFF		Màu chữ trong button. Giá trị phải là chuỗi hex
borderRadius	string	48px		Bo góc (bo tròn các góc của button)
onDataReceived	function			Trả về messageToken khi click widget
onError	function			Trả về error khi click widget

String messageToken

Token được dùng để gửi tin nhắn tới người dùng. Có giá trị trong 7 ngày

String error

Trả về thông tin khi có lỗi xảy ra

Sample Code

import React, { useEffect } from "react";
import { showFunctionButtonWidget } from "zmp-sdk/apis";

function HomePage() {
  useEffect(() => {
    showFunctionButtonWidget({
      id: "orderButton",
      type: "ORDER",
      text: "Đặt hàng",
      color: "#0068FF",
      textColor: "#FFFFFF",
      borderRadius: "48px",
      onDataReceived: (messageToken) => {
        console.log(messageToken);
      },
      onError: (error) => {
        console.error("onError:", error);
      }
    });
  }, []);

  return (
    <>
      ...
      <div id="orderButton" />
      ...
    </>
  );
}

export default HomePage;