¿Qué son los Callbacks de Aplicación en Post Affiliate Pro?
Descubra cómo funcionan los Callbacks de Aplicación en Post Affiliate Pro. Conozca los disparadores de eventos personalizables para ventas, leads y registros de...
9 min de lectura
Disponible en:
Post Affiliate Pro , Post Affiliate Pro Ultimate , Post Affiliate Network
¿Qué son los Webhooks y Callbacks?
Los webhooks (también llamados Application Callbacks o Postback URLs) son notificaciones HTTP automatizadas que Post Affiliate Pro envía a sistemas externos cuando ocurren eventos específicos. En lugar de consultar constantemente por actualizaciones, tus sistemas conectados reciben notificaciones instantáneas en el momento en que algo sucede en tu programa de afiliados.
Esta función es esencial para:
- Integración CRM - Actualizar automáticamente tu base de datos de clientes cuando ocurren ventas
- Automatización de Email - Disparar secuencias de email basadas en acciones de afiliados
- Sistemas Contables - Sincronizar datos de transacciones con tu software financiero
- Dashboards Personalizados - Construir dashboards de informes en tiempo real
- Seguimiento de Terceros - Notificar a plataformas de seguimiento externas sobre conversiones
Tipos de Webhooks
Post Affiliate Pro soporta dos tipos principales de webhooks:
Webhooks de Seguimiento de Ventas
Estos webhooks son disparados por eventos relacionados con transacciones:
| Evento Disparador | Descripción |
|---|---|
| Al Crear | Se dispara inmediatamente cuando se registra una nueva transacción (venta, acción, lead) |
| Al Aprobar | Se dispara cuando se aprueba una transacción pendiente |
| Al Rechazar | Se dispara cuando se rechaza una transacción |
| Al Reembolsar/Contracargo | Se dispara cuando se procesa un reembolso o contracargo |
Puedes configurar un solo webhook para dispararse en múltiples eventos, o crear webhooks separados para cada tipo de evento.
Webhooks de Registro de Afiliados
Estos webhooks son disparados por eventos de registro de afiliados:
| Evento Disparador | Descripción |
|---|---|
| Al Registrar | Se dispara inmediatamente cuando un nuevo afiliado completa el formulario de registro |
| Al Aprobar | Se dispara cuando un afiliado pendiente es aprobado por un comerciante |
Tipos de Solicitud
Post Affiliate Pro soporta tres tipos de solicitud HTTP para webhooks:
Solicitud GET
Los parámetros se agregan a la URL como parámetros de query string.
https://tu-sistema.com/webhook?transactionid=abc123&commission=50.00&orderid=ORD-456
Solicitud POST (Form-Urlencoded)
Los parámetros se envían en el cuerpo de la solicitud usando codificación de formulario estándar.
Content-Type: application/x-www-form-urlencoded
transactionid=abc123&commission=50.00&orderid=ORD-456
Solicitud POST JSON
Los parámetros se envían como un objeto JSON en el cuerpo de la solicitud.
Content-Type: application/json
{"transactionid": "abc123", "commission": "50.00", "orderid": "ORD-456"}
Variables Disponibles para Webhooks de Ventas
Puedes usar variables dinámicas en tus URLs de webhook que se reemplazan automáticamente con valores reales. Usa el formato ${#nombrevariable#} para incluir una variable.
Datos de Transacción
| Variable | Descripción |
|---|---|
${#transactionid#} | Identificador único de transacción |
${#visitorid#} | ID de visitante (cookie de seguimiento) |
${#commission#} | Monto de comisión |
${#totalcost#} | Valor total del pedido |
${#fixedcost#} | Monto de costo fijo |
${#orderid#} | ID de pedido de tu sistema de e-commerce |
${#productid#} | ID de producto |
${#dateinserted#} | Fecha y hora de creación de la transacción |
${#dateapproved#} | Fecha y hora de aprobación de la transacción |
${#tier#} | Nivel de tier de comisión |
${#status#} | Estado de transacción (Aprobado, Pendiente, Rechazado) |
${#statuscode#} | Código de estado (A, P, D) |
${#type#} | Tipo de transacción (Venta, Acción, etc.) |
Datos de Campaña y Banner
| Variable | Descripción |
|---|---|
${#campaignid#} | Identificador de campaña |
${#campaignname#} | Nombre de campaña |
${#bannerid#} | Identificador de banner |
${#channel#} | Nombre del canal |
${#channel_code#} | Código del canal |
${#coupon_code#} | Código de cupón usado |
Datos de Afiliado
| Variable | Descripción |
|---|---|
${#userid#} | ID de usuario del afiliado |
${#refid#} | ID de referencia del afiliado |
Datos de Clic
| Variable | Descripción |
|---|---|
${#firstclicktime#} | Marca de tiempo del primer clic |
${#firstclickreferer#} | URL de referencia del primer clic |
${#firstclickip#} | Dirección IP del primer clic |
${#firstclickdata1#} | Datos personalizados 1 del primer clic |
${#firstclickdata2#} | Datos personalizados 2 del primer clic |
${#lastclicktime#} | Marca de tiempo del último clic |
${#lastclickreferer#} | URL de referencia del último clic |
${#lastclickip#} | Dirección IP del último clic |
${#lastclickdata1#} | Datos personalizados 1 del último clic |
${#lastclickdata2#} | Datos personalizados 2 del último clic |
Datos Personalizados de Transacción
| Variable | Descripción |
|---|---|
${#saledata1#} | Campo de datos personalizados de transacción 1 |
${#saledata2#} | Campo de datos personalizados de transacción 2 |
${#saledata3#} | Campo de datos personalizados de transacción 3 |
${#saledata4#} | Campo de datos personalizados de transacción 4 |
${#saledata5#} | Campo de datos personalizados de transacción 5 |
Datos Geográficos y Técnicos
| Variable | Descripción |
|---|---|
${#ip#} | Dirección IP del cliente |
${#countrycode#} | Código de país basado en IP |
${#refererurl#} | URL de referencia |
Datos de Moneda
| Variable | Descripción |
|---|---|
${#originalcurrency#} | Nombre de moneda original |
${#originalcurrencyvalue#} | Valor de moneda original |
${#originalcurrencyrate#} | Tasa de cambio usada |
Notas
| Variable | Descripción |
|---|---|
${#merchantnote#} | Nota visible para el afiliado |
${#systemnote#} | Nota visible solo para el comerciante |
${#actionName#} | Nombre del tipo de comisión de acción |
${#actionCode#} | Código del tipo de comisión de acción |
Variables Disponibles para Webhooks de Registro
Para webhooks de registro de afiliados, puedes usar variables del perfil del afiliado:
| Variable | Descripción |
|---|---|
${#username#} | Email/nombre de usuario del afiliado |
${#firstname#} | Nombre del afiliado |
${#lastname#} | Apellido del afiliado |
${#name#} | Nombre completo (nombre + apellido) |
${#userId#} | ID de usuario del afiliado |
| Campos personalizados | Cualquier campo de perfil personalizado por su código |
Soporte Multi-Tier
Por defecto, los webhooks se ejecutan solo para comisiones de tier 1 (directas). Puedes habilitar la opción “Ejecutar para cada tier” para disparar webhooks para todos los niveles de tier en estructuras de comisión multi-tier.
Esto es útil cuando:
- Necesitas rastrear comisiones en todos los niveles de tu jerarquía de afiliados
- Tu sistema externo necesita saber sobre ganancias de sub-afiliados
- Estás construyendo informes completos que incluyen todos los niveles de comisión
Opciones de Filtrado de Webhooks
Puedes configurar webhooks para ser más específicos:
Por Tipo de Comisión
Limita el webhook a un tipo de comisión específico (ej., solo para comisiones de acción “Ventas Premium”).
Por Afiliado
Crea webhooks que solo se disparen para un afiliado específico. Esto es útil para:
- Afiliados que usan sus propios sistemas de seguimiento
- Integraciones especiales para afiliados de alto rendimiento
- Probar webhooks con un solo afiliado antes de implementar
Por Cuenta (Modo Red)
En Post Affiliate Network, puedes crear webhooks específicos por cuenta.
Registro y Monitoreo de Webhooks
Post Affiliate Pro mantiene un registro completo de todas las ejecuciones de webhooks, accesible en el panel de comerciante bajo Herramientas > Registro de Callbacks.
El registro muestra:
- ID de Registro - Identificador único para cada ejecución de webhook
- ID de Callback - Qué configuración de webhook se usó
- URL de Solicitud - La URL completa que se llamó (con variables reemplazadas)
- Fecha de Creación - Cuándo se encoló el webhook
- Último Reintento - Cuándo se hizo el último intento de ejecución
- Número de Reintento - Cuántas veces el sistema intentó ejecutar
- Estado - Pendiente, Enviado o Error
- Mensaje de Error - Detalles si el webhook falló
Reintento Automático
Si un webhook falla (ej., tu servidor está temporalmente no disponible), Post Affiliate Pro reintentará automáticamente la solicitud. Esto asegura entrega confiable incluso durante interrupciones temporales.
Retención de Registros
Los registros de webhooks se limpian automáticamente después de un número configurable de días (predeterminado: 60 días). Puedes ajustar esto en Configuración > Funciones > Application Callbacks.
Gestión de Webhooks
Flujo de Trabajo de Aprobación
Por defecto, los webhooks creados por afiliados requieren aprobación del comerciante antes de activarse. Los comerciantes pueden:
- Habilitar auto-aprobación - Aprobar automáticamente todos los nuevos webhooks
- Revisar manualmente - Aprobar o rechazar cada webhook individualmente
Gestión de Estado
Los webhooks tienen tres estados posibles:
- Aprobado - Activo y se ejecutará cuando se dispare
- Pendiente - Esperando aprobación del comerciante
- Rechazado - Rechazado y no se ejecutará
Los comerciantes pueden cambiar el estado del webhook en cualquier momento desde la pantalla de gestión de webhooks.
Notificaciones por Email
Post Affiliate Pro puede enviar notificaciones por email para eventos relacionados con webhooks:
Notificaciones al Comerciante
- Nuevo webhook creado por afiliado
Notificaciones al Afiliado (Opcional)
- Estado del webhook cambiado (aprobado/rechazado)
- Webhook modificado por comerciante
- Webhook eliminado por comerciante
Estas notificaciones pueden habilitarse o deshabilitarse en Configuración > Notificaciones por Email.
Ejemplos de Casos de Uso
1. Integración CRM
Envía datos de nueva venta a tu CRM cuando se aprueba una transacción:
https://crm.ejemplo.com/api/sales?customer_order=${#orderid#}&value=${#totalcost#}&affiliate=${#refid#}
2. Notificación de Slack
Notifica a tu canal de equipo cuando se registra un nuevo afiliado:
https://hooks.slack.com/services/xxx/yyy?text=Nuevo+afiliado:+${#firstname#}+${#lastname#}
3. Trigger de Plataforma de Email
Agrega clientes a una secuencia de email después de la compra:
POST https://email.ejemplo.com/api/subscribers
Body: {"email": "${#saledata1#}", "purchase_value": "${#totalcost#}"}
4. Sincronización con Software Contable
Registra pagos de comisiones en tu sistema contable:
https://contabilidad.ejemplo.com/webhook?affiliate_id=${#userid#}&commission=${#commission#}&order=${#orderid#}
Cómo Configurar un Webhook
- Inicia sesión en tu Panel de Comerciante
- Navega a Configuración > Funciones
- Activa la función Application Callbacks
- Ve a Campañas > [Seleccionar Campaña] > Callbacks o al gestor global de callbacks
- Haz clic en Agregar Nuevo Callback
- Configura:
- Nombre - Un nombre descriptivo para el webhook
- Tipo - Seguimiento de Ventas o Registro de Afiliados
- Ejecución - Cuándo disparar (al crear, aprobar, rechazar, reembolsar)
- Tipo de Solicitud - GET, POST o POST JSON
- URL - Tu endpoint con variables
- Ejecutar para cada tier - Sí/No
- Guarda el webhook
Consideraciones de Seguridad
- Usa endpoints HTTPS para transmisión segura de datos
- Considera agregar un parámetro secreto para verificar la fuente del webhook
- Implementa limitación de velocidad en tu endpoint receptor
- Valida los datos entrantes antes de procesar
- Mantén registros de webhooks para propósitos de auditoría
Funciones Relacionadas
- Seguimiento S2S - Seguimiento servidor a servidor para conversiones precisas
- API - Acceso programático completo a Post Affiliate Pro
- API v3 - API RESTful moderna con OAuth 2.0
