Conectar ActiveCampaign

La mayoría de las integraciones piden un solo token. ActiveCampaign pide dos cosas, porque cada cuenta vive en su propio subdominio: una URL de API del tipo https://acmecorp.api-us1.com y una clave de API. Ambas están en la misma pantalla: Configuración → Desarrollador. La segunda mitad de esta página trata lo que de verdad sorprende a la gente: qué hace, y qué no hace, ActiveCampaign con un contacto una vez que existe.

Por qué ActiveCampaign necesita dos valores

ActiveCampaign no coloca a todos sus clientes tras un único nombre de host de API compartido. Tu cuenta reside en un subdominio de centro de datos numerado — api-us1, api-us2, etc. — así que la clave por sí sola no indica adónde deben ir los datos. La URL identifica tu cuenta; la clave la autentica.

Antes de empezar

• Cualquier plan de ActiveCampaign sirve: la API está disponible en todos, incluido el plan de marketing de entrada.
• Comprueba si tu cuenta tiene Deals (negocios). Los Deals pertenecen al lado de ventas de ActiveCampaign y no se incluyen en los planes más económicos. Si el tuyo no los tiene, todo lo de esta página sigue siendo válido: los Contactos, las Listas y las Etiquetas existen en todos los planes.
• Recuerda para qué sirve ActiveCampaign: envía correo comercial. Que alguien toque tu tarjeta no es lo mismo que alguien pidiendo tu boletín, así que decide de antemano si los nuevos contactos deben entrar en una automatización de correo.

Paso 1 — Copia la URL de API y la clave desde Configuración → Desarrollador

No es la dirección de la barra del navegador. Tu URL de acceso se parece a acmecorp.activehosted.com: esa es la aplicación, no la API. La URL de la API siempre termina en .api-us1.com (o el número que use tu cuenta).

Paso 2 — Pega ambos en Anexus

En qué se convierte un contacto capturado dentro de ActiveCampaign

Anexus escribe cada contacto capturado mediante el endpoint sync de ActiveCampaign, que hace la correspondencia por dirección de correo: una dirección desconocida crea un Contacto nuevo, y una dirección que ya existe actualiza el contacto existente en lugar de duplicarlo.

Los campos básicos de un contacto de ActiveCampaign son pocos: correo, nombre, apellido, teléfono. Anexus también envía el resto de los datos que recogió tu formulario de intercambio — empresa, puesto, mensaje — junto con una nota que indica cómo se capturó el contacto. Abre el contacto real que capturaste en el paso 2 para ver exactamente qué llegó a tu cuenta antes de construir nada encima.

Además, tres cosas que uno esperaría encontrar en el contacto son objetos separados en ActiveCampaign:

• Listas — un contacto no está en una lista hasta que se suscribe a ella, y la pertenencia a una lista lleva su propio estado de suscripción.
• Etiquetas — rótulos libres, y la forma en que la mayoría de los usuarios de ActiveCampaign segmenta de verdad. Aparecen en el contacto, pero son registros propios.
• Deals y Cuentas — el lado de ventas. Un Deal es un registro separado vinculado a un contacto, y una Cuenta es el objeto de empresa de ActiveCampaign. Ninguno forma parte del registro de contacto de arriba.

Las automatizaciones no se disparan como la gente supone

Vale la pena leerlo dos veces, porque la automatización suele ser justo el motivo por el que se conecta ActiveCampaign.

• No existe un disparador genérico de “se creó un contacto”. Las automatizaciones de ActiveCampaign parten de eventos como Se suscribe a una lista, Se añade una etiqueta, Envía un formulario o Cambia un campo personalizado. Así que abre el contacto real que capturaste en el paso 2 y mira qué tiene de verdad: qué listas, qué etiquetas. Eso es lo que te dice qué disparador puede activarse para los contactos que llegan desde Anexus.
• Las automatizaciones no son retroactivas. Un contacto que ya existía cuando activaste la automatización no entra en ella. Crea primero la automatización y captura después.
• Revisa la opción Ejecuciones del disparador. Si se ejecuta una sola vez, alguien que vuelve y cuyo contacto solo se actualiza no volverá a entrar en la automatización. Si se ejecuta varias veces, sí puede: bien para una secuencia de seguimiento, muy mal para un correo de bienvenida.
• Como el endpoint sync actualiza en vez de duplicar, alguien que vuelve y da la misma dirección sigue siendo un contacto, actualizado. Eso suele ser lo deseable, pero también implica que el segundo toque no es un evento de suscripción nuevo.

