openShareSheet

Cập nhật lần cuối: 24/08/2023

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

Lưu ý

Cần xin cấp quyền tại trang Quản lý ứng dụng

Cho phép ứng dụng mở giao diện chia sẻ để người dùng chia sẻ thông tin với bạn bè Zalo.

Parameters

Object object

Property	Type	Required	Description	Minimum Version
type	string	true	Nhận các giá trị sau: 'image': Chia sẻ hình ảnh 'link': Chia sẻ liên kết 'oa': Chia sẻ OA 'gif': Chia sẻ ảnh động 'video': Chia sẻ video 'zmp': Chia sẻ page hiện tại của Zalo Mini App 'zmp_deep_link': Chia sẻ page hiện tại của Zalo Mini App thông qua deep link để có thể truy cập Mini App từ ngoài ứng dụng Zalo	Type: 'zmp_deep_link' sẽ được hỗ trợ từ API: 2.25.7
data	object	true	Nội dung cần chia sẻ
success	function		Callback function khi gọi api thành công
fail	function		Callback function khi gọi api thất bại n

Object data

Chia sẻ hình ảnh (type='image')

Property	Type	Default	Required	Description	Minimum Version
imageUrl	string		true	Url hình ảnh cần chia sẻ

Chia sẻ liên kết (type='link')

Property	Type	Default	Required	Description	Minimum Version
link	string		true	Liên kết cần chia sẻ
chatOnly	boolean	true		Chỉ chia sẻ qua cửa sổ chat

Chia sẻ Official Account (type='oa')

Property	Type	Default	Required	Description	Minimum Version
id	string		true	Id của official account

Chia sẻ ảnh động (type='gif')

Property	Type	Required	Description
gifUrl	string	true	Url ảnh động cần chia sẻ
imageUrl	string		Url hình ảnh đại diện
width	number		Chiều rộng
height	number		Chiều cao

Chia sẻ video (type='video')

Property	Type	Required	Description
videoThumb	string	true	Url thumbnail cho video
videoUrl	string	true	Url video
width	number		Chiều rộng
height	number		Chiều cao

Chia sẻ page hiện tại của Zalo Mini App (type='zmp')

Property	Type	Required	Description
title	string	true	Tiêu đề cần chia sẻ
description	string		Mô tả
thumbnail	string	true	Url thumbnail cho Zalo Mini App
path	string	true	Đường dẫn cần chia sẻ

Chia sẻ page hiện tại của Zalo Mini App thông qua deep link (type='zmp_deep_link')

Property	Type	Required	Description
title	string	true	Tiêu đề cần chia sẻ. Tối đa 100 ký tự
thumbnail	string	true	Url thumbnail cho Zalo Mini App
description	string		Mô tả. Tối đa 400 ký tự
path	string		Đường dẫn cần chia sẻ, mặc định sẽ lấy theo đường dẫn hiện tại

Return Values

Promise <Object data>

Property	Type	Description
status	number	Có các giá trị sau: 0: User nhấn huỷ/cancel bài viết 1: Đăng bài viết thành công lên nhật ký 2: Đăng bài viết thành công qua cửa sổ chat
shareType	number	Trạng thái bài chia sẻ, có các giá trị sau: 0: Công khai 1: Chỉ mình tôi 2: Chia sẻ cho danh sách bạn
numberOfUser	number	Số lượng user nhận được bài chia sẻ trong trường hợp `shareType=2`

Sample Code

Chia sẻ hình ảnh

import { openShareSheet } from "zmp-sdk/apis";

openShareSheet({
  type: "image",
  data: {
    imageUrl: "http://dev.org.zads.zdn.vn/2a16c7fefbbb12e54baa"
  },
  success: (data) => {},
  fail: (err) => {}
});

Hoặc

import { openShareSheet } from "zmp-sdk/apis";

const shareImage = async () => {
  try {
    const data = await openShareSheet({
      type: "image",
      data: {
        imageUrl: "http://dev.org.zads.zdn.vn/2a16c7fefbbb12e54baa"
      }
    });
  } catch (err) {}
};

Chia sẻ liên kết

import { openShareSheet } from "zmp-sdk/apis";

openShareSheet({
  type: "link",
  data: {
    link: "http://news.zing.vn/Trung-uong-quyet-dinh-phuong-an-nhan-su-cap-cao-post632739.html",
    chatOnly: false
  },
  success: (data) => {},
  fail: (err) => {}
});

Hoặc

import { openShareSheet } from "zmp-sdk/apis";

const shareLink = async () => {
  try {
    const data = await openShareSheet({
      type: "link",
      data: {
        link: "http://news.zing.vn/Trung-uong-quyet-dinh-phuong-an-nhan-su-cap-cao-post632739.html",
        chatOnly: false
      }
    });
  } catch (err) {}
};

Chia sẻ Official Account

import { openShareSheet } from "zmp-sdk/apis";

openShareSheet({
  type: "oa",
  data: {
    id: "765465772305886642"
  },
  success: (data) => {},
  fail: (err) => {}
});

Hoặc

import { openShareSheet } from "zmp-sdk/apis";

