Mobile SDK
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 digital 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
e os aplicativos Android devem ser escritos em Kotlin
.
Com o Mobile SDK:
- Você pode implementar os canais de Chat ao Vivo e Mensagem de Chat.
- Chat ao Vivo são mensagens em tempo real.
- Mensagem de Chat são mensagens assíncronas, como mensagens diretas (DMs).
- Os contatos podem ter várias interações com seu centro de contato ao mesmo tempo por meio de mensagens multi-thread
Se seu aplicativo for para várias conversas, seus contatos poderão criar quantas conversas desejarem para discutir novos tópicos. Essas conversas podem estar ativas ao mesmo tempo.. Você também pode definir uma configuração single-thread
Em um aplicativo de conversa única, cada contato pode ter apenas uma conversa de chat. Qualquer interação que eles tenham com sua organização ocorre nessa conversa de chat..
- Você pode usar mídia avançada para adicionar mensagens interativas, como respostas rápidas, listas ou links ao seu chat no aplicativo.
- Os contatos e agentes podem compartilhar anexos entre si, como vídeos e documentos.
- Os contatos e agentes podem permanecer engajados vendo quando o outro está digitando.
- Você pode acionar notificações no aplicativo e por push com base em eventos, como a chegada de uma nova mensagem.
- Você pode criar regras proativas para exibir conteúdo no aplicativo com base em eventos ou condições.
- Você pode iniciar interações com mensagens de boas-vindas e formulários de pré-chat para coletar informações iniciais de um contato.
Para ver rapidamente os benefícios do SDK, você pode conferir o Mobile SDKficha de dados do . Você também pode assistir a um breve vídeo de demonstração
.

Um kit de desenvolvimento de software (SDK) é como uma caixa de ferramentas para desenvolvedores. Ele fornece um conjunto de ferramentas e recursos que facilitam a criação de aplicativos de software. Você poderia pensar nisso como uma coleção de blocos de construção pré-fabricados. Esses blocos de construção possuem funcionalidades existentes. Seus desenvolvedores podem usar esses blocos existentes em vez de criar a funcionalidade por conta própria desde o início. A seguir estão quatro benefícios gerais do uso de um SDK:
-
Eficiência: O SDK fornece ferramentas prontas e componentes pré-criados que economizam o tempo dos desenvolvedores. Em vez de reinventar a roda, eles podem concentrar-se nos aspectos únicos do aplicativo.
-
Consistência: O SDK garante a consistência entre diferentes aplicativos. Ao usar o mesmo conjunto de ferramentas e bibliotecas, os desenvolvedores mantêm uma experiência uniforme para os usuários.
-
Compatibilidade de plataformas: Os SDKs iOS e Android são personalizados para seus respectivos plataformas. Eles lidam com complexidades específicas do plataforma, facilitando a criação de aplicativos de plataforma cruzada.
-
Controle de qualidade: Com o logger, os desenvolvedores podem verificar seu código, detectar bugs antecipadamente e fornecer um software mais confiável.
Em resumo, um SDK simplifica o desenvolvimento, garante a qualidade e estimula a colaboração, tornando-o uma ferramenta essencial para uma criação de aplicativo eficiente.
Recursos de SDK
Baixe os pacotes SDK de repositórios GitHub públicos (Android iOS
). 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 iOS
).
Seus desenvolvedores também pode conferir os aplicativos de amostra para plataformas Android e iOS
. 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.
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 iOS
) 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 contato
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 (ACD > Digital > Pontos de Contato Digital > Chat > Inicialização e teste).
-
BrandId: É como o ID do locatário
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 (ACD > Digital > Pontos de Contato Digital > Chat > Inicializaçã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.