Introdução
Notificações automatizadas são centrais para uma comunicação transparente com parceiros e para resposta rápida a desvios nas vendas por parceiros. A Affilentra liga o tracking, o cálculo de comissões e a faturação a notificações baseadas em funções. Este artigo descreve concretamente como comerciantes e operadores de rede podem configurar notificações para Conversion, Chargeback e Payout, utilizar modelos personalizados e definir regras de escalamento para casos críticos de SLA.
Porque é que as notificações baseadas em eventos fazem sentido
Notificações baseadas em eventos garantem que parceiros e equipas internas recebem apenas informação relevante: uma confirmação de Conversion para o publisher, um alerta de Chargeback para a equipa de operações ou uma comunicação de Payout para o parceiro. A automatização reduz trabalho manual, acelera a resolução de problemas e cria rastreabilidade para faturação e auditorias.
Preparativos: funções e direitos de acesso
Antes de criar notificações, verifique as funções na Affilentra:
- Softwarebetreiber: gere parâmetros do sistema, segurança e integrações.
- Händler/Merchant: define dados de produto, condições e regras de notificação.
- Partner/Publisher: recebe links de tracking pessoais, notificações In‑App e comunicações de pagamento.
Assegure-se de que apenas funções autorizadas podem criar ou alterar notificações e de que os modelos são guardados com controlo de versões.
Passo 1 — Selecionar e priorizar eventos
Defina os eventos que devem disparar notificações. Para a maioria dos comerciantes, pelo menos estes três eventos são relevantes:
- Conversion: intermediação bem-sucedida, relevante para reporting do parceiro e informação imediata sobre comissões.
- Chargeback: estorno ou cancelamento, crítico para faturação e monitorização de fraude.
- Payout: pagamento ao parceiro, importante para rastreabilidade e pedidos de suporte.
Priorize por urgência: Chargebacks merecem prioridade de SLA mais alta do que informações padrão de Conversion.
Passo 2 — Canais: E‑Mail, Webhook, In‑App
A Affilentra suporta três canais principais. Escolha o canal conforme o destinatário:
- E‑Mail — adequado para parceiros e destinatários externos; use linhas de assunto claras e conteúdos estruturados.
- Webhook — ideal para integrações com CRM, ERP, sistemas de tickets ou de monitorização. Garanta autenticação (por exemplo HMAC) e estratégias de retry.
- In‑App — rápido e contextual para dashboards de parceiros e utilizadores internos na Affilentra.
Combine canais para entrega redundante em eventos críticos de SLA (por exemplo In‑App + Webhook para um sistema de incidentes).
Passo 3 — Criar e personalizar templates
Utilize templates para garantir consistência. Pontos importantes:
- Defina placeholders padronizados, por ex. {{merchant.name}}, {{partner.id}}, {{conversion.id}}, {{amount}}, {{payout.id}}, {{chargeback.reason}}.
- Separe Assunto/Headline, Corpo e, opcionalmente, Rodapé para e‑mails. Preste atenção a linhas de assunto concisas: aumentam as taxas de abertura e reduzem pedidos de suporte.
- Use blocos condicionais para detalhes que aparecem apenas quando necessário (p. ex. motivo de chargeback).
Exemplo: template de e‑mail para Conversion (Assunto & Corpo):
Assunto: Conversion confirmada — Encomenda {{conversion.id}} (Parceiro {{partner.id}})
Corpo:
Olá {{partner.name}},
A sua recomendação resultou numa Conversion: Encomenda {{conversion.id}}.
Montante: {{amount}}.
Estado da comissão: Em análise. Detalhes no painel do parceiro.
Exemplo: Webhook‑Payload (estrutura simplificada):
{
"event": "conversion",
"conversion": {"id": "{{conversion.id}}", "amount": "{{amount}}", "status": "confirmed"},
"partner": {"id": "{{partner.id}}", "name": "{{partner.name}}"},
"merchant": {"id": "{{merchant.id}}"}
}
Passo 4 — Configuração de Webhook e segurança
Ao configurar webhooks tenha em atenção:
- URL do endpoint: sistema de destino, modelo de receção (POST, JSON).
- Autenticação: assinatura HMAC com secret partilhado ou Bearer‑Token.
- Logística de retry: configure tentativas com backoff exponencial e número máximo de tentativas.
- Idempotência: envie um ID de evento (p. ex. conversion.id) para evitar processamento duplicado.
- Modo de teste: verifique o endpoint com eventos de teste antes de ativar em produção.
Passo 5 — Regras de escalonamento para casos críticos de SLA
Para chargebacks ou pagamentos falhados, devem estar definidos caminhos de escalonamento. Procedimento prático:
- Defina janelas de SLA (p. ex. resposta inicial dentro de X horas). Estabeleça prazos internamente; comunique externamente apenas as informações necessárias.
- Crie níveis de escalonamento: 1. Equipa de Operações (In‑App + E‑mail), 2. Líder de equipa (E‑mail + Webhook para sistema de tickets), 3. Gestor de Incidentes (Push ou SMS via serviço externo).
- Automatize transições: se não houver ação dentro do prazo do SLA, a Affilentra envia automaticamente o próximo nível.
- Registe todos os passos de escalonamento no histórico de auditoria para rastreabilidade.
Regra de exemplo para chargebacks: se for detetado um chargeback e não for tratado dentro de 4 horas, é desencadeado adicionalmente um webhook para o sistema de tickets e enviada uma notificação ao líder de equipa.
Testes, monitorização e manutenção
Testes regulares e monitorização são decisivos:
- Utilize ambientes de staging e envie eventos de teste com diferentes valores de estado.
- Verifique as taxas de entrega de e‑mails e os códigos de resposta dos webhooks.
- Mantenha os templates centralizados: versionize as alterações e conserve versões antigas para revisão.
- Traduções: se tiver parceiros internacionais, mantenha templates específicos por locale.
Exemplo prático: fluxo end‑to‑end para um início de Chargeback
1) O Chargeback é reportado pelo prestador de pagamento e verificado pela Affilentra.
2) A Affilentra dispara um evento de Chargeback: alerta in‑app para a equipa de operações + e‑mail ao Merchant + webhook para o sistema de tickets.
3) Se não houver tratamento dentro do prazo definido pelo SLA, a Affilentra envia automaticamente uma mensagem de escalonamento ao líder da equipa e aciona uma notificação push para o sistema de incidentes.
4) Após a conclusão, a Affilentra documenta o resultado e informa o parceiro sobre o resultado final da faturação.
Melhores práticas resumidas
- Clareza: apenas eventos relevantes para parceiros, maior nível de detalhe para destinatários internos.
- Padrão de segurança: webhooks assinados e restrições de acesso para alterações de templates.
- Redundância: combinação de In‑App, Webhook e E‑Mail para eventos críticos.
- Testes & versionamento: alterações primeiro em staging, versionar templates.
- Operacionalização: automatizar e auditar cadeias de escalonamento conforme SLA.
Conclusão e próximo passo
Affilentra fornece os blocos de construção para tornar a comunicação com parceiros automatizada, auditável e segura, seguindo papéis claramente separados. Com modelos de notificação específicos, webhooks seguros e caminhos de escalonamento definidos, é possível gerir eficientemente informações de conversão, alertas de chargeback e notificações de pagamento.
Escolha o ponto de entrada adequado e configure o seu conjunto de notificações: Einstieg wählen
Próximo passo
Experimentar a Affilentra
Plataforma unificada que integra a disponibilização de produto, tracking, validação de conversões, cálculo de comissões e pagamentos de forma transparente entre papéis claramente separados; opção de instalação self‑hosted com licença perpétua sem participação nas receitas; os comerciantes mantêm o controlo sobre produtos, condições e materiais promocionais; os parceiros recebem links de tracking pessoais e histórico de pagamentos auditável.