FAQ - Integrações / Central de logs

1 Central de logs
- 1.1 Interface
- 1.2 Novo filtro de busca
2 Como analisar retornos de APIs usando o painel do Mosia Omnichannel?
3 Não consigo visualizar multi-cartões em meu app
4 Determinado beneficiário não aparece na funcionalidade desejada
5 Como funciona o Relogin?
6 Beneficiários não conseguem acessar o cartão virtual no app.
7 cURL
- 7.1 Capturar uma requisição do Postman em cURL
- 7.2 Exemplo de cURL

Esta documentação abrange a área de troubleshooting, essencial para resolver problemas técnicos e manter sistemas funcionando adequadamente. Exploraremos a abordagem sistemática de análise de sintomas, testes e diagnóstico, além de destacar a importância da colaboração e compartilhamento de conhecimento. O guia fornece informações valiosas para aprimorar habilidades técnicas e enfrentar desafios com confiança, garantindo a eficiência operacional. Mantenha-se atualizado com as últimas tendências nesse campo em constante evolução.

Em caso de necessidade de um analista para verificação em conjunto, abra um ticket com a Mobile Saúde e acione o nosso atendimento especial

Central de logs

A Central de Logs é uma ferramenta que tem agrupa informações de eventos que ocorrem nas mais diversas áreas da aplicação Omnichannel, passando desde acessos nas plataformas, integrações entre APIs, bem como da utilização pelo usuário final (beneficiário) no uso dos nossos fronts, sejam eles mobile ou WEB.

Interface