Estado de suscripción y consentimiento

ActiveCampaign registra el estado por lista, no por contacto: activo, sin confirmar, dado de baja, rebotado. Existir en tu cuenta y ser contactable por correo son dos estados distintos.

• Quien se dio de baja sigue de baja. Si alguien se dio de baja de tu lista en el pasado, volver a sincronizarlo no lo reincorpora, y así debe ser. Solo esa persona puede volver a suscribirse.
• El doble opt-in deja a la gente en “sin confirmar”. Si una lista exige confirmación, el contacto se queda ahí hasta que haga clic en el correo de confirmación. Existe, pero todavía no es contactable, y eso se parece exactamente a una sincronización rota si no sabes dónde mirar.
• Si vendes en Canadá, trata la captura y la suscripción como dos eventos distintos. Una tarjeta tocada es una conversación; una suscripción de correo es un permiso. Guarda tu propio registro de cómo y cuándo se dio el consentimiento.

Sincronizar los contactos capturados antes

Sincronizar contactos anteriores, en la tarjeta de ActiveCampaign, envía todo lo capturado antes de conectar. Dos particularidades de ActiveCampaign que conviene anticipar:

• ActiveCampaign limita la tasa de su API — cinco solicitudes por segundo por cuenta es el techo documentado —, así que una sincronización grande llega de forma sostenida, por lotes, en vez de toda de golpe. Déjala terminar.
• Si ya tienes una automatización activa con un disparador que estos contactos van a cumplir, una sincronización puede meter a cientos de personas de golpe, y todas reciben el correo que esté al principio. Pausa la automatización, ejecuta la sincronización, revisa el resultado y vuelve a activarla.

Cuando algo va mal

"ActiveCampaign rechazó la clave de API"

Comprueba la URL antes que nada: empieza por https://; termina en .api-us<número>.com y no en .activehosted.com; el número del centro de datos coincide con el de tu página Desarrollador. Si esos tres puntos están bien, vuelve a copiar la clave: una clave seleccionada arrastrando suele perder un carácter al final.

Funcionó durante meses y de pronto dejó de funcionar

Dos causas propias de ActiveCampaign. O alguien regeneró la clave de API en la página Desarrollador — la clave antigua muere en el instante en que aparece la nueva — o el usuario de ActiveCampaign al que pertenecía la clave fue desactivado o eliminado de la cuenta. Reconéctate con una clave vigente de un usuario activo. El botón Probar de la tarjeta te dice de qué lado está el problema antes de ponerte a adivinar.

El contacto está, pero no salió ningún correo

Abre la ficha del contacto y ve bajando: ¿está en alguna lista?; ¿el estado en esa lista es activo y no sin confirmar, dado de baja o rebotado?; ¿y la automatización que esperabas tenía un disparador que este contacto cumpliera de verdad? Una automatización activada después de crear el contacto no vuelve atrás a buscarlo.

Dos contactos para la misma persona

ActiveCampaign hace la correspondencia por correo y por nada más. La misma persona que da una dirección personal en un evento y una del trabajo en el siguiente son, para ActiveCampaign, dos contactos distintos, y no los fusionará por su cuenta. Fusiónalos dentro de ActiveCampaign si te importa; del lado de Anexus no hay nada que cambiar.

Un contacto no llegó nunca

Si el formulario de intercambio se envió sin una dirección de correo válida, no hay nada que enviar: ActiveCampaign identifica los contactos por correo y no acepta ninguno sin él. Revisa primero el contacto en tu Mini CRM de Anexus: si ahí falta el correo o está mal escrito, esa es la respuesta.

Desconectar, y por qué la clave es la parte incómoda

Haz clic en Desconectar en Anexus y dejamos de enviar de inmediato. Los contactos que ya están en ActiveCampaign se quedan exactamente donde están.

La particularidad de ActiveCampaign: la clave de API no está acotada por integración, así que no hay un interruptor que revoque solo esta conexión. Si necesitas que la credencial quede inutilizable y no solo sin uso, regenerarla en Configuración → Desarrollador la mata al instante, junto con cualquier otra herramienta, plataforma de automatización o script que apunte a la misma cuenta. Haz ese inventario antes de hacer clic.

Qué sigue

• Volver a todas las integraciones CRM
• Gestionar contactos en Anexus — las notas que añades en el Mini CRM se quedan en Anexus y nunca llegan a ActiveCampaign