A página E-mails/Webhook permite gerenciar a comunicação automática por e-mail enviada aos seus clientes e cadastrar URLs de webhook legados (V1) para receber atualizações da sua operação no Paylog.
Você precisa das permissões Configurar envio de e-mails ou Configurar webhook para acessar e salvar essas opções.
Esta página é destinada às notificações por e-mail e aos webhooks da versão anterior (V1). Para novas integrações entre sistemas, prefira a arquitetura moderna com assinatura HMAC SHA-256 e histórico detalhado de entregas.
1. Notificações automáticas por e-mail
O Paylog pode disparar e-mails automáticos para o cliente final à medida que o pedido avança no processo logístico.
No menu lateral, acesse Ferramentas > E-mails/Webhook (ou navegue direto até /ferramentas/emails-e-webhook). O item fica no nível de Ferramentas, fora do submenu Integrações.
Na seção Configurações de Envio de E-mail, ajuste as opções de disparo:
- Pedidos em Preparação: quando ativado, o Paylog envia um e-mail confirmando que o pedido entrou em separação e embalagem no centro de distribuição;
- Pedidos Enviados: quando ativado, o Paylog dispara uma notificação assim que a encomenda é postada ou coletada pela transportadora, incluindo o código e o link de rastreamento.
Depois de marcar ou desmarcar as opções desejadas, clique em Salvar Configurações de E-mail.
2. Cadastrar um Webhook legado (V1)
Se você possui um sistema antigo ou uma automação que consome a API de webhooks legada do Paylog, utilize a seção Configurações de Webhook.
Para adicionar um endpoint:
- Informe a URL do Webhook (deve ser um endereço HTTP/HTTPS público capaz de receber requisições
POST); - Em Tipo de Webhook, escolha
Rastreio(avisos de movimentação do rastreio) ouEntregue(aviso único quando o pedido é entregue); - Clique em Adicionar Webhook para gravar o endereço.
O webhook legado não tem seleção de eventos: cada URL é cadastrada para um único tipo. Para receber os dois avisos, cadastre a mesma URL duas vezes, uma para cada tipo.
3. Gerenciar e testar webhooks legados
Após a criação, o webhook aparece na lista Webhooks Configurados, com as colunas URL do Webhook, Tipo e Ações.
A partir dessa lista, você pode realizar duas ações principais:
- Enviar webhook de teste: dispara uma requisição
POSTcom dados sintéticos para o seu servidor e mostra o status HTTP devolvido. Qualquer resposta2xxé considerada sucesso; o Paylog aguarda até 10 segundos pela resposta. - Excluir webhook: remove permanentemente o endpoint cadastrado, interrompendo imediatamente o envio de eventos legados.
Quando não há nenhum endereço cadastrado, a seção exibe Nenhum webhook configurado.
Comparação: Webhook Legado (V1) vs Webhook V2
Antes de integrar um novo sistema, entenda as diferenças fundamentais entre os dois recursos:
| Recurso | Webhook Legado (V1) | Webhook V2 |
|---|---|---|
| Rota no painel | /ferramentas/emails-e-webhook |
/ferramentas/integracoes/webhooks |
| Autenticação | Token fixo ou sem assinatura individual | Assinatura HMAC-SHA256 (X-Webhook-Signature) |
| Eventos | Um tipo por URL: Rastreio ou Entregue |
Seleção granular por Pedido e Rastreamento |
| Histórico e Logs | Sem auditoria de entregas | Histórico completo de tentativas, respostas e status HTTP |
| Reenvio de eventos | Reenvio manual não disponível em lote | Reenvio em lote por período e produto |
| Idempotência | Tratamento dependente da aplicação | Chave idempotency_key em todas as entregas |
Para manter sua operação segura e contar com relatórios completos de entrega, utilize a documentação do Webhook V2.