Como instalar e configurar o aplicativo Vtex no Zendesk?

Para realizar a instalação do aplicativo Vtex no seu Zendesk é necessário acessar a central de aplicativos do Zendesk (https://www.zendesk.com/apps), no menu de pesquisa busque por “Vtex”

 

 

Ao clicar em instalar abrirá uma aba onde deverá selecionar em qual Zendesk deseja instalar o APP Vtex, selecione o Zendesk que deseja realizar a instalação.

 

E assim finalizando a instalação de seu APP Vtex.

 

Após a instalação você será direcionado a página de configuração do seu APP, onde serão configurados os seguintes campos:

 

 

Possuímos apenas 6 campos obrigatórios que são: Título, vtex_url, vtex_key, vtex_token e vtex order custom field id, os demais campos podem ser utilizados de acordo com sua necessidade.

 

*Título: esse será o nome da instalação do seu APP

*vtex_url: Url da sua api do Vtex  (A url não pode conter HTTP)

Ex: “webservice-johnscompany.vtexcommercestable.com.br”;

*Exibir a marca no ticket:  true/false

*vtex_key: chave de API

*vtex_token:  token de API

 

Para configuração dos campos a seguir é necessário criar um campo de ticket no Zendesk para associar  com os campos de seu Vtex.

 

Criação de campo:

Acesse a aba de admin do seu Zendesk, localize o grupo Gerenciar, opção Campos de tickets, na tela de campos de ticket iremos adicionar um novo campo:

 

 

Configuração de campos para o Vtex o tipo do campo deve ser sempre “Texto” assim evitarmos futuros erros.

 

* vtex order custom field id:  ID do campo customizado criado anteriormente para armazenar a id do pedido VTEX nos tickets ;

* Status do pedido vtex: ID do campo personalizado do Zendesk para armazenar o status do pedido VTEX ;

* vtex order customer_name:  ID do campo personalizado do Zendesk para armazenar o nome do cliente do pedido VTEX;

* vtex order customer_document: ID do campo personalizado do Zendesk para armazenar o documento do cliente do pedido VTEX;

* vtex order customer_phone: ID de campo personalizado do Zendesk para armazenar o número de telefone do cliente do pedido VTEX;

* data do pedido vtex: ID do campo personalizado do Zendesk para armazenar a data do pedido VTEX;

* descrição do pedido vtex: ID do campo personalizado do Zendesk para armazenar a descrição do pedido VTEX;

* pagamento de pedido vtex: ID de campo personalizado do Zendesk para armazenar o tipo de pagamento de pedido VTEX;

* valor do pedido vtex: ID do campo personalizado do Zendesk para armazenar o valor do pedido VTEX;

* vtex order transport_value: ID do campo personalizado do Zendesk para armazenar o valor do transportador de pedido VTEX;

* vtex order transport_name:  ID do campo personalizado do Zendesk para armazenar o nome do transportador de pedido VTEX;

* estado do pedido vtex: ID de campo personalizado do Zendesk para armazenar o estado do pedido VTEX;

* vtex order processing_date: ID do campo personalizado do Zendesk para armazenar a data de processamento do pedido VTEX;

* vtex order eletronic_receipt:  ID de campo personalizado do Zendesk para armazenar o recibo eletrônico do pedido VTEX;

* vtex order delivery_date: ID do campo personalizado do Zendesk para armazenar a data de entrega do pedido VTEX;

* total do pedido vtex: ID do campo personalizado do Zendesk para armazenar o valor total do pedido VTEX;

* fill_field: ID do campo personalizado do Zendesk para informar se os tíquetes foram preenchidos pelo aplicativo;

* show_headlight:  Campo para definir se o farol é exibido (True para exibir e false para não exibir);

* vtex order limit_change: ID de campo personalizado do Zendesk para armazenar a data limite VTEX para troca;

*Parameter to define the language of the app (pt-br, es): Língua deve ser a mesma que foi definida no vtex;

*Habilitar restrições de funções: Definir quais usuários poderá ter acesso ao Vtex;

*Ativar restrições de grupos: definir quais grupos poderão ter acesso ao Vtex.