Mobile SDK

Atual Versão: 2.2 (correlacionando com a versão 24.4 CXone Mpower)
Referências de API:

Para auxiliá-lo a começar a implementar o SDK para dispositivos móveis, é necessário adquirir o pacote básico de implementação do NICE. Um parceiro de NICE o conduz durante a implementação.

O Mobile SDK permite integrar o chat digital do CXone Mpower aos seus aplicativos de celular corporativos. Isso permite que os usuários do aplicativo conversem com os agentes e bots do centro de contato por meio de canais de chat digitalFechado Qualquer canal, contato ou competência que tenha associação ao Digital Experience.. O SDK simplifica o processo de implementação do chat digital; os desenvolvedores não precisam lidar com a implementação da lógica comercial. A principal tarefa de seus desenvolvedores é exibir e gerenciar visualmente os recursos que você configurou no CXone Mpower, como notificações por push ou mensagens avançadas. O SDK aceita aplicativos iOS e Android. Os aplicativos iOS devem ser escritos em Swift Este link é aberto em uma nova janela e os aplicativos Android devem ser escritos em Kotlin Este link é aberto em uma nova janela.

Com o Mobile SDK:

Para ver rapidamente os benefícios do SDK, você pode conferir o Mobile SDKficha de dados do Este link é aberto em uma nova janela. Você também pode assistir a um breve vídeo de demonstração Este link é aberto em uma nova janela.

Recursos de SDK

Baixe os pacotes SDK de repositórios GitHub públicos (Android Este link é aberto em uma nova janela iOS Este link é aberto em uma nova janela). Ambos os repositórios contêm um arquivo README para ajudar você a começar a desenvolver. Eles também oferecem casos de uso com exemplos de código em /docs. Use-os como inspiração ao desenvolver seu chat. Ambos os repositórios também incluem logs de alterações.

Você pode acessar as referências da API no seu navegador (Android Este link é aberto em uma nova janela iOS Este link é aberto em uma nova janela).

Seus desenvolvedores também pode conferir os aplicativos de amostra para plataformas Android Este link é aberto em uma nova janela e iOS Este link é aberto em uma nova janela. Isso ajuda os desenvolvedores a ver exemplos de funcionalidades implementadas.

Controle de versão do SDK para dispositivos móveis

As versões do SDK geralmente são atualizadas junto com as principais versões de marketing CXone Mpower, como 25.2, 25.3 e assim por diante. Além GitHub, cada versão de lançamento é marcada de acordo com o versionamento semântico explicado abaixo.

NICE suporta a versão principal atual e uma anterior do SDK. Por exemplo, se a versão atual for 2.2, NICE suporta v2.2 e 1.3 (a versão 1.x.x mais recente).

Você é responsável por manter seus aplicativo atualizados, pois o SDK também é atualizado. A seção Recursos de SDK acima fornece links para os recursos mais atualizados. Nos repositórios de SDK, você pode usar as tags para encontrar versões anteriores do SDK. Além disso, esteja ciente de que o SDK é compatível com versões anteriores nas duas últimas versões principais.

Versão Mudanças

Quando a versão do SDK muda de versão para versão, o número da versão indica o tipo de alteração. O seguinte explica a denotação:

  • 2.0,0: O primeiro número indica a mudança de API principal.

  • 2.1.0: O segundo número indica uma alteração sem quebra. Muitas vezes, novos recursos são adicionados como alterações ininterruptas.

  • 2.0.1: O terceiro número denota uma correção de bug. Estes são sempre compatíveis com versões anteriores.

Correções

NICE Professional Services trabalha com você em correções de bugs. Você pode enviar bugs por meio deles (ou do parceiro de implementação) e eles comunicam correções a você, além do log de alterações do SDK.

Além disso, quaisquer bugs são corrigidos nas versões atualmente suportadas. Por exemplo, se a versão atual for 3.0, as duas versões com suporte serão 3.0 e 2.3 (a versão mais recente da 2.x). Se você encontrou um bug na v2.1, NICE corrigi-lo para 2.3 e 3.0, mas não 2.1 ou 2.2.

Como o SDK para dispositivos móveis se encaixa no Digital Experience

O SDK para dispositivos móveis é uma maneira de estender Digital Experience e fornecer bate-papo digital em apps móveis. Digital Experience é a parte do CXone Mpower que processa os canais digitais. Exemplos de canais digitais são WhatsApp, posts no Facebook ou chat digital. Para adicionar CXone Mpower chat digital ao seu apps, você deve configurar alguns recursos na seção Digital Experience da interface CXone Mpower. Em seguida, com o SDK, você acessa e usa recursos configurados no CXone Mpower.

Por exemplo, parte do processo inicial é configurar um canal de chat digital no CXone Mpower. Em seguida, seu aplicativo deve criar uma conexão WebSocket com o canal de chat digital que você criou. Você também pode configurar recursos avançados, como mensagens de boas-vindas ou pesquisas pré-chat. Eles oferecem uma variedade de opções para simplificar a experiência dos usuários do aplicativo. Os usuários podem fornecer informações iniciais sobre seu problema ou solicitação, inserir dados pessoais básicos e assim por diante. Esses recursos são inicialmente configurados no CXone Mpower, que você pode usar com o SDK.