A interface será apresentada em uma janela no painel de configuração do Omnichannel (https://painel.mosiaomnichannel.com.br/) onde o usuário poderá filtrar os logs.

Para acessar a interface da central de logs, acesse: Segurança → Central de logs

A central de logs se encontra em processo de melhoria de desempenho. Um dos pontos abordados são os filtros de busca, no qual se encontra possível utilizar tanto os filtros de busca antigo quanto os novos filtros.

Novo filtro de busca

Para que seja apresentado os novos filtros de busca, basta clicar no botão “Acessar novo filtro“ conforme print abaixo.

Após acessar os novos filtros, será apresentado as seguintes informações

Data e hora do início da busca:

Aqui deverá ser preenchido o início do período que deseja buscar.

Data e hora do final da busca:

Aqui deverá ser preenchido o final do período que deseja buscar.

Chave Única:

Caso deseja pesquisar os logs de determinado beneficiário, preencha o campo com a chave única para que seja retornado apenas os dados do beneficiário em questão.

Origem:
1. A base do MosiaOmnichannel é baseada em ocorrências, e neste campo podemos direcionar a busca para um origem em específico. As origens disponíveis são:
  - App:
    - Ocorrências com origem do aplicativo. Exemplo: Cartão virtual, logout e Relogin.
  - Chatbot:
    - Ocorrências com origem no Chatbot. Exemplo: Status de Atendimento.
  - Connect:
    - Ocorrências no qual se faz necessário fazer uma requisição no Connect e retornar dados. Exemplo: Integração.
  - Mensageria:
    - Ocorrências voltadas a mensageria. Exemplo: E-mail e WhatsApp.
Categorias:
1. Categorias disponíveis para afunilar a busca dependendo da escolha da Origem da busca. Exemplo: Cartão virtual, Logout, Status do Atendimento, etc.
Subcategoria:
1. Subcategorias disponíveis para afunilar a busca dependendo da escolha da Categoria da busca. Exemplo: Acesso Funcionalidade, Boleto PDF, Detalhe da Consulta, Elegibilidade, Lista Débito, etc.

A data de busca não deve ultrapassar 31 dias, caso tente será retornado erro.

Como analisar retornos de APIs usando o painel do Mosia Omnichannel?

Contexto: Inúmeros clientes tem dificuldades de analisar situações de falha nas APIs. Muitas vezes, relatos de usuários do app para a operadora indicam que “beneficíario não consegue verificar seu extrato de autorização”, por exemplo. A operadora tem condições de realizar uma análise completa, usando o painel público

Como?

Acesse o painel público com seu usuário/senha e siga conforme esses passos: Segurança => Central de logs. Selecione as datas e horários das tentativas e filtre se desejar por Operação → Extrato de autorização.

Clique no evento e verifique os logs. Uma tela será demonstrada. O JSON de retorno conterá informações sobre o request. Para analisar o RESPONSE da API (que deve conter informações sobre o problema) vá até o fim do log, ou utilize o botão de “copiar”. A partir daí, basta colar o conteúdo em uma aplicação que indentará o JSON, tornando-o mais legível.

Atente-se aos atributos “status”, “statusText” e objeto “data”.

De acordo com o caso acima, é possível perceber que a API não devolve o resultado esperado (conteúdos válidos para exibição). Um status 400 indica que existe uma falha na obtenção de dados, e o detalhamento do erro indica que, por algum motivo, sua API não está sendo capaz de obter informações do seu ERP de saúde. Nesses casos, você deverá analisar sua API ou barramento OMNILINK para corrigir o problema.

Uma requisição bem sucedida deve ter status 200, e conteúdos compatíveis com as documentações de API. Para maiores detalhes sobre integrações usando APIs, verifique esta documentação técnica: https://mobilesaudejira.atlassian.net/wiki/spaces/MO/pages/2404352001

Em caso de necessidade de um analista para verificação em conjunto, abra um ticket com a Mobile Saúde e acione o nosso atendimento especial

Não consigo visualizar multi-cartões em meu app

Em caso de necessidade de um analista para verificação em conjunto, abra um ticket com a Mobile Saúde e acione o nosso atendimento especial

Situação: Validador não critica payload de login mas mesmo assim não consigo visualizar multi-cartões no meu app.

Solução: Nosso validador de integração checa erros de integridade no payload das requisições, regras de negócio são específicos de cada Operadora com isso não sendo possível criticar todos as possíveis regras de negócio que são implementadas na Operadora.

Para que seja exibido o beneficiário em contratos distintos é necessário que:

o array beneficiarios o objeto que contenha o beneficiário possua com o objeto dadosDoContrato > numeroContrato estejam iguais ao array contrato > numeroContrato estejam iguais
No exemplo de payload abaixo temos:
- chaveUnica: 11111111111; numeroContrato: 999999
- chaveUnica: 22222222222; numeroContrato: 888888

"beneficiarios": [
    {
      "chaveUnica": "11111111111",
      "integracao": {
        "chaveBeneficiario": ""
      },
      "dadosPessoais": {
        "nome": "",
        "sexo": {
          "codigo": "",
          "descricao": ""
        },
        "dataNascimento": "",
        "contato": {
          "email": "",
          "telefoneCelular": "",
          "telefoneFixo": ""
        },
        "cpf": "",
        "estadoCivil": {
          "codigo": "",
          "descricao": ""
        }
      },
      "dadosDoContrato": {
        "numeroContrato": "999999"
      },
      "dadosDoPlano": {
        "beneficiario": "",
        "idPlano": "",
        "descricao": "",
        "registroAns": "",
        "segmentacao": "",
        "acomodacao": "",
        "tipoContratacao": "",
        "regulamentacao": "",
        "abrangencia": "",
        "modalidadeCobranca": "",
        "padraoConforto": "",
        "participativo": "",
        "dataInicioVigenciaPlano": "",
        "dataFinalCpt": "",
        "dataInclusao": "",
        "matricula": "",
        "matriculaAntiga": "",
        "matriculaFuncionario": "",
        "tipoUsuario": {
          "codigo": "",
          "descricao": ""
        },
        "grauParentesco": {
          "codigo": "",
          "descricao": ""
        },
        "redeAtendimento": "",
        "carencia": [
          {
            "tipoServico": "",
            "carencia": ""
          }
        ]
      },
      "cartao": {
        "modeloCartao": "",
        "numeroCartao": "",
        "validade": "",
        "via": ,
        "numeroCns": "",
        "apresentaCartaoVirtual": ,
        "nomeCartao": "",
        "convenioAbrangenciaVerso": ""
      },
      "custom": {}
    },
    {
      "chaveUnica": "22222222222",
      "integracao": {
        "chaveBeneficiario": ""
      },
      "dadosPessoais": {
        "nome": "",
        "sexo": {
          "codigo": "",
          "descricao": ""
        },
        "dataNascimento": "",
        "contato": {
          "email": "",
          "telefoneCelular": "",
          "telefoneFixo": ""
        },
        "cpf": "",
        "estadoCivil": {
          "codigo": "",
          "descricao": ""
        }
      },
      "dadosDoContrato": {
        "numeroContrato": "888888"
      },
      "dadosDoPlano": {
        "beneficiario": "",
        "idPlano": "",
        "descricao": "",
        "registroAns": "",
        "segmentacao": "",
        "acomodacao": "",
        "tipoContratacao": "",
        "regulamentacao": "",
        "abrangencia": "",
        "modalidadeCobranca": "",
        "padraoConforto": "",
        "participativo": "",
        "dataInicioVigenciaPlano": "",
        "dataFinalCpt": "",
        "dataInclusao": "",
        "matricula": "",
        "matriculaAntiga": "",
        "matriculaFuncionario": "",
        "tipoUsuario": {
          "codigo": "",
          "descricao": ""
        },
        "grauParentesco": {
          "codigo": "",
          "descricao": ""
        },
        "redeAtendimento": "",
        "carencia": [
          {
            "tipoServico": "",
            "carencia": ""
          }
        ]
      },
      "cartao": {
        "modeloCartao": "",
        "numeroCartao": "",
        "validade": "",
        "via": ,
        "numeroCns": "",
        "apresentaCartaoVirtual": ,
        "nomeCartao": "",
        "convenioAbrangenciaVerso": ""
      },
      "custom": {}
    }
    
    }

Precisam os atributos dadosDoContrato > numeroContrato precisam esta de acordo com o array contrato > numeroContrato no payload abaixo:

{
  "contratos": [
    {
      "descricaoContrato": "CONTRATO 1",
      "numeroContrato": "999999",
      "empresaContratante": {
        "codigo": "",
        "descricao": ""
      },
      "tipoPessoa": {
        "codigo": "",
        "descricao": ""
      },
      "tipoRelacionamento": {
        "codigo": "",
        "descricao": ""
      },
      "tipoContratante": {
        "codigo": "",
        "descricao": ""
      },
      "dataInicioVigenciaContrato": "",
      "dadosTitular": {
        "matricula": "",
        "nome": ""
      }
    },
    {
      "descricaoContrato": "CONTRATO 2",
      "numeroContrato": "888888",
      "empresaContratante": {
        "codigo": "",
        "descricao": ""
      },
      "tipoPessoa": {
        "codigo": "",
        "descricao": ""
      },
      "tipoRelacionamento": {
        "codigo": "",
        "descricao": ""
      },
      "tipoContratante": {
        "codigo": "",
        "descricao": ""
      },
      "dataInicioVigenciaContrato": "",
      "dadosTitular": {
        "matricula": "",
        "nome": ""
      }
    }
  ]
}

Com estas correlações o app exibirá ambos os contratos

Em caso de necessidade de um analista para verificação em conjunto, abra um ticket com a Mobile Saúde e acione o nosso atendimento especial

Determinado beneficiário não aparece na funcionalidade desejada

Em caso de necessidade de um analista para verificação em conjunto, abra um ticket com a Mobile Saúde e acione o nosso atendimento especial

Caso todos os procedimentos de integração e regra de negócios da operadora estejam corretos, se faz necessário verificar algumas etapas:

1 - Verifique o objeto de permissões do login desejado (conforme nossa documentaçãohttps://mobilesaudejira.atlassian.net/wiki/spaces/MO/pages/2404450305 )

2 - Verifique se existe a integração do método beneficiariosAcessoFuncionalidade se a mesma está configurado, em caso de positivo verifique se os dados do contrato e chaveUnica batem com os do login informado, como no exemplo abaixo:

Com correções a funcionalidade funcionará conforme o desejado

Em caso de necessidade de um analista para verificação em conjunto, abra um ticket com a Mobile Saúde e acione o nosso atendimento especial

Como funciona o Relogin?

Início da contagem do tempo
A contagem do intervalo para re-login começa a partir do momento em que o beneficiário faz login no aplicativo. Ou seja, assim que o login é realizado, o "relógio" já está em andamento.
Re-login após inatividade
Se o usuário abrir o aplicativo novamente após um período superior a 24 horas (por exemplo, 4 dias depois), o app solicitará um novo login. Isso acontece porque o tempo limite de sessão foi ultrapassado.
Processo de re-login
Ao ser solicitado, o re-login envolve os seguintes passos:
- O sistema inicia a solicitação de dados de autenticação.
- Esses dados são buscados via API do cliente, caso ela esteja disponível no momento.
- Assim que os dados são recebidos, o sistema notifica o aplicativo.
Fatores que podem impactar a experiência do usuário
- Disponibilidade da API de re-login: Se estiver funcional, a resposta é praticamente imediata (segundos ou poucos minutos).
- Comportamento do usuário: Se o acesso ao app for muito rápido, pode acontecer de os dados de re-login só estarem totalmente disponíveis em uma próxima tentativa de uso.

Documentação - Relogin: https://mobilesaudejira.atlassian.net/wiki/spaces/MO/pages/2655584372

Documentação - Login : https://mobilesaudejira.atlassian.net/wiki/spaces/MO/pages/2404450305

Em caso de necessidade de um analista para verificação em conjunto, abra um ticket com a Mobile Saúde e acione o nosso atendimento especial

Beneficiários não conseguem acessar o cartão virtual no app.

Todos os procedimentos abaixo devem ser seguidos com cautela. Caso não possua o conhecimento técnico necessário, recomendamos que entre em contato com sua equipe de TI da Operadora ou nos acione via chamado solicitando uma agenda especial para verificação em conjunto com um técnico da Mobile Saúde.

Possíveis Soluções

1. Verificação com Login e Senha do Beneficiário

Caso a Operadora tenha o login e senha do beneficiário em questão, realize as seguintes etapas:

Acessar o Validador de Integração de Login:
- Navegue até Configurador de funcionalidades → Opções de login → Login → Integrações → Login/editar.

Configurador de funcionalidades → Opções de login → Login → Integrações → Login/editar.

Verificar Dados do Beneficiário:
- No validador, verifique se os dados do beneficiário estão corretos.
- Se forem encontrados erros, corrija-os, pois alguns erros podem impedir o login do beneficiário no app.

2. Análise Sem Login e Senha

Se não for possível obter o login e a senha do beneficiário, a recomendação é realizar uma análise mais detalhada na central de logs:

Acessar a Central de Logs:
- Navegue até Segurança → Central de Logs.

Aplicar Filtros:
- Aplique os filtros de Operação e Login para buscar por entradas relacionadas ao login do beneficiário.
Verificar o JSON Retornado:
- Ao consultar os logs, verifique o conteúdo do JSON retornado. Isso pode ajudar a identificar erros específicos ou problemas de integração que estão impedindo o acesso ao cartão virtual.

Todos os procedimentos abaixo devem ser seguidos com cautela. Caso não possua o conhecimento técnico necessário, recomendamos que entre em contato com sua equipe de TI da Operadora ou nos acione via chamado solicitando uma agenda especial para verificação em conjunto com um técnico da Mobile Saúde.

cURL

O cURL é uma ferramenta de linha de comando que permite transferir dados para ou de um servidor usando vários protocolos da internet. Pense nele como um "navegador para desenvolvedores" que funciona diretamente no terminal.

Há uma forma de capturar o cURL da sua requisição diretamente no Postman
O cURL nos ajuda a testar endpoints de API rapidamente.

Com estes passos, você poderá capturar o cURL da sua requisição.

Capturar uma requisição do Postman em cURL

Abra a sua requisição no Postman (GET, POST etc).

No canto direito, clique no botão “</> Code”.

Aqui você terá o acesso ao cURL da sua requisição que pode ser enviado junto ao chamado para analise caso necessário.

Exemplo de cURL

curl --location 'https://exemploAPI/login' \
--header 'Content-Type: application/json' \
--data '{
    "login":"99999999999",
    "senha":"1234"