--- sourceDocument: Yokohama Customer Service Management sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/customer-service-management Release : - yokohama ft:locale : - pt-BR ft:publication_title : - Yokohama Customer Service Management ft:clusterId : - csm bundleId : - csm workflow : - Customer and Industry --- # Incorporado App de mensagens de interaçãoem sua aplicação web # Incorporado App de mensagens de interaçãoem sua aplicação web {#ariaid-title1} * Versão de lançamento: Yokohama * * Atualizado 30 de jan. de 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 min. de leitura Incorpore o código-fonte do módulo do messenger que você configurou em seu site para que você possa permitir que seus clientes comecem a usar o. App de mensagens de interaçãoem seu site. ## Antes de Iniciar * [Ative um App de mensagens de interaçãomódulo](https://servicenow-prod.fluidtopics.net/JQyz0f75DU2sDGGAxI8Pyw "Ative o. App de mensagens de interaçãomódulo que você configurou para que possa incorporá-lo ao seu site."). * Função necessária: sn_csm_ec.ec_admin {#embed-engagement-messenger-code-in-your-web-application__ul_kvl_4pf_g4b} ## Por Que e Quando Desempenhar Esta Tarefa Copie o código-fonte do módulo do messenger que você ativou e cole-o no arquivo html do site onde você deseja implantar o messenger. Em seguida, dependendo do tipo de autenticação selecionado para o módulo de messenger configurado, talvez seja necessário escrever o código para as funções para obter o token de ID e iniciar e interromper a sessão de um usuário conectado no messenger. ## Procedimento 1. Navegar até TudoApp de mensagens de interaçãoMódulos. 2. Na coluna Editar módulo do módulo do messenger que você deseja instalar em seu site, clique em Editar . A exibição da configuração assistida é exibida. 3. Clique em Implementar . 4. Se você tiver feito alguma mudança na seção Configurações de segurança, clique em Salvar . O código do App de mensagens de interaçãoo módulo foi atualizado. 5. Role para baixo até a seção Código de incorporação e clique em Código de cópia . 6. Abra o arquivo HTML do seu site e cole o código copiado antes do marcador body de fechamento. 7. Para um módulo de messenger com autenticação baseada em OIDC ou baseada em SAML, conclua a configuração a seguir. | Tipo de autenticação | Ação | | Baseada em OIDC | 1. Escreva o código para GetTokenCallBack() função. 2. Ligue para SN_CSM_EC.ONLOGIN() sempre que os usuários fizerem login no seu site. Esta função permite que usuários autenticados façam login em App de mensagens de interaçãoperfeitamente quando eles fazem login no seu site. 3. Ligue para SN_CSM_EC.ONLOGOUT() sempre que os usuários fazem logout do seu site. Esta função permite que usuários autenticados façam logout perfeitamente do App de mensagens de interaçãoe seu site. {#embed-engagement-messenger-code-in-your-web-application__ol_dns_wtl_p4b} | | Baseada em SAML | 1. Ligue para SN_CSM_EC.ONLOGIN() sempre que os usuários fizerem login no seu site. Esta função permite que usuários autenticados façam login em App de mensagens de interaçãoperfeitamente quando eles fazem login no seu site. 2. Ligue para SN_CSM_EC.ONLOGOUT() sempre que os usuários fazem logout do seu site. Esta função permite que usuários autenticados façam logout perfeitamente do App de mensagens de interaçãoe seu site. {#embed-engagement-messenger-code-in-your-web-application__ol_cmk_25l_p4b} | |-|-| {#embed-engagement-messenger-code-in-your-web-application__choicetable_vhq_vtl_p4b} 8. Se você habilitou o recurso de balcão para usuários não autenticados, remova o comentário //guestWalkupBaseUrlE conclua a configuração inserindo o URL base do seu portal de suporte ao cliente. Por exemplo, se o seu portal de suporte ao cliente for https://www.example.com/support , em seguida, atualize o código para GuestWalkupBaseUrl: https://www.example.com/support Figura 1. Copie o código do Messenger de compromisso 9. **Opcional:** Para modificar o código de incorporação para definir o idioma preferencial no qual App de mensagens de interaçãofor exibido, execute um dos procedimentos a seguir. | Opção | Descrição | | `Idioma: (Código ISO-locale)` | Permite que você carregue App de mensagens de interaçãocom um idioma fixo. | | `SetLang : getEMLanguage` | Permite alternar dinamicamente o idioma no qual App de mensagens de interaçãoé exibido. . `GetEMLanguage `O valor pode retornar qualquer código ISO-local que possa ser usado para o idioma do messenger. | |-|-| {#embed-engagement-messenger-code-in-your-web-application__choicetable_gmq_3zs_f5b} . `SetLang : getEMLanguage `a função tem preferência quando ambos os parâmetros estão disponíveis. No entanto, se o usuário tiver definido o idioma preferencial na tabela \[sys_user_preference\], App de mensagens de interaçãoserá exibido nesse idioma. Nota: Começando com Yokohamaversão, os clientes atualizados também podem modificar o código de incorporação para habilitar a alternância de idioma. 10. **Opcional:** Abra o site ao qual você adicionou o. App de mensagens de interaçãocódigo para verificar se o ícone do inicializador está disponível e clique no ícone para verificar se ele é iniciado App de mensagens de interação. 11. **Opcional:** Modifique o código de incorporação de App de mensagens de interaçãoPara integrar recomendações proativas em uma página da web. Para obter mais informações sobre como usar App de mensagens de interaçãoPara integrar as recomendações proativas em uma página da web, consulte [Uso App de mensagens de interaçãoCódigo incorporado para integrar recomendações proativas em uma página da web](https://servicenow-prod.fluidtopics.net/SnEhgfVHZmNTop6opKP72w "Modifique o código de incorporação de App de mensagens de interaçãopara habilitar recomendações e aprovar a consulta de pesquisa para recomendações com base em Pesquisa com IA."). ## O que Fazer Depois Abra o site ao qual você adicionou App de mensagens de interaçãoe verifique se o ícone do inicializador do messenger está disponível. Clique no ícone para iniciar o. App de mensagens de interação. Você também pode incorporar App de mensagens de interaçãoEm suas aplicações nativas para iOS e android usando o Now Mobile SDK: * [Incorporar o Messenger de engajamento em um app nativo para iOS usando o Now Mobile SDK \[KB1587276\]](https://support.servicenow.com/kb_view.do?sysparm_article=KB1587276) * [Envolver Messenger em um app nativo para android usando o Now Mobile SDK \[KB1587611\]](https://support.servicenow.com/kb_view.do?sysparm_article=KB1587611) {#embed-engagement-messenger-code-in-your-web-application__ul_w2c_2vq_21c}