Mudança de Status de Consumidor - Configuração de Trigger na VTEX

Você pode utilizar as Triggers da VTEX para desativar consumidores na BonifiQ. Dessa forma, sempre que um consumidor for alterado no Master Data para refletir alguma propriedade determinada, a VTEX chama a API da BonifiQ e desabilita (ou habilita) um determinado consumidor.

Consumidores desabilitados não participam do programa de pontos e não podem realizar resgates.

Os passos abaixo detalham como realizar esse processo.

1. Gerando Credenciais Criptografadas

Antes de mais nada, é necessário gerar as credenciais de API da BonifiQ. 

Na BonifiQ, na tela de Credenciais de API, siga os passos abaixo:

1. Crie uma nova credencial privada.
2. Copie o token e a senha gerados.

1. Acesse o site Base64 Guru.
2. No campo de conversão, insira o token e a senha separados por “:”, conforme mostrado na imagem abaixo.

Exemplo: 

IMPORTANTE: A senha utilizada é aquela da geração da CREDENCIAL API. Não utilize sua senha de admin.

1. Aperte o botão “Encode text to Base64”
2. O código gerado será o token e senha criptografados. Salve este código; ele será utilizado posteriormente para autenticar nossa API.

Configurando o Trigger na VTEX

Acesse a tela da VTEX, entre no Master Data e siga estes passos:

1. Na aba Trigger, adicione um novo trigger e siga as etapas abaixo:

   Passo 1:

   • Selecione o Data Entity como “Customer”.

2. Passo 2:

   • Escolha a opção “A filter attribute is changed”.

3. Passo 3:

   • No campo de atributo, selecione o campo que ativará essa Trigger
   • Na segunda opção, selecione “Equal to”.
   • No terceiro campo, insira “true” (ou outra opção, de acordo com o seu campo)

4. Na aba Schedule, selecione a opção “Run ASAP”.

5. Na aba If Positive, configure a ação:

   1. Selecione a ação “Send an HTTP request”, onde aparecerá a tela para configuração de envio da requisição.
   2. Preencha os seguintes valores nos campos:
   3. URL: https://api.bonifiq.com.br/v1/pvt/customer/{!email}/changestatus
   4. Method: Selecione “POST”.

      
      

      Headers:  preencha dois campos:

      • Nome: Authorization

      • Value:

        O value será o código de credenciais criptografadas gerado anteriormente. O formato final será:

        "Basic {credenciais_criptografadas}"

        Exemplo:

        Basic dG9rZW4tZXhlbXBsbzpzZW5oYS1leGVtcGxvMTIz

      
      

      Content as JSON:

      No corpo da requisição, adicione o seguinte conteúdo em formato JSON:

      Para DESABILITAR um consumidor (não permitir que participe do programa de pontos)

      {
      "IsEnabled": false,
      "Reason": "Motivo de desabilitar"
      }

      Para HABILITAR um consumidor (permitir que ele participe do programa de pontos)

      {
      "IsEnabled": true,
      "Reason": "Motivo de habilitar"
      }

      Note que é obrigatório informar um motivo (Reason) para essa alteração. Esse motivo é visível apenas para administradores

      
      

      
      

Importante: os webhook são válidos apenas para os registros criados/alterados após a criação da trigger. Os registros passados que já existem na VTEX não serão enviados para a BonifiQ