Thư viện ứng dụng RBM đơn giản hoá việc tạo tác nhân RBM bằng Node.js, C#, Python hoặc Java. Các thư viện này được phát hành trong dự án nguồn mở và phát hành vào kho lưu trữ trên Internet để bạn dễ dàng sử dụng trong mã.
Node.js
Hãy thêm phần phụ thuộc sau đây vào tệp package.json:
"dependencies": {
"@google/rcsbusinessmessaging": "^1.0.7"
}
Hãy kiểm tra kho lưu trữ npm để biết phiên bản mới nhất.
Nhập vào nơi được yêu cầu trong mã của bạn:
const rbmApiHelper = require('@google/rcsbusinessmessaging');
Java
Hãy thêm phần phụ thuộc sau đây vào tệp pom.xml:
<dependency>
<groupId>com.google.rbm</groupId>
<artifactId>rbm-api-helper</artifactId>
<version>1.0.0</version>
</dependency>
Kiểm tra kho lưu trữ Maven để biết phiên bản mới nhất.
Nhập vào nơi được yêu cầu trong mã của bạn:
import com.google.rbm.RbmApiHelper;
Điều kiện tiên quyết
Trước khi bắt đầu, bạn cần làm những việc sau:
- Đăng ký một nhân viên hỗ trợ.
Tải xuống và cài đặt phần mềm cần thiết:
Thiết lập
Tải Mẫu tác nhân đầu tiên xuống.
Lưu ý: Hãy đăng nhập bằng Tài khoản Google RBM để truy cập vào các đường liên kết tải xuống.Giải nén tệp trên máy cục bộ.
Làm theo hướng dẫn trong tài liệu README để định cấu hình thông tin đăng nhập RBM của bạn.
Gửi tin nhắn
Trong các ví dụ sau, rbm_api_helper.js (không dùng cho Python) giả định tệp bạn đang xử lý là một thư mục bên dưới thư mục ứng dụng chính. Bạn có thể cần điều chỉnh vị trí tuỳ thuộc vào cấu hình của dự án.
Lời mời dành cho người kiểm thử
Trước khi bạn ra mắt nhân viên hỗ trợ, nhân viên hỗ trợ chỉ có thể giao tiếp với các thiết bị thử nghiệm được mời. Mã sau đây sẽ gửi lời mời người kiểm thử đến một thiết bị có thư viện ứng dụng.
Node.js
// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');
// Send the tester invite to the device
rbmApiHelper.sendTesterInvite('+12223334444', function(response) {
console.log(response);
});
Mã này là phần trích dẫn từ một tác nhân mẫu RBM.
Java
import com.google.rbm.RbmApiHelper;
…
try {
// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper();
// Register the device as a tester
rbmApiHelper.registerTester("+12223334444");
} catch(Exception e) {
e.printStackTrace();
}
Mã này là phần trích dẫn từ một tác nhân mẫu RBM.
Python
# Reference to RBM Python client helper
from rcs_business_messaging import rbm_service
# Send the tester invite to a device
rbm_service.invite_tester('+12223334444')
Mã này là một phần trích dẫn từ trình đại diện mẫu RBM.
C#
using RCSBusinessMessaging;
…
// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
projectId);
// Register the device as a tester
rbmApiHelper.RegisterTester("+12223334444");
Mã này là phần trích dẫn từ một tác nhân mẫu RBM.
Kiểm tra chức năng
Nhân viên hỗ trợ của bạn chỉ có thể liên lạc với các thiết bị hỗ trợ RCS. Bạn có thể kiểm tra xem một thiết bị có hỗ trợ RCS hay không bằng cách kiểm tra các tính năng của thiết bị. Mã sau đây kiểm tra chức năng của một thiết bị bằng thư viện ứng dụng.
Node.js
// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');
// Send a capability check to the device
rbmApiHelper.checkCapability('+12223334444', function(response) {
// Print capabilities of the device
console.log(response);
});
Mã này là phần trích dẫn từ một tác nhân mẫu RBM.
Java
import com.google.rbm.RbmApiHelper;
…
// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper();
// Check the capabilities of the device
boolean capability = rbmApiHelper.getCapability("+12223334444");
Mã này là một phần trích dẫn từ trình đại diện mẫu RBM.
Python
# Reference to RBM Python client helper
from rcs_business_messaging import rbm_service
# Send the tester invite to a device
response = rbm_service.make_cap_request('+12223334444')
Mã này là phần trích dẫn từ một tác nhân mẫu RBM.
C#
using RCSBusinessMessaging;
…
// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
projectId);
// Register the device as a tester
Capabilities capabilities = rbmApiHelper.GetCapability("+12223334444");
Mã này là phần trích dẫn từ một tác nhân mẫu RBM.
Thông báo đơn giản
Một thông điệp đơn giản được tạo hoàn toàn bằng văn bản. Mã sau đây sẽ gửi một tin nhắn văn bản đơn giản đến một thiết bị có thư viện ứng dụng.
Node.js
// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');
let params = {
messageText: 'Hello, world!',
msisdn: '+12223334444',
};
// Send a simple message to the device
rbmApiHelper.sendMessage(params, function(response) {
console.log(response);
});
Mã này là phần trích dẫn từ một tác nhân mẫu RBM.
Java
import com.google.rbm.RbmApiHelper;
…
try {
// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper();
// Send simple text message to user
rbmApiHelper.sendTextMessage(
"Hello, world!",
"+12223334444"
);
} catch(Exception e) {
e.printStackTrace();
}
Mã này là phần trích dẫn từ một tác nhân mẫu RBM.
Python
# Reference to RBM Python client helper and messaging object structure
from rcs_business_messaging import rbm_service
from rcs_business_messaging import messages
# Create a simple RBM text message
message_text = messages.TextMessage('Hello, world!')
# Send text message to the device
messages.MessageCluster().append_message(message_text).send_to_msisdn('+12223334444')
Mã này là một phần trích dẫn từ trình đại diện mẫu RBM.
C#
using RCSBusinessMessaging;
…
// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
projectId);
rbmApiHelper.SendTextMessage(
"Hello, world!",
"+12223334444",
);
Mã này là một phần trích dẫn từ trình đại diện mẫu RBM.
Tin nhắn có câu trả lời được đề xuất
Câu trả lời đề xuất giúp hướng dẫn người dùng trong các cuộc trò chuyện với nhân viên hỗ trợ của bạn. Một tin nhắn đơn giản có thể bao gồm một tập hợp các câu trả lời và hành động được đề xuất. Mã sau đây sẽ gửi một tin nhắn văn bản đơn giản kèm theo hai nội dung trả lời đề xuất đến một thiết bị có thư viện ứng dụng.
Node.js
// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');
let suggestions = [
{
reply: {
'text': 'Suggestion #1',
'postbackData': 'suggestion_1',
},
},
{
reply: {
'text': 'Suggestion #2',
'postbackData': 'suggestion_2',
},
},
];
let params = {
messageText: 'Hello, world!',
msisdn: '+12223334444',
suggestions: suggestions,
};
// Send a simple message with suggestion chips to the device
rbmApiHelper.sendMessage(params, function(response) {
console.log(response);
});
Mã này là một phần trích dẫn từ trình đại diện mẫu RBM.
Java
import com.google.api.services.rcsbusinessmessaging.v1.model.Suggestion;
import com.google.rbm.RbmApiHelper;
import com.google.rbm.SuggestionHelper;
…
try {
// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper();
// Create suggestions for chip list
List<Suggestion> suggestions = new ArrayList<Suggestion>();
suggestions.add(
new SuggestionHelper("Suggestion #1", "suggestion_1").getSuggestedReply());
suggestions.add(
new SuggestionHelper("Suggestion #2", "suggestion_2").getSuggestedReply());
// Send simple text message to user
rbmApiHelper.sendTextMessage(
"Hello, world!",
"+12223334444",
suggestions
);
} catch(Exception e) {
e.printStackTrace();
}
Mã này là một phần trích dẫn từ trình đại diện mẫu RBM.
Python
# Reference to RBM Python client helper and messaging object structure
from rcs_business_messaging import rbm_service
from rcs_business_messaging import messages
# Create text message to send to user
text_msg = messages.TextMessage('Hello, world!')
cluster = messages.MessageCluster().append_message(text_msg)
# Append suggested replies for the message to send to the user
cluster.append_suggestion_chip(messages.SuggestedReply('Suggestion #1', 'reply:suggestion_1'))
cluster.append_suggestion_chip(messages.SuggestedReply('Suggestion #2', 'reply:suggestion_2'))
# Send a simple message with suggestion chips to the device
cluster.send_to_msisdn('+12223334444')
Mã này là phần trích dẫn từ một tác nhân mẫu RBM.
C#
using Google.Apis.RCSBusinessMessaging.v1.Data;
using RCSBusinessMessaging;
…
// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
projectId);
List<Suggestion> suggestions = new List<Suggestion>
{
// Create suggestion chips
new SuggestionHelper("Suggestion #1", "suggestion_1").SuggestedReply(),
new SuggestionHelper("Suggestion #2", "suggestion_2").SuggestedReply()
};
// Send simple text message with suggestions to user
rbmApiHelper.SendTextMessage(
"Hello, world!",
"+12223334444",
suggestions
);
Mã này là phần trích dẫn từ một tác nhân mẫu RBM.
Thông báo về nội dung nghe nhìn
Mã sau đây sẽ gửi hình ảnh hoặc video đến thiết bị có thư viện ứng dụng.
Node.js
// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');
let params = {
fileUrl: 'http://www.google.com/logos/doodles/2015/googles-new-logo-5078286822539264.3-hp2x.gif',
msisdn: '+12223334444',
};
// Send an image/video to a device
rbmApiHelper.sendMessage(params, function(response) {
console.log(response);
});
Mã này là phần trích dẫn từ một tác nhân mẫu RBM.
Java
import com.google.api.services.rcsbusinessmessaging.v1.model.AgentContentMessage;
import com.google.api.services.rcsbusinessmessaging.v1.model.AgentMessage;
import com.google.rbm.RbmApiHelper;
…
try {
// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper();
String fileUrl = "http://www.google.com/logos/doodles/2015/googles-new-logo-5078286822539264.3-hp2x.gif";
// create media only message
AgentContentMessage agentContentMessage = new AgentContentMessage();
agentContentMessage.setContentInfo(new ContentInfo().setFileUrl(fileUrl));
// attach content to message
AgentMessage agentMessage = new AgentMessage();
agentMessage.setContentMessage(agentContentMessage);
rbmApiHelper.sendAgentMessage(agentMessage, "+12223334444");
} catch(Exception e) {
e.printStackTrace();
}
Mã này là một phần trích dẫn từ trình đại diện mẫu RBM.
Python
# Reference to RBM Python client helper and messaging object structure
from rcs_business_messaging import rbm_service
from rcs_business_messaging import messages
# Create media file attachment
file_message = messages.FileMessage('http://www.google.com/logos/doodles/2015/googles-new-logo-5078286822539264.3-hp2x.gif')
messages.MessageCluster().append_message(file_message).send_to_msisdn('+12223334444')
Mã này là phần trích dẫn từ một tác nhân mẫu RBM.
C#
using Google.Apis.RCSBusinessMessaging.v1.Data;
using RCSBusinessMessaging;
…
// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
projectId);
string fileUrl = "http://www.google.com/logos/doodles/2015/googles-new-logo-5078286822539264.3-hp2x.gif";
// Create content info with the file url
ContentInfo contentInfo = new ContentInfo
{
FileUrl = fileUrl
};
// Attach content info to a message
AgentContentMessage agentContentMessage = new AgentContentMessage
{
ContentInfo = contentInfo,
};
// Attach content to message
AgentMessage agentMessage = new AgentMessage
{
ContentMessage = agentContentMessage
};
rbmApiHelper.SendAgentMessage(agentMessage, "+12223334444");
Mã này là phần trích dẫn từ một tác nhân mẫu RBM.
Thẻ thông tin chi tiết
Với thẻ thông tin chi tiết, bạn có thể gửi một phần thông tin liên quan: tiêu đề, nội dung mô tả, hình ảnh và tối đa 4 câu trả lời hoặc hành động đề xuất. Mã sau đây sẽ gửi một thẻ thông tin chi tiết đến một thiết bị có thư viện ứng dụng.
Node.js
// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');
// Suggested replies to be used in the card
let suggestions = [
{
reply: {
'text': 'Suggestion #1',
'postbackData': 'suggestion_1',
},
},
{
reply: {
'text': 'Suggestion #2',
'postbackData': 'suggestion_2',
},
},
];
// Image to be displayed by the card
let imageUrl = 'http://www.google.com/logos/doodles/2015/googles-new-logo-5078286822539264.3-hp2x.gif';
// Definition of the card parameters
let params = {
messageText: 'Hello, world!',
messageDescription: 'RBM is awesome!',
msisdn: '+12223334444',
suggestions: suggestions,
imageUrl: imageUrl,
height: 'TALL',
};
// Send rich card to device
rbmApiHelper.sendRichCard(params, function(response) {
console.log(response);
});
Mã này là một phần trích dẫn từ trình đại diện mẫu RBM.
Java
import com.google.api.services.rcsbusinessmessaging.v1.model.StandaloneCard;
import com.google.api.services.rcsbusinessmessaging.v1.model.Suggestion;
import com.google.rbm.cards.CardOrientation;
import com.google.rbm.cards.MediaHeight;
import com.google.rbm.RbmApiHelper;
import com.google.rbm.SuggestionHelper;
…
try {
// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper();
// Create suggestions for chip list
List<Suggestion> suggestions = new ArrayList<Suggestion>();
suggestions.add(
new SuggestionHelper("Suggestion #1", "suggestion_1").getSuggestedReply());
suggestions.add(
new SuggestionHelper("Suggestion #2", "suggestion_2").getSuggestedReply());
String imageUrl = "http://www.google.com/logos/doodles/2015/googles-new-logo-5078286822539264.3-hp2x.gif";
// Create a standalone rich card to send to the user
StandaloneCard standaloneCard = rbmApiHelper.createStandaloneCard(
"Hello, world!",
"RBM is awesome!",
imageUrl,
MediaHeight.MEDIUM,
CardOrientation.VERTICAL,
suggestions
);
rbmApiHelper.sendStandaloneCard(standaloneCard, "+12223334444");
} catch(Exception e) {
e.printStackTrace();
}
Mã này là một phần trích dẫn từ trình đại diện mẫu RBM.
Python
# Reference to RBM Python client helper and messaging object structure
from rcs_business_messaging import rbm_service
from rcs_business_messaging import messages
# Suggested replies to be used in the card
suggestions = [
messages.SuggestedReply('Suggestion #1', 'reply:suggestion_1'),
messages.SuggestedReply('Suggestion #2', 'reply:suggestion_2')
]
# Image to be displayed by the card
image_url = 'http://www.google.com/logos/doodles/2015/googles-new-logo-5078286822539264.3-hp2x.gif';
# Define rich card structure
rich_card = messages.StandaloneCard('VERTICAL',
'Hello, world!',
'RBM is awesome!',
suggestions,
image_url,
None,
None,
'MEDIUM')
# Append rich card and send to the user
cluster = messages.MessageCluster().append_message(rich_card)
cluster.send_to_msisdn('+12223334444')
Mã này là một phần trích dẫn từ trình đại diện mẫu RBM.
C#
using Google.Apis.RCSBusinessMessaging.v1.Data;
using RCSBusinessMessaging;
using RCSBusinessMessaging.Cards;
…
// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
projectId);
List<Suggestion> suggestions = new List<Suggestion>
{
// Create suggestion chips
new SuggestionHelper("Suggestion #1", "suggestion_1").SuggestedReply(),
new SuggestionHelper("Suggestion #2", "suggestion_2").SuggestedReply()
};
string imageUrl = "http://www.google.com/logos/doodles/2015/googles-new-logo-5078286822539264.3-hp2x.gif";
// Create rich card with suggestions
StandaloneCard standaloneCard = rbmApiHelper.CreateStandaloneCard(
"Hello, world!",
"RBM is awesome",
imageUrl,
MediaHeight.TALL,
CardOrientation.VERTICAL,
suggestions
);
// Send rich card to user
rbmApiHelper.SendStandaloneCard(standaloneCard, "+12223334444");
Mã này là phần trích dẫn từ một tác nhân mẫu RBM.
Băng chuyền thẻ thông tin chi tiết
Các băng chuyền kết hợp nhiều thẻ thông tin với nhau để cho phép người dùng so sánh các lựa chọn và tương tác riêng. Mã sau đây sẽ gửi một băng chuyền thẻ thông tin chi tiết có hai thẻ đến một thiết bị có thư viện ứng dụng.
Node.js
// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');
// Images for the carousel cards
let card1Image = 'https://storage.googleapis.com/kitchen-sink-sample-images/cute-dog.jpg';
let card2Image = 'https://storage.googleapis.com/kitchen-sink-sample-images/elephant.jpg';
// Define the card contents for a carousel with two cards, each with one suggested reply
let cardContents = [
{
title: 'Card #1',
description: 'The description for card #1',
suggestions: [
{
reply: {
text: 'Card #1',
postbackData: 'card_1',
}
}
],
media: {
height: 'MEDIUM',
contentInfo: {
fileUrl: card1Image,
forceRefresh: false,
},
},
},
{
title: 'Card #2',
description: 'The description for card #2',
suggestions: [
{
reply: {
text: 'Card #2',
postbackData: 'card_2',
}
}
],
media: {
height: 'MEDIUM',
contentInfo: {
fileUrl: card2Image,
forceRefresh: false,
},
},
},
];
// Definition of carousel card
let params = {
msisdn: '+12223334444',
cardContents: cardContents,
};
// Send the device the carousel card defined above
rbmApiHelper.sendCarouselCard(params, function(response) {
console.log(response);
});
Mã này là phần trích dẫn từ một tác nhân mẫu RBM.
Java
import com.google.api.services.rcsbusinessmessaging.v1.model.CardContent;
import com.google.api.services.rcsbusinessmessaging.v1.model.Suggestion;
import com.google.rbm.cards.CardOrientation;
import com.google.rbm.cards.CardWidth;
import com.google.rbm.cards.MediaHeight;
import com.google.rbm.RbmApiHelper;
import com.google.rbm.SuggestionHelper;
…
try {
// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper();
List cardContents = new ArrayList();
// Images for the carousel cards
String card1Image = "https://storage.googleapis.com/kitchen-sink-sample-images/cute-dog.jpg";
// Create suggestions for first carousel card
List card1Suggestions = new ArrayList();
card1Suggestions.add(
new SuggestionHelper("Card #1", "card_1"));
cardContents.add(
new StandaloneCardHelper(
"Card #1",
"The description for card #1",
card1Image,
card1Suggestions)
.getCardContent(MediaHeight.SHORT)
);
// Images for the carousel cards
String card2Image = "https://storage.googleapis.com/kitchen-sink-sample-images/elephant.jpg";
// Create suggestions for second carousel card
List card2Suggestions = new ArrayList();
card2Suggestions.add(
new SuggestionHelper("Card #2", "card_2"));
cardContents.add(
new StandaloneCardHelper(
"Card #2",
"The description for card #2",
card2Image,
card2Suggestions)
.getCardContent(MediaHeight.SHORT)
);
// Send the carousel to the user
rbmApiHelper.sendCarouselCards(cardContents, CardWidth.MEDIUM, "+12223334444");
} catch(Exception e) {
e.printStackTrace();
}
Mã này là phần trích dẫn từ một tác nhân mẫu RBM.
Python
# Reference to RBM Python client helper and messaging object structure
from rcs_business_messaging import rbm_service
from rcs_business_messaging import messages
# Images for the carousel cards
card_image_1 = 'https://storage.googleapis.com/kitchen-sink-sample-images/cute-dog.jpg';
card_image_2 = 'https://storage.googleapis.com/kitchen-sink-sample-images/elephant.jpg';
# Suggested replies to be used in the cards
suggestions1 = [
messages.SuggestedReply('Card #1', 'reply:card_1')
]
suggestions2 = [
messages.SuggestedReply('Card #2', 'reply:card_2')
]
# Define the card contents for a carousel with two cards,
# each with one suggested reply
card_contents = []
card_contents.append(messages.CardContent('Card #1',
'The description for card #1',
card_image_1,
'MEDIUM',
suggestions1))
card_contents.append(messages.CardContent('Card #2',
'The description for card #2',
card_image_2,
'MEDIUM',
suggestions2))
# Send the device the carousel card defined above
carousel_card = messages.CarouselCard('MEDIUM', card_contents)
cluster = messages.MessageCluster().append_message(carousel_card)
cluster.send_to_msisdn('+12223334444')
Mã này là một phần trích dẫn từ trình đại diện mẫu RBM.
C#
using Google.Apis.RCSBusinessMessaging.v1.Data;
using RCSBusinessMessaging;
using RCSBusinessMessaging.Cards;
…
// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
projectId);
// Image references to be used in the carousel cards
string card1Image = "https://storage.googleapis.com/kitchen-sink-sample-images/cute-dog.jpg";
string card2Image = "https://storage.googleapis.com/kitchen-sink-sample-images/elephant.jpg";
// Suggestion chip lists to be used in carousel cards
List<Suggestion> suggestions1 = new List<Suggestion>
{
new SuggestionHelper("Card #1", "card_1").SuggestedReply()
};
List<Suggestion> suggestions2 = new List<Suggestion>
{
new SuggestionHelper("Card #2", "card_2").SuggestedReply()
};
// Create the card content for the carousel
List<CardContent> cardContents = new List<CardContent>
{
// Add items as card content
new StandaloneCardHelper(
"Card #1",
"The description for card #1",
card1Image,
suggestions1).GetCardContent(),
new StandaloneCardHelper(
"Card #2",
"The description for card #2",
card2Image,
suggestions2).GetCardContent()
};
// Send the carousel to the user
rbmApiHelper.SendCarouselCards(cardContents, CardWidth.MEDIUM, msisdn);
Mã này là một phần trích dẫn từ trình đại diện mẫu RBM.
Quay số
Mã sau đây sẽ gửi một Thao tác quay số đến một thiết bị có thư viện ứng dụng.
Node.js
// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');
// Define a dial suggested action
let suggestions = [
{
action: {
text: 'Call',
postbackData: 'postback_data_1234',
dialAction: {
phoneNumber: '+15556667777'
}
}
},
];
let params = {
messageText: 'Hello, world!',
msisdn: '+12223334444',
suggestions: suggestions,
};
// Send a simple message with a dial suggested action
rbmApiHelper.sendMessage(params, function(response) {
console.log(response);
});
Mã này là một phần trích dẫn từ trình đại diện mẫu RBM.
Java
import com.google.api.services.rcsbusinessmessaging.v1.model.DialAction;
import com.google.api.services.rcsbusinessmessaging.v1.model.SuggestedAction;
import com.google.api.services.rcsbusinessmessaging.v1.model.Suggestion;
import com.google.rbm.RbmApiHelper;
…
try {
// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper();
// Create suggestions for chip list
List<Suggestion> suggestions = new ArrayList<Suggestion>();
// creating a dial suggested action
DialAction dialAction = new DialAction();
dialAction.setPhoneNumber("+15556667777");
// creating a suggested action based on a dial action
SuggestedAction suggestedAction = new SuggestedAction();
suggestedAction.setText("Call");
suggestedAction.setPostbackData("postback_data_1234");
suggestedAction.setDialAction(dialAction);
// attaching action to a suggestion
Suggestion suggestion = new Suggestion();
suggestion.setAction(suggestedAction);
suggestions.add(suggestion);
// Send simple text message with the suggestion action
rbmApiHelper.sendTextMessage(
"Hello, world!",
"+12223334444",
suggestions
);
} catch(Exception e) {
e.printStackTrace();
}
Mã này là một phần trích dẫn từ trình đại diện mẫu RBM.
Python
# Reference to RBM Python client helper and messaging object structure
from rcs_business_messaging import rbm_service
from rcs_business_messaging import messages
# Create a dial suggested action
suggestions = [
messages.DialAction('Call', 'reply:postback_data_1234', '+15556667777')
]
# Create text message to send to user
text_msg = messages.TextMessage('Hello, world!')
cluster = messages.MessageCluster().append_message(text_msg)
# Append suggestions for the message to send to the user
for suggestion in suggestions:
cluster.append_suggestion_chip(suggestion)
# Send a simple message with suggested action to the device
cluster.send_to_msisdn('+12223334444')
Mã này là phần trích dẫn từ một tác nhân mẫu RBM.
C#
using Google.Apis.RCSBusinessMessaging.v1.Data;
using RCSBusinessMessaging;
…
// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
projectId);
// Create a dial an agent suggested action
DialAction dialAction = new DialAction
{
PhoneNumber = "+15556667777"
};
// Creating a suggested action based on a dial action
SuggestedAction suggestedAction = new SuggestedAction
{
Text = "Call",
PostbackData = "postback_data_1234",
DialAction = dialAction
};
// Attach action to a suggestion
Suggestion suggestion = new Suggestion
{
Action = suggestedAction
};
List<Suggestion> suggestions = new List<Suggestion>
{
suggestion
};
rbmApiHelper.SendTextMessage(
"Hello, world!",
"+12223334444",
suggestions
);
Mã này là một phần trích dẫn từ trình đại diện mẫu RBM.
Xem một vị trí
Đoạn mã sau đây sẽ gửi một View location action (Xem thao tác vị trí) đến một thiết bị có thư viện ứng dụng.
Node.js
// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');
// Define a view location suggested action
let suggestions = [
{
action: {
text: 'View map',
postbackData: 'postback_data_1234',
viewLocationAction: {
latLong: {
latitude: 37.4220188,
longitude: -122.0844786
},
label: 'Googleplex'
}
}
},
];
let params = {
messageText: 'Hello, world!',
msisdn: '+12223334444',
suggestions: suggestions,
};
// Send a simple message with a view location suggested action
rbmApiHelper.sendMessage(params, function(response) {
console.log(response);
});
Mã này là phần trích dẫn từ một tác nhân mẫu RBM.
Java
import com.google.api.services.rcsbusinessmessaging.v1.model.ViewLocationAction;
import com.google.api.services.rcsbusinessmessaging.v1.model.SuggestedAction;
import com.google.api.services.rcsbusinessmessaging.v1.model.Suggestion;
import com.google.rbm.RbmApiHelper;
…
try {
// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper();
// Create suggestions for chip list
List<Suggestion> suggestions = new ArrayList<Suggestion>();
// creating a view location suggested action
ViewLocationAction viewLocationAction = new ViewLocationAction();
viewLocationAction.setQuery("Googleplex, Mountain View, CA");
// creating a suggested action based on a view location action
SuggestedAction suggestedAction = new SuggestedAction();
suggestedAction.setText("View map");
suggestedAction.setPostbackData("postback_data_1234");
suggestedAction.setViewLocationAction(viewLocationAction);
// attaching action to a suggestion
Suggestion suggestion = new Suggestion();
suggestion.setAction(suggestedAction);
suggestions.add(suggestion);
// Send simple text message with the suggestion action
rbmApiHelper.sendTextMessage(
"Hello, world!",
"+12223334444",
suggestions
);
} catch(Exception e) {
e.printStackTrace();
}
Mã này là một phần trích dẫn từ trình đại diện mẫu RBM.
Python
# Reference to RBM Python client helper and messaging object structure
from rcs_business_messaging import rbm_service
from rcs_business_messaging import messages
# Create a view location suggested action
suggestions = [
messages.ViewLocationAction('View map',
'reply:postback_data_1234',
query='Googleplex, Mountain View, CA')
]
# Create text message to send to user
text_msg = messages.TextMessage('Hello, world!')
cluster = messages.MessageCluster().append_message(text_msg)
# Append suggestions for the message to send to the user
for suggestion in suggestions:
cluster.append_suggestion_chip(suggestion)
# Send a simple message with suggested action to the device
cluster.send_to_msisdn('+12223334444')
Mã này là một phần trích dẫn từ trình đại diện mẫu RBM.
C#
using Google.Apis.RCSBusinessMessaging.v1.Data;
using RCSBusinessMessaging;
…
// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
projectId);
// create an view location action
ViewLocationAction viewLocationAction = new ViewLocationAction
{
Query = "Googleplex Mountain View, CA"
};
// Attach the view location action to a suggested action
SuggestedAction suggestedAction = new SuggestedAction
{
ViewLocationAction = viewLocationAction,
Text = "View map",
PostbackData = "postback_data_1234"
};
// Attach the action to a suggestion object
Suggestion suggestion = new Suggestion
{
Action = suggestedAction
};
List<Suggestion> suggestions = new List<Suggestion>
{
suggestion
};
rbmApiHelper.SendTextMessage(
"Hello, world!",
"+12223334444",
suggestions
);
Mã này là một phần trích dẫn từ trình đại diện mẫu RBM.
Chia sẻ vị trí
Mã sau đây sẽ gửi một Thao tác chia sẻ vị trí đến một thiết bị có thư viện ứng dụng.
Node.js
// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');
// Define a share location suggested action
let suggestions = [
{
action: {
text: 'Share your location',
postbackData: 'postback_data_1234',
shareLocationAction: {
}
}
},
];
let params = {
messageText: 'Hello, world!',
msisdn: '+12223334444',
suggestions: suggestions,
};
// Send a simple message with a share location suggested action
rbmApiHelper.sendMessage(params, function(response) {
console.log(response);
});
Mã này là một phần trích dẫn từ trình đại diện mẫu RBM.
Java
import com.google.api.services.rcsbusinessmessaging.v1.model.ShareLocationAction;
import com.google.api.services.rcsbusinessmessaging.v1.model.SuggestedAction;
import com.google.api.services.rcsbusinessmessaging.v1.model.Suggestion;
import com.google.rbm.RbmApiHelper;
…
try {
// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper();
// Create suggestions for chip list
List<Suggestion> suggestions = new ArrayList<Suggestion>();
// creating a share location suggested action
ShareLocationAction shareLocationAction = new ShareLocationAction();
// creating a suggested action based on a share location action
SuggestedAction suggestedAction = new SuggestedAction();
suggestedAction.setText("Share location");
suggestedAction.setPostbackData("postback_data_1234");
suggestedAction.setShareLocationAction(shareLocationAction);
// attaching action to a suggestion
Suggestion suggestion = new Suggestion();
suggestion.setAction(suggestedAction);
suggestions.add(suggestion);
// Send simple text message with the suggestion action
rbmApiHelper.sendTextMessage(
"Hello, world!",
"+12223334444",
suggestions
);
} catch(Exception e) {
e.printStackTrace();
}
Mã này là một phần trích dẫn từ trình đại diện mẫu RBM.
Python
# Reference to RBM Python client helper and messaging object structure
from rcs_business_messaging import rbm_service
from rcs_business_messaging import messages
# Create a share location suggested action
suggestions = [
messages.ShareLocationAction('Share location',
'reply:postback_data_1234')
]
# Create text message to send to user
text_msg = messages.TextMessage('Hello, world!')
cluster = messages.MessageCluster().append_message(text_msg)
# Append suggestions for the message to send to the user
for suggestion in suggestions:
cluster.append_suggestion_chip(suggestion)
# Send a simple message with suggested action to the device
cluster.send_to_msisdn('+12223334444')
Mã này là một phần trích dẫn từ trình đại diện mẫu RBM.
C#
using Google.Apis.RCSBusinessMessaging.v1.Data;
using RCSBusinessMessaging;
…
// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
projectId);
// Create a share location action
ShareLocationAction shareLocationAction = new ShareLocationAction();
// Attach the share location action to a suggested action
SuggestedAction suggestedAction = new SuggestedAction
{
ShareLocationAction = shareLocationAction,
Text = "Share location",
PostbackData = "postback_data_1234"
};
// Attach the action to a suggestion object
Suggestion suggestion = new Suggestion
{
Action = suggestedAction
};
List<Suggestion> suggestions = new List<Suggestion>
{
suggestion
};
rbmApiHelper.SendTextMessage(
"Hello, world!",
"+12223334444",
suggestions
);
Mã này là phần trích dẫn từ một tác nhân mẫu RBM.
Mở URL
Mã sau đây sẽ gửi một Thao tác mở URL đến một thiết bị có thư viện ứng dụng.
Node.js
// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');
// Define an open URL suggested action
let suggestions = [
{
action: {
text: 'Open Google',
postbackData: 'postback_data_1234',
openUrlAction: {
url: 'https://www.google.com'
}
}
},
];
let params = {
messageText: 'Hello, world!',
msisdn: '+12223334444',
suggestions: suggestions,
};
// Send a simple message with an open URL suggested action
rbmApiHelper.sendMessage(params, function(response) {
console.log(response);
});
Mã này là phần trích dẫn từ một tác nhân mẫu RBM.
Java
import com.google.api.services.rcsbusinessmessaging.v1.model.OpenUrlAction;
import com.google.api.services.rcsbusinessmessaging.v1.model.SuggestedAction;
import com.google.api.services.rcsbusinessmessaging.v1.model.Suggestion;
import com.google.rbm.RbmApiHelper;
…
try {
// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper();
// Create suggestions for chip list
List<Suggestion> suggestions = new ArrayList<Suggestion>();
// creating an open url suggested action
OpenUrlAction openUrlAction = new OpenUrlAction();
openUrlAction.setUrl("https://www.google.com");
// creating a suggested action based on an open url action
SuggestedAction suggestedAction = new SuggestedAction();
suggestedAction.setText("Open Google");
suggestedAction.setPostbackData("postback_data_1234");
suggestedAction.setOpenUrlAction(openUrlAction);
// attaching action to a suggestion
Suggestion suggestion = new Suggestion();
suggestion.setAction(suggestedAction);
suggestions.add(suggestion);
// Send simple text message with the suggestion action
rbmApiHelper.sendTextMessage(
"Hello, world!",
"+12223334444",
suggestions
);
} catch(Exception e) {
e.printStackTrace();
}
Mã này là phần trích dẫn từ một tác nhân mẫu RBM.
Python
# Reference to RBM Python client helper and messaging object structure
from rcs_business_messaging import rbm_service
from rcs_business_messaging import messages
# Create an open url suggested action
suggestions = [
messages.OpenUrlAction('Open Google',
'reply:postback_data_1234',
'https://www.google.com')
]
# Create text message to send to user
text_msg = messages.TextMessage('Hello, world!')
cluster = messages.MessageCluster().append_message(text_msg)
# Append suggestions for the message to send to the user
for suggestion in suggestions:
cluster.append_suggestion_chip(suggestion)
# Send a simple message with suggested action to the device
cluster.send_to_msisdn('+12223334444')
Mã này là một phần trích dẫn từ trình đại diện mẫu RBM.
C#
using Google.Apis.RCSBusinessMessaging.v1.Data;
using RCSBusinessMessaging;
…
// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
projectId);
// Create an open url action
OpenUrlAction openUrlAction = new OpenUrlAction
{
Url = "https://www.google.com"
};
// Attach the open url action to a suggested action
SuggestedAction suggestedAction = new SuggestedAction
{
OpenUrlAction = openUrlAction,
Text = "Open Google",
PostbackData = "postback_data_1234"
};
// Attach the action to a suggestion object
Suggestion suggestion = new Suggestion
{
Action = suggestedAction
};
List<Suggestion> suggestions = new List<Suggestion>
{
suggestion
};
rbmApiHelper.SendTextMessage(
"Hello, world!",
"+12223334444",
suggestions
);
Mã này là một phần trích dẫn từ trình đại diện mẫu RBM.
Tạo sự kiện lịch
Mã sau đây sẽ gửi một Thao tác tạo sự kiện trên lịch đến một thiết bị có thư viện ứng dụng.
Node.js
// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');
// Define a create calendar event suggested action
let suggestions = [
{
action: {
text: 'Save to calendar',
postbackData: 'postback_data_1234',
createCalendarEventAction: {
startTime: '2020-06-30T19:00:00Z',
endTime: '2020-06-30T20:00:00Z',
title: 'My calendar event',
description: 'Description of the calendar event',
},
}
},
];
let params = {
messageText: 'Hello, world!',
msisdn: '+12223334444',
suggestions: suggestions,
};
// Send a simple message with a create calendar event suggested action
rbmApiHelper.sendMessage(params, function(response) {
console.log(response);
});
Mã này là một phần trích dẫn từ trình đại diện mẫu RBM.
Java
import com.google.api.services.rcsbusinessmessaging.v1.model.CreateCalendarEventAction;
import com.google.api.services.rcsbusinessmessaging.v1.model.SuggestedAction;
import com.google.api.services.rcsbusinessmessaging.v1.model.Suggestion;
import com.google.rbm.RbmApiHelper;
…
try {
// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper();
// Create suggestions for chip list
List<Suggestion> suggestions = new ArrayList<Suggestion>();
// creating a create calendar event suggested action
CreateCalendarEventAction createCalendarEventAction = new CreateCalendarEventAction();
calendarEventAction.setTitle("My calendar event");
calendarEventAction.setDescription("Description of the calendar event");
calendarEventAction.setStartTime("2020-06-30T19:00:00Z");
calendarEventAction.setEndTime("2020-06-30T20:00:00Z");
// creating a suggested action based on a create calendar event action
SuggestedAction suggestedAction = new SuggestedAction();
suggestedAction.setText("Save to calendar");
suggestedAction.setPostbackData("postback_data_1234");
suggestedAction.setCreateCalendarEventAction(createCalendarEventAction);
// attaching action to a suggestion
Suggestion suggestion = new Suggestion();
suggestion.setAction(suggestedAction);
suggestions.add(suggestion);
// Send simple text message with the suggestion action
rbmApiHelper.sendTextMessage(
"Hello, world!",
"+12223334444",
suggestions
);
} catch(Exception e) {
e.printStackTrace();
}
Mã này là một phần trích dẫn từ trình đại diện mẫu RBM.
Python
# Reference to RBM Python client helper and messaging object structure
from rcs_business_messaging import rbm_service
from rcs_business_messaging import messages
# Create a calendar event suggested action
suggestions = [
messages.CreateCalendarEventAction('Save to Calendar',
'reply:postback_data_1234',
'2020-06-30T19:00:00Z',
'2020-06-30T20:00:00Z',
'My calendar event',
'Description of the calendar event')
]
# Create text message to send to user
text_msg = messages.TextMessage('Hello, world!')
cluster = messages.MessageCluster().append_message(text_msg)
# Append suggestions for the message to send to the user
for suggestion in suggestions:
cluster.append_suggestion_chip(suggestion)
# Send a simple message with suggested action to the device
cluster.send_to_msisdn('+12223334444')
Mã này là một phần trích dẫn từ trình đại diện mẫu RBM.
C#
using Google.Apis.RCSBusinessMessaging.v1.Data;
using RCSBusinessMessaging;
…
// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
projectId);
// Create a calendar event action
CreateCalendarEventAction calendarEventAction = new CreateCalendarEventAction
{
Title = "My calendar event",
Description = "Description of the calendar event",
StartTime = "2020-06-30T19:00:00Z",
EndTime = "2020-06-30T20:00:00Z"
};
// Attach the calendar event action to a suggested action
SuggestedAction suggestedAction = new SuggestedAction
{
CreateCalendarEventAction = calendarEventAction,
Text = "Save to calendar",
PostbackData = "postback_data_1234"
};
// Attach the action to a suggestion object
Suggestion suggestion = new Suggestion
{
Action = suggestedAction
};
List<Suggestion> suggestions = new List<Suggestion>
{
suggestion
};
rbmApiHelper.SendTextMessage(
"Hello, world!",
"+12223334444",
suggestions
);
Mã này là phần trích dẫn từ một tác nhân mẫu RBM.
Thu hồi thư
Trong ví dụ sau, rbm_api_helper.js (không dùng cho Python) giả định rằng tệp bạn đang làm việc là một thư mục bên dưới thư mục ứng dụng chính. Bạn có thể cần điều chỉnh vị trí tuỳ thuộc vào cấu hình của dự án.
Mã sau đây thu hồi một thông báo hiện có chưa được phân phối bằng thư viện ứng dụng.
Node.js
// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');
// Stop the message associated with messageId from being delivered
rbmApiHelper.revokeMessage('+12223334444', messageId, function(err, response) {
console.log(response);
});
Mã này là phần trích dẫn từ một tác nhân mẫu RBM.
Java
import com.google.rbm.RbmApiHelper;
…
try {
// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper();
// Stop the message associated with messageId from being delivered
rbmApiHelper.revokeMessage(messageId, "+12223334444");
} catch(Exception e) {
e.printStackTrace();
}
Mã này là phần trích dẫn từ một tác nhân mẫu RBM.
Python
# Reference to RBM Python client helper and messaging object structure
from rcs_business_messaging import rbm_service
# Stop the message associated with message_id from being delivered
rbm_service.revoke('+12223334444', message_id)
Mã này là phần trích dẫn từ một tác nhân mẫu RBM.
C#
using RCSBusinessMessaging;
…
// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
projectId);
// Stop the message associated with messageId from being delivered
rbmApiHelper.RevokeMessage(messageId, "+12223334444");
Mã này là một phần trích dẫn từ trình đại diện mẫu RBM.
Gửi sự kiện
Trong các ví dụ sau, rbm_api_helper.js (không dùng cho Python) giả định rằng tệp bạn đang làm việc là một thư mục bên dưới thư mục ứng dụng chính. Có thể bạn cần điều chỉnh vị trí tuỳ thuộc vào cấu hình của dự án.
Đọc sự kiện
Sự kiện đọc cho người dùng biết rằng nhân viên hỗ trợ đã nhận được thông báo và giúp họ tin tưởng rằng nền tảng RBM đã phân phối thông báo của họ. Mã sau đây sẽ gửi một sự kiện đọc đến một thiết bị có thư viện ứng dụng.
Node.js
// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');
// Send the device an event to indicate that messageId has been read
rbmApiHelper.sendReadMessage('+12223334444', messageId);
Mã này là một phần trích dẫn từ trình đại diện mẫu RBM.
Java
import com.google.rbm.RbmApiHelper; … // Create an instance of the RBM API helper RbmApiHelper rbmApiHelper = new RbmApiHelper(); // Send the device an event to indicate that messageId has been read rbmApiHelper.sendReadMessage(messageId, "+12223334444");Mã này là phần trích dẫn từ một tác nhân mẫu RBM.
Python
# Reference to RBM Python client helper and messaging object structure
from rcs_business_messaging import rbm_service
# Send the device an event to indicate that message_id was read
rbm_service.send_read_event('+12223334444', message_id)
Mã này là một phần trích dẫn từ trình đại diện mẫu RBM.
C#
using RCSBusinessMessaging;
…
// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
projectId);
// Send the device an event to indicate that messageId has been read
rbmApiHelper.SendReadMessage(messageId, "+12223334444");
Mã này là phần trích dẫn từ một tác nhân mẫu RBM.
Sự kiện nhập
Sự kiện nhập cho người dùng biết rằng nhân viên hỗ trợ đang soạn tin nhắn. Mã sau đây sẽ gửi một sự kiện nhập đến một thiết bị có thư viện ứng dụng.
Node.js
// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');
// Send the device an event to indicate that the agent is typing
rbmApiHelper.sendIsTypingMessage('+12223334444', function() {
console.log('Typing event sent!');
});
Mã này là một phần trích dẫn từ trình đại diện mẫu RBM.
Java
import com.google.rbm.RbmApiHelper;
…
// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper();
// Send the device an event to indicate that the agent is typing
rbmApiHelper.sendIsTypingMessage("+12223334444");
Mã này là phần trích dẫn từ một tác nhân mẫu RBM.
Python
# Reference to RBM Python client helper and messaging object structure
from rcs_business_messaging import rbm_service
# Send the device an event to indicate that the agent is typing
rbm_service.send_is_typing_event('+12223334444')
Mã này là một phần trích dẫn từ trình đại diện mẫu RBM.
C#
using RCSBusinessMessaging;
…
// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
projectId);
// Send the device an event to indicate that the agent is typing
rbmApiHelper.SendIsTypingMessage(messageId, "+12223334444");
Mã này là phần trích dẫn từ một tác nhân mẫu RBM.
Các bước tiếp theo
Hãy xem các phương pháp hay nhất và mẫu của nhân viên hỗ trợ RBM để tìm hiểu về nền tảng này và những việc mà nền tảng này có thể làm.