Passar para o conteúdo principal

[Getting Started - GCW] Configurando Gatilhos de Postback

Anastasiia Zbrozhek avatar
Escrito por Anastasiia Zbrozhek
Atualizado há mais de 2 semanas

Lista de verificação:

  1. Configuração do cliente: Certifique-se de que o cliente já esteja no sistema antes de criar um postback.

  2. Criar um Modelo de Postback:

    • Via Seção de Modelos: Adicione um novo modelo a partir da seção principal de modelos.

    • Via perfil do cliente: Acesse o perfil do cliente, navegue até Gatilhos e crie o modelo.

  3. Configure o Gatilho:

    • Adicione um gatilho e nomeie-o.

    • Selecione o tipo de evento (por exemplo, pedido recebido, enviado).

    • Escolha o método de entrega (URL ou e-mail).

    • Para URL: Insira a URL, defina o método como POST, o formato como JSON e ative as novas tentativas, se necessário.

  4. Configure o modelo:

    • Atribua um nome ao modelo.

    • Use exemplos de payloads ou insira dados personalizados.

    • Mapeie os dados de entrada para o formato de saída usando o Mapeador de Modelos.

    • Renderize a saída para visualizar os dados finais.

  5. Teste e ative:

    • Realize um teste para garantir o funcionamento correto.

    • Salve e ative o modelo para notificações em tempo real.

Quando finalizado, o sistema enviará automaticamente atualizações aos clientes para os eventos de pedido selecionados.

Instruções detalhadas:

1. Configuração do cliente

Antes de configurar um postback, certifique-se de que o cliente que receberá as notificações esteja adicionado ao seu sistema. Isso é essencial, pois os gatilhos e modelos serão vinculados ao perfil dele.

2. Criar um modelo de postback

Você pode criar um modelo de duas maneiras:

Opção 1: Através da Seção de Modelos

  • Navegue até a seção principal Modelos.

  • Selecione \"Adicionar modelo\".

  • Defina os detalhes do modelo, como o nome e a estrutura de carga útil.

Opção 2: Através do Perfil do Cliente

  • Vá para o perfil do cliente específico no sistema.

  • Selecione a guia Triggers.

  • Clique em "Adicionar Gatilho" e comece a criar o modelo diretamente.

3. Configure o Gatilho

  • Adicionar um Gatilho:

    • Vá para a seção Triggers no perfil do cliente.

    • Clique em "Adicionar Gatilho" e dê a ele um nome descritivo.

  • Selecione o Tipo de Evento:

    • Escolha o evento de pedido que acionará a notificação. As opções incluem:

      • Pedido recebido

      • Falha no pedido

      • Order canceled

      • Pedido devolvido

      • Pedido produzido

      • pedido entregue

      • Encomenda enviada

      • Pedido em trânsito

  • Escolha o método de entrega:

    • Decida se a notificação será enviada para uma URL ou um e-mail.

    • Para entrega de URL:

      • Insira o URL de destino.

      • Defina o método como POST.

      • Escolha JSON como o formato de dados.

      • Ative Tentar novamente em caso de falha se necessário para garantir uma entrega confiável.

4. Configure o modelo de postback

Se um modelo já foi criado, selecione-o nesta etapa. Caso contrário, crie um novo modelo:

  • Definir nome do modelo: Atribua um nome significativo ao modelo.

  • Gerar o modelo:

    • Use os payloads de amostra fornecidos pelo sistema para eventos comuns, ou defina payloads personalizados.

    • Personalize os dados de acordo com suas necessidades.

  • Mapear dados de entrada:

    • Use o Mapeador de Modelos para mapear os campos de dados de entrada para o formato de saída desejado.

  • Saída de renderização:

    • Visualize o formato final dos dados para garantir que atenda às suas expectativas.

5. Teste e Ative o Postback

  • Faça um teste:

    • Simule o acionamento para verificar se o postback é enviado corretamente e gera o resultado esperado.

  • Salvar e ativar:

    • Se o teste for bem-sucedido, salve a configuração e ative o gatilho.

Resultado:

O sistema agora enviará automaticamente notificações de postback para o URL ou e-mail especificado sempre que o evento de pedido selecionado ocorrer, mantendo seus clientes atualizados em tempo real.

Mais informações sobre como configurar postbacks podem ser encontradas aqui.


Respondeu à sua pergunta?