Cómo notificar a una API externa cuando se activa una recompensa por rendimiento en Post Affiliate Pro

Definición del problema

Los gestores de programas de afiliados a menudo necesitan que Post Affiliate Pro notifique automáticamente a sistemas externos—como APIs, CRMs o aplicaciones personalizadas—cuando se activan reglas específicas de Recompensa por Rendimiento (por ejemplo, cuando un afiliado recluta cierto número de subafiliados o alcanza un hito de ventas). Sin embargo, Post Affiliate Pro no ofrece una función incorporada para llamar a una API externa directamente desde una regla de Recompensa por Rendimiento.

Para salvar esta carencia, se pueden implementar varias soluciones flexibles que permiten crear automatizaciones y notificaciones externas con mínima interrupción en tu flujo de trabajo de afiliados.

Uso de un campo de perfil oculto y el webhook de cambio de perfil de afiliado (Recomendado e invisible para los afiliados)

1. Actualiza un campo de perfil oculto mediante la Recompensa por Rendimiento:

   • En la sección “Acciones” de tu regla de Recompensa por Rendimiento, selecciona “Actualizar usuario” y elige un campo de perfil para actualizar.
   • Establece este campo de perfil como Oculto en la configuración del perfil de afiliado para que no sea visible para los afiliados y solo se use para automatización interna.

2. Configura el plugin Affiliate Profile Change Webhook:

   • Instala y configura el plugin Affiliate Profile Change Webhook .
   • Configúralo para monitorear el campo de perfil oculto que actualizas.
   • Cuando el campo cambie, el plugin enviará un webhook (HTTP POST) con los detalles del afiliado a tu endpoint de API externa.

Este enfoque garantiza que solo tu sistema sea notificado y los afiliados no sepan de la existencia ni los cambios de ese campo.

Solución 1: Usar la acción “Enviar correo electrónico a” y el Emails Callback Webhook

1. Duplica la regla de Recompensa por Rendimiento:

   • Crea un duplicado de tu regla original de Recompensa por Rendimiento, manteniendo las mismas condiciones.
   • En la acción, elige “enviar correo electrónico a” y configúralo para enviar un email al comerciante.

2. Configura el plugin Emails Callback Webhook:

   • Instala y configura el plugin Emails Callback Webhook .
   • Este plugin procesa todos los correos electrónicos salientes y los reenvía como solicitudes HTTP a tu endpoint externo.

3. Detecta y procesa la notificación:

   • Tu sistema externo puede filtrar los correos específicos enviados por tu regla de Recompensa por Rendimiento y activar los flujos de trabajo correspondientes.

Este método es sencillo y aprovecha la infraestructura de correo para las notificaciones.

Solución 2: Usar comisión de acción de $0, URL de Callback General y Callbacks de Aplicación

1. Duplica la regla de Recompensa por Rendimiento:

   • Duplica tu regla de Recompensa por Rendimiento como en el paso anterior, pero cambia la acción a “añadir bono de comisión de acción” y selecciona una comisión de acción de $0 (ver Comisiones por Acción ).

2. URL de Callback General (todas las cuentas):

   • Ve a Configuración > Ajustes de seguimiento > Callback tracking.
   • Configura la URL de Callback General para recibir notificaciones por cada comisión rastreada (venta o acción).
   • En tu endpoint, escucha y procesa solo las comisiones de acción de $0 específicas activadas por tu regla de Recompensa por Rendimiento.

3. Callbacks de Aplicación (solo planes Ultimate/Network):

   • Ve a Configuración > Callbacks y usa la opción “Añadir callback de seguimiento de venta”.
   • Selecciona tu comisión de acción de $0 en “Tipo de comisión”, e indica la URL de tu endpoint.
   • Esto asegura que solo el tipo de comisión seleccionado active el callback.

4. Suprime las notificaciones por correo a afiliados para comisiones de $0:

   • Por defecto, los afiliados verán estas comisiones de acción de $0 en su panel.
   • Para evitar que reciban notificaciones por correo, ve a Configuración > Notificaciones por correo > Notificaciones a afiliados y marca la casilla “Valor predeterminado para el afiliado” junto a “Desactivar notificaciones de comisión cero en venta / lead”.

Nota: La principal desventaja de este enfoque es que los afiliados aún verán estas comisiones de $0 en sus paneles (aunque no por correo si las notificaciones están desactivadas).

Buenas prácticas para automatización y notificaciones API en Post Affiliate Pro

• Usa campos dedicados u ocultos para los disparadores de automatización y evitar confusión o cambios accidentales.
• Documenta claramente todos los flujos de automatización y qué campos o plugins se usan para notificaciones.
• Asegura tus endpoints de webhook y callback para aceptar solo solicitudes de confianza.
• Prueba cada solución a fondo para asegurar que las notificaciones se entregan como esperas.
• Revisa regularmente las reglas de Recompensa por Rendimiento, la configuración de plugins y de campañas para garantizar la confiabilidad.

¿Qué son las Recompensas por Rendimiento en Post Affiliate Pro?

Las Recompensas por Rendimiento son reglas potentes que otorgan automáticamente bonificaciones, actualizan perfiles de afiliados o disparan acciones personalizadas cuando los afiliados logran hitos específicos, como un número determinado de ventas, referidos u otras actividades rastreadas. Las acciones pueden incluir otorgar bonificaciones, cambiar grupos de comisión, enviar notificaciones o actualizar (incluidos los ocultos) campos de perfil.

Cómo configurar y elegir la mejor solución

• Para notificaciones internas e invisibles: Usa el campo de perfil oculto y el plugin Affiliate Profile Change Webhook.
• Para procesamiento basado en correo electrónico: Usa la acción “enviar correo electrónico a” con el plugin Emails Callback Webhook.
• Para notificaciones basadas en comisiones: Usa una comisión de acción de $0 con la URL de Callback General o los Callbacks de Aplicación, teniendo en cuenta la visibilidad en el panel del afiliado.

Guía paso a paso: Ejemplo de campo de perfil oculto + webhook

1. Ve a Configuración > Recompensas por Rendimiento.
2. Edita o crea una regla y selecciona “Actualizar usuario” en las Acciones.
3. Elige (o crea) un campo de perfil, márcalo como Oculto.
4. Establece el valor que deseas para activar tu flujo de trabajo.
5. Instala y configura el plugin Affiliate Profile Change Webhook para monitorear ese campo.
6. Ingresa tu endpoint de API externa en los ajustes del plugin.
7. Prueba el flujo de trabajo cumpliendo las condiciones de la Recompensa por Rendimiento y verifica que el webhook se ejecute.

Guía paso a paso: Ejemplo de comisión de acción de $0 + URL de Callback General

1. Duplica tu regla de Recompensa por Rendimiento, establece la acción en “añadir bono de comisión de acción” y elige un tipo de comisión de $0.
2. Configura la URL de Callback General en Configuración > Ajustes de seguimiento > Callback tracking.
3. En tu endpoint, filtra los callbacks recibidos para tu tipo de comisión de $0 específico.
4. Opcionalmente, desactiva los correos de notificación a afiliados para comisiones cero.
5. Prueba activando la recompensa y confirma el comportamiento del callback y de tu endpoint.

Resumen

Post Affiliate Pro no ofrece notificaciones directas a API desde reglas de Recompensa por Rendimiento, pero con estas soluciones comprobadas—campo de perfil oculto más webhook, callback por correo electrónico, o comisión de acción de $0 con callback—puedes automatizar notificaciones externas e integraciones de forma confiable según las necesidades de gestión de tu programa de afiliados.