Definição do problema
Gestores de programas de afiliados frequentemente precisam que o Post Affiliate Pro notifique automaticamente sistemas externos—como APIs, CRMs ou aplicações personalizadas—quando regras específicas de Recompensa de Desempenho são ativadas (por exemplo, quando um afiliado recruta determinado número de subafiliados ou atinge uma meta de vendas). No entanto, o Post Affiliate Pro não oferece um recurso nativo para acionar uma API externa diretamente a partir de uma regra de Recompensa de Desempenho.
Para suprir essa necessidade, algumas soluções flexíveis podem ser implementadas para criar automação e notificações externas sem grandes impactos no fluxo de trabalho dos afiliados.
Utilizando um Campo de Perfil Oculto e o Affiliate Profile Change Webhook (Recomendado e Invisível para Afiliados)
Atualize um Campo de Perfil Oculto via Recompensa de Desempenho:
- Na seção “Ações” da sua regra de Recompensa de Desempenho, selecione “Atualizar usuário” e escolha um campo de perfil para atualizar.
- Defina esse campo de perfil como Oculto nas configurações do perfil do afiliado para que não fique visível para os afiliados e seja usado apenas para automação interna.
Configure o Plugin Affiliate Profile Change Webhook:
- Instale e configure o plugin Affiliate Profile Change Webhook
.
- Configure-o para monitorar o campo de perfil oculto que você atualizou.
- Quando houver alteração no campo, o plugin enviará um webhook (HTTP POST) com detalhes do afiliado para seu endpoint de API externa.
Essa abordagem garante que apenas seu sistema seja notificado, e os afiliados não têm conhecimento da existência ou alteração do campo.
Solução 1: Usando a Ação “Enviar Email Para” e o Emails Callback Webhook
Duplique a Regra de Recompensa de Desempenho:
- Crie uma cópia da sua regra original de Recompensa de Desempenho, mantendo as mesmas condições.
- Na ação, escolha “enviar email para” e configure para enviar um email ao comerciante.
Configure o Plugin Emails Callback Webhook:
- Instale e configure o plugin Emails Callback Webhook
.
- Esse plugin processa todos os emails enviados e os encaminha como requisições HTTP para seu endpoint externo.
Detecte e Processe a Notificação:
- Seu sistema externo pode filtrar os emails específicos enviados pela regra de Recompensa de Desempenho e acionar fluxos de trabalho correspondentes.
Esse método é simples e utiliza a infraestrutura de email para notificações.
Solução 2: Usando Comissão de Ação de $0, General Callback URL e Application Callbacks
Duplique a Regra de Recompensa de Desempenho:
- Duplique sua regra de Recompensa de Desempenho como acima, mas altere a ação para “adicionar bônus de comissão de ação” e selecione uma comissão de ação de $0 (veja Comissões de Ação
).
General Callback URL (Todas as Contas):
- Vá para Configuração > Configurações de rastreamento > Callback tracking.
- Configure o General Callback URL
para receber notificações de todas as comissões rastreadas (venda ou ação).
- Em seu endpoint, escute e processe apenas as comissões de ação de $0 específicas disparadas pela sua regra de Recompensa de Desempenho.
Application Callbacks (Apenas Planos Ultimate/Network):
- Vá para Configuração > Callbacks e utilize a opção “Adicionar callback de rastreamento de venda”.
- Selecione sua comissão de ação de $0 em “Tipo de comissão” e informe a URL do seu endpoint.
- Assim, apenas o tipo de comissão selecionado irá acionar o callback.
Suprimir Notificações por Email para Afiliado em Comissões de $0:
- Por padrão, os afiliados verão essas comissões de ação de $0 em seu painel.
- Para evitar que recebam notificações por email, vá em Configuração > Notificações por email > Notificações para afiliados e marque a caixa “Valor padrão para afiliado” ao lado de “Desativar notificações de comissão zero em Venda / Lead”.
Nota: A principal desvantagem dessa abordagem é que os afiliados ainda verão essas comissões de $0 em seus painéis (mas não receberão email se as notificações estiverem desativadas).
Boas Práticas para Automação e Notificações de API no Post Affiliate Pro
- Utilize campos dedicados ou ocultos para gatilhos de automação, evitando confusão ou alterações acidentais.
- Documente claramente todos os fluxos de automação e quais campos ou plugins são usados para notificações.
- Proteja seus endpoints de webhook e callback para aceitar apenas solicitações confiáveis.
- Teste cada solução cuidadosamente para garantir que as notificações sejam entregues conforme esperado.
- Revise regularmente as regras de Recompensa de Desempenho, configurações de plugins e campanhas para garantir a continuidade e confiabilidade.
O que são Recompensas de Desempenho no Post Affiliate Pro?
Recompensas de Desempenho são regras poderosas que concedem automaticamente bônus, atualizam perfis de afiliados ou acionam ações personalizadas quando os afiliados atingem marcos específicos, como determinado número de vendas, indicações ou outras atividades rastreadas. As ações podem incluir concessão de bônus, alteração de grupos de comissão, envio de notificações ou atualização (inclusive de campos ocultos) de perfil.
Como Configurar e Escolher a Melhor Solução
- Para notificações invisíveis e internas: Use o campo de perfil oculto e o Affiliate Profile Change Webhook.
- Para processamento baseado em email: Use a ação “enviar email para” com o plugin Emails Callback Webhook.
- Para notificações baseadas em comissão: Use uma comissão de ação de $0 com General Callback URL ou Application Callbacks, ciente da visibilidade no painel do afiliado.
Guia Passo a Passo: Exemplo de Campo de Perfil Oculto + Webhook
- Vá para Configuração > Recompensas de Desempenho.
- Edite ou crie uma regra e selecione “Atualizar usuário” em Ações.
- Escolha (ou crie) um campo de perfil e defina-o como Oculto.
- Defina o valor desejado que irá acionar seu fluxo de trabalho.
- Instale e configure o plugin Affiliate Profile Change Webhook para monitorar esse campo.
- Informe o endpoint da sua API externa nas configurações do plugin.
- Teste o fluxo de trabalho atingindo as condições da Recompensa de Desempenho e verifique se o webhook foi disparado.
Guia Passo a Passo: Exemplo de Comissão de Ação de $0 + General Callback URL
- Duplique sua regra de Recompensa de Desempenho, defina a ação para “adicionar bônus de comissão de ação” e escolha um tipo de comissão de $0.
- Configure o General Callback URL em Configuração > Configurações de rastreamento > Callback tracking.
- Em seu endpoint, filtre callbacks recebidos para o tipo de comissão de $0 específico.
- Opcionalmente, desative emails de notificação para afiliados em comissões zeradas.
- Teste acionando a recompensa e confirme o comportamento do callback e do endpoint.
Resumo
O Post Affiliate Pro não oferece notificações diretas de API a partir de regras de Recompensa de Desempenho, mas com estas soluções comprovadas—campo de perfil oculto mais webhook, callback de email ou comissão de ação de $0 com callback—você pode automatizar notificações externas e integrações de forma confiável, adaptando-se à sua necessidade na gestão de afiliados.
