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

Você pode usar as Triggers da VTEX para desativar ou habilitar consumidores na BonifiQ quando um campo do Master Data for alterado. Consumidores desabilitados não participam do programa de pontos nem podem realizar resgates.

A seguir, veja como configurar 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:

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

4. 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)

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

6. 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