Get Started

Precisa de Ajuda?

Integração com cliente

Leitura estimada: 9 minutos 89 views
  1. Acesse a tela Integração com cliente (Administração > Configurações Gerais > Integração com cliente > (botão) +Novo).


  2. Preencha o campo obrigatório "Nome" com um nome que defina a integração com o sistema externo. O campo "Descrição" é opcional, e pode ser preenchido com alguma observação referente a esta integração.


  3. No bloco Dados para Autenticação, preencha os seguintes campos:


    - Tipo de autenticação: Selecione "Basic Auth" ou "OAuth2".

    - Endpoint de autenticação: A URL que permite acesso ao serviço externo.

    - Usuário: Para login na autenticação.

    - Senha: Para login na autenticação.

    - Nome do token: O token de acesso para autenticação.

    - Nome enviado no header: Nome a ser enviado com o token no header.


  4. No bloco Dados para consulta, preencha os seguintes campos obrigatórios:


    - URL: URL do endpoint que será feita a consulta dos dados.

    - Campo do nome: Atributo do "de-para" ao nome dos clientes.

    - Campo do código: Atributo do "de-para" ao código dos clientes.

    - Campo de referência: Atributo do "de-para" ao campo código.

    - Campo de referência para envio: Atributo do "de-para" ao campo código.


  5. Ainda no bloco Dados para consulta, se desejar preencha os seguintes campos opcionais:


    - Label do campo código adicional: Atributo do "de-para" à label do código adicional dos clientes.

    - Campo código adicional: Atributo do "de-para" ao código adicional dos clientes.

    - Telefone: Atributo do "de-para" ao telefone dos clientes.

    - Telefone2: Atributo do "de-para" à segunda opção de telefone dos clientes.

    - Celular: Atributo do "de-para" ao celular dos clientes.

    - Email: Atributo do "de-para" ao email dos clientes.

    - Campo de data de nascimento: Atributo do "de-para" à data de nascimento dos clientes.

    - Campo que indica se o cliente está ativo: Atributo do "de-para" à indicação de status dos clientes.

    - Nome do filtro para consulta no padrão Query search: Nome do filtro de consulta que permite a redução da quantidade de dados mostrados em uma visualização.

    - Nome do parâmetro de pesquisa para o campo Nome: Parâmetro de consulta para o campo Nome passado por URL na requisição.

    - Nome do parâmetro de pesquisa para o campo Código: Parâmetro de consulta para o campo Código passado por URL na requisição.

    - Objeto com os dados: Atributo indicador que o resultado da chamada do serviço vai ser encapsulado por um objeto e recuperado os dados desse parâmetro.

    - WebService de detalhamento: Configuração webservice que será utilizado nos modais de pesquisa de cliente para detalhar uma linha do resultado da consulta.

       * Caso deseje selecionar opções neste campo, é necessário cadastrar nas seções Webservices principais e/ou Webservices secundários do bloco Outras integrações. Este bloco é exibido após o passo 7.


    - Executa ação: Ao habilitar esta flag é possível configurar um botão de ação.

    - Método HTTP: Selecione "Get", "Post" ou "Put"

    - Nome da ação: Nome exibido no botão de ação.

    - Webservice ação: URL do serviço que será chamado na ação.

    - Habilitar o preenchimento automático do Tipo de Cliente: Ao habilitar esta flag é exibido o campo Tipo de cliente com as opções já configuradas na plataforma na tela Tipo de Cliente (Administração > Configurações Gerais > Tipo de Cliente).

       * Durante a consulta de dados de um cliente na tela Atendimentos, caso não seja identificado na integração ou na base da plataforma, o "Tipo de cliente" é preenchido automaticamente com a opção configurada no campo Tipo de cliente associado a esta flag.


  6. No bloco Configuração para consultas paginadas, preencha os seguintes campos:


    - Objeto da paginação: Nome do objeto para paginação.

    - Lista de objetos: A lista no retorno da API.

    - Qtde. por página: Quantidade a ser exibida por página.

    - Qtde. total: Quantidade total de objetos.

    - Próxima página: Número de página.

    - Página anterior: Número de página.

       * Este recurso pode ser visto pelo Atendente na tela Consultar clientes integração (LemonDesk > Consultar clientes integração > (botão) Filtro). Exemplo: na pesquisa pelo campo "Nome".


  7. Clique no botão Salvar e continuar no topo direito da tela.


  8. Após o passo 7, é exibido abaixo do bloco Dados para Autenticação, o bloco Outras integrações com 02 (duas) seções: "Webservices principais" e 'Webservices secundários".


  9. Clique no botão +Novo Webservice


    .

  10. É aberto o popup Webservice. Preencha os seguintes campos obrigatórios:


    - Nome: O nome da consulta a ser realizada.

    - Nome da aba: O nome da consulta a ser realizada.

    - URL: URL do Webservice.

    - Tipo de visualização: Selecione "Tabela" ou "Campos".

    - Ícone: Escolha a imagem para o ícone da ação.


    * O campo Descrição e a flag "Secundário" são opcionais. Permite indicar a observação do serviço externo e se será principal ou secundário, respectivamente.


  11. Clique no botão Salvar e continuar do popup.


  12. É exibido no popup o bloco Campos retorno, peencha os seguintes campos obrigatórios:


    - Nome: Atributo do campo no serviço externo.

    - Label: Nome para o campo na plataforma.

    - Tamanho: O tamanho do campo na tela entre "1" e "12".

    - Qtde. Máxima de Caracteres: Quantidade de caracteres para este campo.

    - Tipo: Escolha o tipo de entrada de dados para o campo.


    * Ao selecionar o Tipo "Select" é exibido o campo obrigatório Tipo de select com as opções: "Fixo", "Webservice" ou "Aninhado".

    * Ao selecionar a opção "Webservice" é exibido o campo obrigatório Webservice para preenchimento. Ao selecionar a opção "Aninhado" são exibidos os campos obrigatórios Chave e Valor.


    * A flag "Ação" e os campos: WebService para ação e Campos a serem atualizados são de preenchimento opcional, caso deseje configurar uma ação para o campo de retorno.


  13. Clique no botão Salvar do bloco para este campo de retorno ser exibido na configuração. Na coluna "Ordem" é possível clicar nas setas e ajustar a ordenação. Se desejar fazer alguma alteração, clique no ícone Lixeira e repita o passo 12.


  14. Ainda no popup, abaixo do bloco Campos retorno, se desejar configurar botões de ação e campos para filtro, utilize as abas: Ações e/ou Filtros de pesquisa.


  15. Na aba Ações do popup, preencha os seguintes campos obrigatórios:


    - Título: Nome do botão.

    - Campo chave: Atributo no serviço externo.

    - Tipo de ação: Escolha a ação do botão.

    - Ícone: Imagem para o ícone de ação.

    - Webservices secundário: O webservice habilitado como secundário.

    - Expressão: Utilizada para validar a apresentação da ação. É feita seguindo a regra: CAMPO_COM_INFORMAÇÃO VALIDAÇÃO VALOR_A_SER_COMPARADO.


  16. Clique no botão Salvar da aba para ser exibido ao lado esta configuração. Na coluna "Ordem" é possível clicar nas setas e ajustar a ordenação. Se desejar fazer alguma alteração, clique no ícone Lixeira e repita o passo 15.


  17. Na aba Filtros de pesquisa do popup, preencha os seguintes campos obrigatórios:


    - Campo: Atributo no serviço externo.

    - Label: Nome do campo na plataforma.

    - Tamanho: O tamanho do campo na tela entre "1" e "12".

    - Tipo: Escolha o tipo de entrada de dados para o campo.


    * Ao selecionar o Tipo "Select" é exibido o campo obrigatório Tipo de select com as opções: "Fixo", "Webservice" ou "Aninhado".


    * Ao selecionar a opção "Webservice" é exibido o campo obrigatório Webservice para preenchimento. Ao selecionar a opção "Aninhado" são exibidos os campos obrigatórios Chave e Valor.


  18. Clique no botão Salvar da aba para ser exibido ao lado esta configuração. Na coluna "Ordem" é possível clicar nas setas e ajustar a ordenação. Se desejar fazer alguma alteração, clique no ícone Lixeira e repita o passo 17.


  19. Clique no botão Salvar no canto inferior direito do popup. O popup será fechado automaticamente.


    DICA

    Estas configurações realizadas no bloco Outras integrações são exibidas para o Atendente nas seguintes telas:

    1. Atendimentos (LemonDesk > Atendimentos > (selecione na listagem) > ícone Integração > clique no (+) da aba).

    2. Consultar clientes integração (LemonDesk > Consultar clientes integração > (botão) Filtro > (preencha os dados necessários) > (botão) Pesquisar > (clique no "Nome") > clique no (+) da aba).


  20. Ainda na tela Integração com cliente, role a tela para baixo até o bloco Campos adicionais. Se desejar adicionar campos na plataforma para retorno de outros dados dos clientes, além dos dados principais do bloco Dados para consulta, preencha os seguintes campos obrigatórios:


    - Label: Nome do campo na plataforma.

    - Chave: Atributo no serviço externo.


    * Utilize a flag "Visível na tabela de consulta" se desejar que os dados dos clientes sejam exibidos para os Atendentes nas telas:

    1. Atendimentos (LemonDesk > Atendimentos > (selecione na listagem) > Dados do cliente).

    2. Consultar clientes integração (LemonDesk > Consultar clientes integração > (botão) Filtro > (preencha os dados necessários) > (botão) Pesquisar).


    * Se desejar, marque a flag "Imprimir campo no relatório" para que os dados sejam exibidos na tela Relatórios (Estatísticas > Relatórios).


  21. Clique no botão +Adicionar para serem exibidos abaixo os campos configurados. Na coluna "Ordem" é possível clicar nas setas e ajustar a ordenação. Se desejar fazer alguma alteração, clique no ícone Lixeira e repita o passo 20.


  22. Ao final da tela Integração com cliente, no bloco Dados para adicionar ao header da requisição, preencha os seguintes campos obrigatórios:


    - Chave: Atributo no serviço externo.

    - Valor: Dado a ser enviado a requisição.


    * Ao lado, podem ser utilizadas as Tags que serão substituídas por dados do usuário logado no envio da requisição.


  23. Clique no botão Salvar para serem exibidos os dados configurados. Se desejar fazer alguma alteração, clique no ícone Lixeira e repita o passo 22.


  24. Volte ao topo direito da tela, e clique no botão Salvar.



Artigos relacionados

Leave a Comment

Compartilhar documento

Integração com cliente

Copiar link

CONTEÚDOS

Powered By EazyDocs