Documentación de Rekomi
Para marcasIntegraciones CRM
Marcas

ActiveCampaign

Conecta ActiveCampaign para que los afiliados aprobados entren en tu lista de contactos y reciban etiquetas automáticamente.

Logo de ActiveCampaign

La integración de ActiveCampaign en Rekomi añade a cada afiliado aprobado a la lista que elijas y le aplica etiquetas para que puedas identificarlo en tu panel de AC.

Qué se sincroniza

Cuando un afiliado es aprobado (o, si lo activas, cuando solicita acceso):

  • Se crea o actualiza un contacto mediante POST /api/3/contact/sync con email, firstName y lastName.
  • El contacto se suscribe a la lista que elegiste mediante POST /api/3/contactLists con status = 1.
  • Cada etiqueta configurada se resuelve por nombre (o se crea si no existe) y se aplica mediante POST /api/3/contactTags.

El endpoint "sync" se puede reintentar sin riesgo: volver a sincronizar al mismo afiliado actualiza el contacto existente en lugar de crear un duplicado. Las tres llamadas son completamente síncronas, así que un estado "Correcta" en Rekomi significa que el contacto está de verdad en tu lista.

Dónde encontrar tu clave de API y tu URL

En ActiveCampaign:

  1. Haz clic en el icono de engranaje arriba a la derecha y luego en Developer en la barra lateral izquierda.
  2. La página API Access muestra tanto la URL (por ejemplo, https://your-account.api-us1.com) como la Key.
  3. Copia las dos.

Conectar ActiveCampaign en Rekomi

  1. Ve a Integraciones en la barra lateral del panel.
  2. Haz clic en la tarjeta de ActiveCampaign.
  3. Pega la URL de la API y la clave de API. Haz clic en Conectar.
  4. Rekomi hace una llamada de prueba a GET /api/3/users/me para verificar ambas credenciales. Si la URL no está en api-us1.com o la clave no es válida, el formulario rechaza la conexión y muestra el error real de ActiveCampaign.
  5. Una vez conectado, elige una lista predeterminada en el desplegable. La lista se obtiene de tu cuenta de AC.

El formulario de conexión de ActiveCampaign en Rekomi con los campos de URL de la API y clave de API y el botón Conectar

Etiquetas

Separadas por comas. Cada nombre de etiqueta se resuelve contra GET /api/3/tags?search= (coincidencia exacta del nombre). Si no existe una etiqueta con ese nombre, Rekomi la crea mediante POST /api/3/tags con tagType: "contact". Las etiquetas se asignan después al contacto mediante POST /api/3/contactTags. La etiqueta de sistema Rekomi affiliate se aplica siempre.

Si falla la aplicación de una etiqueta, la suscripción no se deshace (el contacto ya está en la lista); el fallo queda registrado para que puedas investigarlo.

Clientes y leads referidos (opcional)

Activa Sincronizar clientes y leads referidos en la página de la integración y cada venta o lead que Rekomi atribuye a un afiliado se escribe también en ActiveCampaign, emparejado por correo para que los contactos existentes se actualicen en lugar de duplicarse. Cada uno lleva:

  • campos de contacto personalizados llamados Rekomi referral link, Rekomi campaign, Rekomi referring affiliate, Rekomi referring affiliate code, Rekomi last event y Rekomi last sale amount (etiquetas de personalización %REKOMI_REFERRAL_LINK% y similares), creados por ti en el primer uso y visibles en todas las listas
  • las etiquetas Rekomi customer o Rekomi lead, añadidas sin tocar tus otras etiquetas
  • Los afiliados sincronizados por la sección anterior también reciben Rekomi referral link, Rekomi campaign y Rekomi affiliate status en los mismos campos, para que puedas insertar el enlace de un partner en tus correos.

Las conversiones reembolsadas, denegadas o en cuarentena por fraude nunca se envían, y las conversiones históricas importadas se omiten. Está desactivado por defecto.

Cuándo se dispara la sincronización

  • Por defecto: solo se sincronizan los afiliados Approved. La tarea se dispara en el momento en que se aprueba un afiliado (de forma manual, en bloque o por aprobación automática).
  • Opcional: activa "Incluir solicitantes antes de la aprobación" en la tarjeta de configuración del proveedor para sincronizar también a los afiliados Pending en el momento en que solicitan acceso.

Ajustes por campaña

Cada campaña puede sobrescribir la configuración general de la cuenta. Desde la página de detalle de una campaña, abre la pestaña Configuración y baja hasta la sección Sincronización CRM para esta campaña para:

  • Desactivar ActiveCampaign en esta campaña.
  • Enviar los afiliados de esta campaña a una lista distinta.
  • Añadir etiquetas propias de la campaña además de las predeterminadas de la cuenta.

Estado de sincronización por afiliado

Abre la página de detalle de cualquier afiliado. El panel Sincronización CRM muestra el estado de ese afiliado en cada CRM. El botón Resincronizar limpia las filas de tareas anteriores y vuelve a lanzar la sincronización de principio a fin.

Solución de problemas

  • "API URL must be on api-us1.com": el endpoint público de la API de ActiveCampaign está siempre en api-us1.com, incluso en cuentas migradas a EU/APAC. Vuelve a copiar la URL exacta desde los ajustes de Developer.
  • list_link_failed: http_404: el ID de la lista a la que Rekomi intenta enviar ya no existe. Elige otra lista en el desplegable.
  • Límite de 429: ActiveCampaign limita a 5 solicitudes por segundo por cuenta. Rekomi limita su worker a una suscripción por segundo y la secuencia de suscripción hace 3+N(etiquetas) llamadas; las resincronizaciones en ráfaga pueden toparse con el límite. La tarea se reintenta automáticamente respetando Retry-After.
  • La sincronización falla con 401/403 después de haber funcionado: la clave de API fue revocada o regenerada. Rekomi marca la integración como "requiere acción" y te envía un correo para reconectar, una vez por cada rotura. Reconecta con credenciales nuevas y luego usa Resincronizar todo en la tarjeta Fallidos de la página de la integración.

Desconectar

Desde la página de conexión de ActiveCampaign, haz clic en Desconectar. Rekomi:

  • Elimina la fila de la integración por completo (no queda ningún estado residual).
  • Elimina cualquier ajuste por campaña que apunte a ella.
  • Conserva los registros históricos de sincronización para auditoría.

Puedes reconectar cuando quieras; empieza desde cero.


Consulta la visión general de la integración con ActiveCampaign en el sitio de marketing para casos de uso, perfiles a los que encaja y patrones de automatización propios.