Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Importante: é importante que você já possua conhecimento sobre a forma simplificada de embutir funcionalidades, disponíveis neste link: .

Passo 1

...

- obtendo código de embed + liberando origem para renderização

Obtenha o código de incorporação A primeira etapa é gerar o código de incorporação no aplicativo. Siga estas etapas para obtê-lo:

  • Acesse a funcionalidade de "embutir" no painel público, disponível em:

    • Configurador de funcionalidades → Botão Editar ou Visualizar (escolha um dos 2) → Visualize as propriedades da funcionalidade que deseja embutir → Localize a aba “Embutir”.

...

  • Será exibido um código JavaScript gerado automaticamente. Copie esse código para a área de transferência.

...

Nota

IMPORTANTE: Todos os trechos de código precisam ser utilizados na configuração da sua página. Ou seja, copie / cole os códigos 1, 2, 3 e 4. Sua aplicação não vai funcionar corretamente se deixar de copiar um ou mais desses códigos.

Passo 2

Configurar a segurança Para garantir que a funcionalidade de incorporação esteja disponível apenas em domínios autorizados, você precisa configurar a segurança adequada. Siga estas etapas para configurar as origens permitidas:

  • Acesse a seção "Segurança" do configurador públuico.

  • Localize a opção de "Cadastrar Origem" > “Nova Origem”

...

  • Insira o domínio da página da web onde você deseja permitir a incorporação. Certifique-se de digitar o domínio corretamente (por exemplo, dominioOperadora.com.br).

1- Selecione a opção na qual deseja liberar uma funcionalidade

2 - Selecione a funcionalidade desejada (ex: Rede Credenciada)

3 - Coloque uma descrição

4 - Coloque a Origem na qual a funcionalidade será renderizada (isso para permitir que no dominio da URL/IP informada a funcionalidade possa ser renderizada)

...

  • Salve as alterações.

Passo 3

Adicionar o código de incorporação na página da web Agora que você tem o código de incorporação e configurou a segurança, pode adicionar o código à página da web desejada. Siga estas etapas:

...

Abra o código HTML da página da web onde você deseja incorporar a funcionalidade.

...

Localize a seção <head> do documento HTML.

...

Cole o código de incorporação no local desejado dentro da tag <head>.

...

, e autorize a origem da URL conforme documentação de incorporação simples.

O link para a documentação está disponível para que vc realize os passos necessários.

Passo 2 - criando uma chave de segurança para obtenção do token

Após obter os códigos de incorporação e autorizar as origens, será necessário obter o token de autorização de segurança. O token de autorização de segurança é necessário quando for necessária a criação de uma sessão para o usuário da funcionalidade.

Acesse o painel de segurança, e crie uma nova chave de segurança, conforme descrito à seguir:

Menu Segurança / Cadastro de Origens / Nova origem / Escolha a opção “Credencial de API pública”.

Preencha as informações sobre a chave, e no menu “API” escolha “Segurança”. Confirme.

Uma chave será exibida. Guarde-a para uso futuro, baixando-a em seu computador.

Image Added

Passo 3 - obtendo o token através de uma API pública

Após obter os códigos de incorporação e autorizar as origens, será necessário obter o token de autorização de segurança. O token de autorização de segurança é necessário quando for necessária a

Para obter o token de sessão, consuma a API pública de obtenção de sessão, descrita aqui:

Image Modified

Aviso

ATENÇÃO
Em caso de testes em ambiente de sandbox é necessário passar o parâmetro “instanciaAplicacao” conforme exemplo abaixo:

<script src="https://omnichannel-sdk.mosiaomnichannel.com.br/"</script>>
<div id="container-ms-4-4"></div>
<script type="text/javascript">
let funcionalidadeS9 = window.omnichannelSDK.embed({
id: "container-ms-4-4",
url: "https://funcionalidades-front.mosiaomnichannel.com.br/",
json: {
idFuncionalidade: 4,
bundle: "HASH",
authorization: null, // opcional para funcionalidades que não necessitam de login
esquemaCor: null, // null pega o default, ou o slug de um esquema qualquer
instanciaAplicacao: 1
}
})
</script>

Conclusão

Agora você está pronto para incorporar a funcionalidade do aplicativo em sua página da web. Siga as etapas descritas acima para obter o código de incorporação, configurar a segurança e adicionar o código à página desejada. Lembre-se de que o recurso de incorporação só funcionará nos domínios registrados na seção de segurança do aplicativo.

...