Passando variáveis de contexto para o bate-papo Atendente e Virtual Agent

Você pode passar variáveis de contexto de bate-papo ao iniciar uma sessão de bate-papo, passando o parâmetro contextData.

Você pode passar este valor usando as funções NowChatService - startChat(contextData: [String: Qualquer]? = nulo, _ conclusão: @escaping (Resultado<Void, NowChatServiceError> ) -> Vazio).

Para obter informações adicionais sobre variáveis de contexto de bate-papo, consulte Live agent chat context variables.

Além disso, você também pode passar um parâmetro NowChatConfiguration opcional ao iniciar uma sessão de bate-papo para modificar parte do comportamento do NowChat.

• closePrompt: Texto de aviso que aparece antes de sair de uma janela de bate-papo. Você define este texto de aviso por meio dos seguintes parâmetros:
  • header: Valor de cadeia de caracteres anulável que aparece no cabeçalho do prompt.
  • message: Valor de cadeia de caracteres que aparece no corpo principal do prompt.
  • acceptButtonTitle: Valor de cadeia de caracteres que aparece no botão primário do prompt. Este botão fecha a janela de bate-papo.
  • declineButtonTitle: Valor de cadeia de caracteres que aparece no botão secundário do prompt. Este botão descarta o aviso sem fechar a janela de bate-papo.
• disabledFeatures: lista de recursos do NowChat a serem desabilitados. Consulte a classe de enumeração NowChatConfiguration.Feature para obter a lista de recursos que você pode desabilitar.
• conversationOptions: lista de opções de conversa a serem aplicadas ao NowChat. Consulte a classe de enumeração NowChatConvestation.ConversationOption para obter a lista de opções que você pode aplicar.
• uiConfiguration: valor de UIConfiguration usado para configurar componentes de IU no NowChat.

O exemplo de código a seguir mostra como chamar este método:

// Close Button Type
func closeButtonText(title: String?) -> NowChatConfiguration.CloseButtonType? {
  guard let title else { return nil }
  return .text(title)
}  
  
func closeButtonImage(name imageName: String?) -> NowChatConfiguration.CloseButtonType? {
  guard let imageName,
  let buttonImage = UIImage(named: imageName) else { return nil }
  return .image(buttonImage)	
}


// Create the chat UI
func makeChatScreen() -> UIViewController? {
  guard let chatService = chatService else { return nil }
  let closePrompt = NowChatConfiguration.ClosePrompt(header: "Close Window",
    message: "Are you sure you want to close the chat window?",
    acceptButtonTitle: "Yes",
    declineButtonTitle: "No")     

  let attachmentUploadButton = NowChatConfiguration.AttachmentUploadButton(isVisible: false) // default isVisible = true         

  let chatConfiguration = NowChatConfiguration(closePrompt: closePrompt,
    disabledFeatures: [.startNewConversation],
    conversationOptions: [.forceNewConversation, .endConversationOnExit],
    uiConfiguration: NowChatConfiguration.UIConfiguration(closeButton: closeButtonImage(name: "arrow.left"), attachmentUploadButton: attachmentUploadButton))

  let result = chatService.makeChatUI(theme: CarrascoChatTheme(chatColors: ChatColors()), chatConfiguration: chatConfiguration)
         
  switch result {
    case .success(let chatViewController): 
      return chatViewController
    case .failure(let error):
      debugPrint("Chat screen creation failed with error: \(error)")
      return nil
  }
} 

// Start the chat session
func startChat() {
  guard let chatService = chatService else {
    debugPrint("Chat service is invalid")
    viewState = makeViewState()
    return
  } 
  chatService.startChat { [weak self] result in
    if case .failure(let error) = result {
      debugPrint("Chat session initialization failed with error: \(error)")
      self?.resetChat()
    }
  }
 }

// Initialize the chat service
private func initializeChatService() {
  NowChat.makeChatService(instanceUrl: instanceUrl, delegate: self) { [weak self] result in
    guard let self = self else { return }
    switch result {
      case .success(let service):
        self.chatService = service
      case .failure(let error):
        debugPrint("Creating the chat service failed with error: \(error)") 
    } 
    self.viewState = self.makeViewState()
  }
}