Package com.bytedesk.social.messenger

Class MessengerGuestApiService

java.lang.Object

com.bytedesk.social.messenger.MessengerGuestApiService

@Service
public class MessengerGuestApiService
extends Object

Messenger访客模式服务 https://developers.facebook.com/docs/messenger-platform/discovery/facebook-chat-plugin/guest-mode Guest Mode允许用户通过Chat Plugin与企业聊天，无需登录Facebook账户

Field Summary

Fields

Modifier and Type	Field	Description
private final String	BASE_URL
private org.springframework.web.client.RestTemplate	restTemplate

Constructor Summary

Constructors

Constructor	Description
MessengerGuestApiService()

Method Summary

Modifier and Type	Method	Description
Map<String,Object>	checkGuestUpgradeStatus(String guestId, String accessToken)	检查访客用户是否已升级(转换为登录用户)
Map<String,Object>	getGuestConversation(String guestId, String accessToken)	获取与访客用户的对话历史
Map<String,Object>	getGuestProfile(String guestId, String accessToken)	获取访客用户的个人资料信息
Map<String,Object>	handleGuestReferral(com.fasterxml.jackson.databind.JsonNode payload)	处理来自访客用户的messaging_referrals webhook事件
Map<String,Object>	handleGuestTermination(com.fasterxml.jackson.databind.JsonNode payload)	处理访客用户终止聊天的webhook事件
Map<String,Object>	handleGuestUpgrade(com.fasterxml.jackson.databind.JsonNode payload)	处理访客用户升级到登录用户的webhook事件
Map<String,Object>	sendMessageToGuest(String guestId, String messageText, String messagingType, String accessToken)	向访客用户发送消息
Map<String,Object>	setGuestModeEnabled(String pageId, boolean enabled, String accessToken)	设置访客模式的开关状态

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

restTemplate

@Autowired
private org.springframework.web.client.RestTemplate restTemplate

BASE_URL

private final String BASE_URL

See Also:

• Constant Field Values

Constructor Details

MessengerGuestApiService

public MessengerGuestApiService()

Method Details

handleGuestReferral

public Map<String,Object> handleGuestReferral(com.fasterxml.jackson.databind.JsonNode payload)

处理来自访客用户的messaging_referrals webhook事件

Parameters:

payload - 包含is_guest_user=true标志的webhook负载

Returns:

处理结果

handleGuestTermination

public Map<String,Object> handleGuestTermination(com.fasterxml.jackson.databind.JsonNode payload)

处理访客用户终止聊天的webhook事件

Parameters:

payload - 包含type=END_CHAT的webhook负载

Returns:

处理结果

handleGuestUpgrade

public Map<String,Object> handleGuestUpgrade(com.fasterxml.jackson.databind.JsonNode payload)

处理访客用户升级到登录用户的webhook事件

Parameters:

payload - 包含type=GUEST_UPGRADE的webhook负载

Returns:

处理结果，包含关联的PSID

getGuestProfile

public Map<String,Object> getGuestProfile(String guestId,
 String accessToken)

获取访客用户的个人资料信息

Parameters:

guestId - 访客用户ID

accessToken - 页面访问令牌

Returns:

访客用户的个人资料信息

getGuestConversation

public Map<String,Object> getGuestConversation(String guestId,
 String accessToken)

获取与访客用户的对话历史

Parameters:

guestId - 访客用户ID

accessToken - 页面访问令牌

Returns:

对话历史数据

sendMessageToGuest

public Map<String,Object> sendMessageToGuest(String guestId,
 String messageText,
 String messagingType,
 String accessToken)

向访客用户发送消息

Parameters:

guestId - 访客用户ID

messageText - 消息文本

messagingType - 消息类型，如RESPONSE、UPDATE等

accessToken - 页面访问令牌

Returns:

发送结果

checkGuestUpgradeStatus

public Map<String,Object> checkGuestUpgradeStatus(String guestId,
 String accessToken)

检查访客用户是否已升级(转换为登录用户)

Parameters:

guestId - 访客用户ID

accessToken - 页面访问令牌

Returns:

是否已升级及相关信息

setGuestModeEnabled

public Map<String,Object> setGuestModeEnabled(String pageId,
 boolean enabled,
 String accessToken)

设置访客模式的开关状态

Parameters:

pageId - 页面ID

enabled - 是否启用访客模式

accessToken - 页面访问令牌

Returns:

设置结果