Os postbacks são notificações automatizadas enviadas do GelatoConnect para sistemas externos sempre que o status de um pedido muda. Eles são essenciais para manter os Provedores de Serviços de Impressão (PSPs) e clientes informados sobre seus pedidos em tempo real, sem necessidade de atualizações manuais.
Postbacks permitem que você:
Notifique os clientes automaticamente quando o status do pedido deles mudar (por exemplo, recebido, enviado, entregue).
Alerte sua equipe sobre pedidos que necessitam de atenção (pedidos com falha).
Atualize seus sistemas de gerenciamento de estoque quando os pedidos forem concluídos.
Acompanhe o progresso do pedido durante todo o seu fluxo de Atendimento de Pedidos.
Essas notificações podem ser entregues via webhooks (URL) ou e-mail, dependendo das suas necessidades de integração.
Pré-requisitos para configurar postbacks
Antes de criar postbacks, certifique-se de que você tem:
Os clientes que receberão notificações são configurados na seção de clientes do GelatoConnect.
Os endpoints de URL estão prontos para receber dados de webhook (se estiver usando o método de entrega por URL).
Uma compreensão básica de modelos e gatilhos.
Familiaridade com o fluxo de status de pedidos no GelatoConnect.
Guia passo a passo para configurar postbacks
1. Crie um modelo de postback
Os modelos definem a estrutura e o conteúdo das suas notificações de postback. Você pode criá-los de duas maneiras:
Opção A: Através da seção de modelos
Navegue para Fluxo de trabalho > Entrada de pedidos > Modelos
Clique em "Adicionar modelo"
Selecione o tipo de modelo:
Gatilho: Webhook - Para enviar dados JSON ou XML para sistemas externos
Gatilho: E-mail - Para enviar notificações por e-mail
Escolha o formato apropriado (JSON ou XML)
Opção B: Através do perfil do cliente
Vá para o perfil do seu cliente
Navegue até a aba Triggers e clique em Adicionar Trigger
Você poderá criar o modelo diretamente na configuração do gatilho
Para orientações detalhadas sobre como criar modelos, consulte Criando Modelos para Recebimento de Pedidos.
2. Configure um gatilho
Os gatilhos determinam quando os postbacks são enviados e para onde são entregues:
Nomeie seu gatilho de forma descritiva (por exemplo, \"Notificação de Pedido Enviado\")
Selecione o evento que irá ativar o gatilho:
Pedido recebido
Falha no pedido
Order canceled
Pedido devolvido
Pedido produzido
pedido entregue
Encomenda enviada
Pedido em trânsito
Escolha seu método de entrega:
URL (Webhook): Envia dados para um endpoint especificado
E-mail: Envia notificações por e-mail
Para entrega por URL, configure:
O URL de destino para onde as notificações serão enviadas
Defina o método como POST (recomendado)
Você pode escolher JSON ou XML como o formato de dados
Habilite \"Tentar novamente em caso de falha\" para maior confiabilidade
Para entrega por e-mail, configure o endereço de e-mail do destinatário.
3. Adicionar um modelo
Seu modelo transforma os dados internos do GelatoConnect em um formato útil para os sistemas da sua empresa e dos seus clientes.
Se um modelo já estiver criado, você pode selecioná-lo durante a configuração do acionador; caso contrário, será necessário criar um novo.
Dê ao seu modelo um nome claro (por exemplo, \"OrderShippedNotification\")
Use os exemplos de payload fornecidos para o tipo de evento selecionado
Mapeie os campos de dados de entrada para o formato de saída desejado usando o Mapeador de Modelos
Exemplo de modelo para o evento "Pedido enviado":
{ "event": "Pedido enviado", \"orderId\": \"##{{ orderId }}\", "orderReferenceId": "##{{ orderReferenceId }}", \"timestamp\": \"##{{ created }}\", \"status\": \"##{{ fulfillmentStatus }}\", \"trackingInfo\": { {% for item in items %} {% for atendimento_de_pedidos in item.fulfillments %} \"trackingCode\": \"##{{ fulfillment.trackingCode }}\", \"trackingUrl\": \"##{{ fulfillment.trackingUrl }}\", "carrier": "##{{ fulfillment.carrierName }}" {% endfor %} {% endfor %} }}Use o botão \"Renderizar\" para visualizar como sua saída aparecerá
Teste o modelo para garantir que ele gere o resultado esperado
Para mais exemplos de modelos, consulte Exemplos de Mapeador de Modelos.
4. Teste e ative
Antes de colocar seu postback em funcionamento, envie alguns testes para verificar se tudo está funcionando como esperado. Posteriormente, você pode alterar os status do seu gatilho e modelo para ativo.
Após concluir essas etapas, o sistema enviará um postback para a URL ou endereço de e-mail designado com as informações relevantes do pedido sempre que o evento de pedido especificado ocorrer.
Técnicas avançadas de postback
Usando Pesquisas em Seus Modelos
As consultas são úteis para mapear valores internos para formatos amigáveis ao cliente:
{% set carrier = lookups({\"shipmentMethodUid\": fulfillment.carrierUid}, strict=False, default=\"\") %}"transportadora": "##{{ carrier }}"Isso converte códigos internos do GelatoConnect em valores mais significativos para seus clientes. Saiba mais em Como configurar consultas.
Campos de dados específicos do evento
Diferentes eventos fornecem diferentes campos de dados. Aqui estão os principais campos disponíveis para eventos comuns:
Pedido enviado/entregue: códigos de rastreamento, informações da transportadora, datas de entrega
Pedido Falhou/Cancelado: motivos de erro, carimbos de data/hora
Pedido recebido: detalhes do pedido, informações do item
Para entender completamente esses campos, consulte Introdução aos Template Mappers no GelatoConnect.
Solução de problemas com postbacks
Se seus postbacks não estiverem funcionando como esperado:
Verifique se o URL de destino está correto e acessível
Verifique a sintaxe do modelo para erros
Confirme se o gatilho está configurado corretamente para o evento adequado
Procure por tipos de dados incompatíveis ou campos ausentes
Teste o modelo com dados de amostra antes de ativá-lo
Para postbacks de e-mail especificamente:
Verifique se os detalhes do seu servidor SMTP estão corretos (se configurado)
Verifique se o endereço de e-mail do remetente está corretamente formatado
Certifique-se de que seu servidor SMTP permite a conexão do GelatoConnect
Verifique se os dados de autenticação (nome de usuário/senha) estão corretos
Para obter conselhos mais abrangentes sobre solução de problemas, consulte a seção "Solução de problemas" em Criando modelos para recebimento de pedidos.
Configurando seu servidor de e-mail para postbacks
Como Provedor de Serviços de Impressão, você pode configurar o GelatoConnect para enviar retornos por e-mail usando seu próprio servidor de e-mail. Isso significa que os destinatários verão e-mails vindos do seu domínio em vez do GelatoConnect, mantendo a consistência da sua marca.
Para configurar as configurações do seu servidor de e-mail:
Navegue até a seção Fluxo de trabalho na barra lateral esquerda
Encontre a seção Configuração e selecione Configurações de Trabalho
Localize a seção Configurações do servidor de e-mail de saída
Insira os seguintes detalhes:
Endereço de E-mail do Remetente: O endereço de e-mail que aparecerá no campo \"De\"
Nome do remetente: O nome que aparecerá junto ao endereço de e-mail
Servidor SMTP: O endereço do seu servidor de e-mail (ex.: smtp.suaempresa.com)
SMTP Port: A porta que seu servidor de e-mail usa (comumente 587 ou 465)
Nome de usuário SMTP: O nome de usuário para autenticação no seu servidor SMTP
Senha SMTP: A senha do seu servidor SMTP
Usar TLS: Ative isso se o seu servidor SMTP exigir criptografia TLS (recomendado)
Salve sua configuração
Depois de configurado, todos os retornos de e-mail serão enviados pelo seu servidor de e-mail, garantindo uma identidade de marca consistente e aumentando a entrega das mensagens aos seus clientes.
Próximos Passos
Após configurar seus postbacks:
Acompanhe o sucesso das entregas na página de Solicitações dentro do recebimento de pedidos.
Verifique com seus clientes se eles estão recebendo as notificações corretamente
Ao implementar um sistema de postback robusto, você melhorará a experiência dos seus clientes com atualizações de pedidos em tempo real, reduzindo a comunicação manual.