const shareOA = async () => {
  try {
    const data = await openShareSheet({
      type: "oa",
      data: {
        id: "765465772305886642"
      }
    });
  } catch (err) {}
};

Chia sẻ GIF

import { openShareSheet } from "zmp-sdk/apis";

openShareSheet({
  type: "gif",
  data: {
    imageUrl: "http://dev.org.zads.zdn.vn/2a16c7fefbbb12e54baa",
    gifUrl: "http://dev.org.zads.zdn.vn/fc88fe60c2252b7b7234",
    width: 480,
    height: 270
  },
  success: (data) => {},
  fail: (err) => {}
});

Hoặc

import { openShareSheet } from "zmp-sdk/apis";

const shareGIF = async () => {
  try {
    const data = await openShareSheet({
      type: "gif",
      data: {
        imageUrl: "http://dev.org.zads.zdn.vn/2a16c7fefbbb12e54baa",
        gifUrl: "http://dev.org.zads.zdn.vn/fc88fe60c2252b7b7234",
        width: 480,
        height: 270
      }
    });
  } catch (err) {}
};

Chia sẻ video

import { openShareSheet } from "zmp-sdk/apis";

openShareSheet({
  type: "video",
  data: {
    videoThumb: "http://dev.org.zads.zdn.vn/fc88fe60c2252b7b7234",
    videoUrl: "http://dev.org.zads.zdn.vn/fc88fe60c2252b7b7234",
    width: 480,
    height: 270
  },
  success: (res) => {},
  fail: (err) => {}
});

Hoặc

import { openShareSheet } from "zmp-sdk/apis";

const shareVideo = async () => {
  try {
    const data = await openShareSheet({
      type: "video",
      data: {
        videoThumb: "http://dev.org.zads.zdn.vn/fc88fe60c2252b7b7234",
        videoUrl: "http://dev.org.zads.zdn.vn/fc88fe60c2252b7b7234",
        width: 480,
        height: 270
      }
    });
  } catch (err) {}
};

Chia sẻ page hiện tại của Zalo Mini App

import { openShareSheet } from "zmp-sdk/apis";

openShareSheet({
  type: "zmp",
  data: {
    title: "My Zalo Mini App - HomePage",
    description: "Home page",
    thumbnail: "https://sample-videos.com/img/Sample-jpg-image-50kb.jpg"
  },
  success: (res) => {},
  fail: (err) => {}
});

Hoặc

import { openShareSheet } from "zmp-sdk/apis";

const shareCurrentPage = async () => {
  try {
    const data = await openShareSheet({
      type: "zmp",
      data: {
        title: "My Zalo Mini App - HomePage",
        description: "Home page",
        thumbnail: "https://sample-videos.com/img/Sample-jpg-image-50kb.jpg"
      }
    });
  } catch (err) {}
};

Chia sẻ page hiện tại của Zalo Mini App thông qua deep link

import { openShareSheet } from "zmp-sdk/apis";

openShareSheet({
  type: "zmp_deep_link",
  data: {
    title: "My Zalo Mini App - HomePage",
    description: "Home page",
    thumbnail: "https://sample-videos.com/img/Sample-jpg-image-50kb.jpg"
  },
  success: (res) => {},
  fail: (err) => {}
});

Hoặc

import { openShareSheet } from "zmp-sdk/apis";

const shareCurrentPage = async () => {
  try {
    const data = await openShareSheet({
      type: "zmp_deep_link",
      data: {
        title: "My Zalo Mini App - HomePage",
        description: "Home page",
        thumbnail: "https://sample-videos.com/img/Sample-jpg-image-50kb.jpg"
      }
    });
  } catch (err) {}
};

Parameters​

Object object​

Object data​

Chia sẻ hình ảnh (type='image')​

Chia sẻ liên kết (type='link')​

Chia sẻ Official Account (type='oa')​

Chia sẻ ảnh động (type='gif')​

Chia sẻ video (type='video')​

Chia sẻ page hiện tại của Zalo Mini App (type='zmp')​

Chia sẻ page hiện tại của Zalo Mini App thông qua deep link (type='zmp_deep_link')​

Return Values​

Promise <Object data>​

Sample Code​

Chia sẻ hình ảnh​

Chia sẻ liên kết​

Chia sẻ Official Account​

Chia sẻ GIF​

Chia sẻ video​

Chia sẻ page hiện tại của Zalo Mini App​

Chia sẻ page hiện tại của Zalo Mini App thông qua deep link​

openShareSheet

Parameters

Object object

Object data

Chia sẻ hình ảnh (type='image')

Chia sẻ liên kết (type='link')

Chia sẻ Official Account (type='oa')

Chia sẻ ảnh động (type='gif')

Chia sẻ video (type='video')

Chia sẻ page hiện tại của Zalo Mini App (type='zmp')

Chia sẻ page hiện tại của Zalo Mini App thông qua deep link (type='zmp_deep_link')

Return Values

Promise <Object data>

Sample Code

Chia sẻ hình ảnh

Chia sẻ liên kết

Chia sẻ Official Account

Chia sẻ GIF

Chia sẻ video

Chia sẻ page hiện tại của Zalo Mini App

Chia sẻ page hiện tại của Zalo Mini App thông qua deep link