Diagrama da infraestrutura do SDK para dispositivos móveis

Criar a interface do usuário do chat

Como integrador, você é responsável por criar sua interface de chat. Isso é necessário para aproveitar certos recursos, como exibir e trabalhar com arquivos ou gravar mensagens de voz. Por exemplo, você precisaria adicionar um botão para os contatos pressionarem para acessar o microfone do dispositivo para gravar a mensagem. Você pode consultar os aplicativos de amostra (Android Este link é aberto em uma nova janela iOS Este link é aberto em uma nova janela) para obter exemplos de como implementar a interface do usuário.

Você pode usar um kit de desenvolvimento de IU de terceiros, como MessageKit. No entanto, isso pode ser limitante dependendo do seu caso de uso. Além disso, a CXone Mpower não possui nem fornece suporte para nenhum pacote de IU de terceiros.

Antes de começar a desenvolver

Considere os itens a seguir antes de criar com o SDK móvel:

  • Você tem uma conta de administrador e de agente no CXone Mpower? Um administrador pode ajudar você na configuração dos recursos necessários no CXone Mpowerplataforma?
  • Seu aplicativo móvel está disponível para iOS (Apple), Android, ou ambos? Seus desenvolvedores estão familiarizados com as linguagens Swift e Kotlin?
  • Você tem canais de mensagens de chat existentes ou quer criar um novo?
  • Você usará OAuth para autenticar os usuários do seu aplicativo? Se for, qual provedor de OAuth você usará?
  • Você deseja oferecer conversas single-thread ou multi-thread?
  • Você usará ações proativas como pop-ups ou mensagens de boas-vindas?
  • Você quer usar notificações por push? Você tem contas no Firebase ou no Apple Developer?
  • Que tipos de mensagens avançadas você quer configurar? Quais são alguns casos de uso em que você pode aproveitar essas mensagens interativas?
  • Você quer monitorar os dados do usuário? Como você pode usar os eventos de visitantes para gerar análises?

Termos-chave

  • Conversa: Uma conversa no aplicativo de chat. A primeira mensagem enviada pelo agente ou contatoFechado A pessoa que interage com um agente, RVI ou bot em seu centro de contato. inicia uma conversa. Cada mensagem consecutiva é adicionada à conversa. Conversas são objetos que contêm cada mensagem. As mensagens são estruturadas pelo autor da mensagem. Um threadId identifica uma conversa inteira e todas as mensagens dentro de uma conversa têm um ID de mensagem. Uma conversa termina quando o diálogo termina.

  • Single-Thread: Um design aplicativo onde o contato só pode ter uma conversa por vez.

  • Multi-Thread: Um design aplicativo onde o contato pode ter várias conversas ao mesmo tempo.

  • Canal: No contexto Digital Experience, canal refere-se ao tipo de mensagens ou ao plataforma usado para a comunicação. Por exemplo, você poderia ter um canal de mensagens em tempo real do WhatsApp. O SDK para dispositivos móveis permite adicionar um canal de mensagens de chat ao seu aplicativo móvel. Um canal é criado no CXone Mpowerplataforma. Isso determina as configurações do canal junto com um ID de canal. Você usa esse ID para iniciar o canal de chat quando um usuário do aplicativo abre o chat.

  • ChannelId: O ID do canal de chat digital criado na seção Digital do CXone Mpower. Você pode encontrar isso nas configurações do canal de chat no CXone Mpower (ACDDigitalPontos de Contato DigitalChatInicialização e teste).

  • BrandId: É como o ID do locatárioFechado Alto nível de agrupamento organizacional usado para gerenciar o suporte técnico, cobrança e configurações globais para o seu ambiente CXone Mpower do Digital Experience. É usado para inicializar o chat. Você pode encontrar isso nas configurações do canal de chat no CXone Mpower (ACDDigitalPontos de Contato DigitalChatInicialização e teste).

  • CustomerId: O ID exclusivo do usuário final do chat. O SDK cria esse ID quando o chat é inicializado. Se você tiver o OAuth configurado, esse ID permanecerá o mesmo para cada contato em todos os seus dispositivos. Caso não tenha configurado o OAuth, esse ID será diferente para cada dispositivo; o ID se tornará como um login de convidado.

  • Região ou ambiente: O local no mundo onde sua implantação do CXone Mpower está hospedada. Pode ser: Austrália (AU1), Canadá (CA1), Europa (EU1), Japão (JP1), América do Norte (NA1) ou Reino Unido (UK1). O desenvolvedor deve usar a mesma região onde seu sistema CXone Mpower está hospedado, caso contrário a conexão de chat será rejeitada.

  • Contato, Cliente e Usuário: Todos esses termos se referem ao usuário final do aplicativo móvel. A ajuda online normalmente usa o termo contato. Na documentação do SDK e nos comentários do código, é provável que você veja cliente e usuário.

  • CXone Mpower: O plataforma central, onde você gerencia e acessa todas as ferramentas de experiência do cliente que a CXone Mpower oferece. Dependendo dos recursos de chat que você quer oferecer em seu aplicativo móvel, um administrador com as permissões de conta de usuário necessárias deverá concluir diversas tarefas de configuração no CXone Mpower.

  • Digital Experience: A seção do CXone Mpower onde você pode gerenciar tudo sobre canais digitais.