Configurar la integración con ActiveCampaign
La integración con ActiveCampaign envía los datos de contacto recopilados por tu agente IA directamente a tu cuenta de ActiveCampaign. Los nuevos leads aparecen automáticamente en tu lista de contactos, listos para seguimiento o campañas de email.
En resumen
Heyloha se conecta a ActiveCampaign a través de tu URL API y tu clave API. Los campos estándar (nombre, email, teléfono) se sincronizan automáticamente. Para datos de dirección, se necesitan IDs de campos personalizados.
¿Qué se sincroniza?
Los siguientes campos estándar se sincronizan automáticamente con ActiveCampaign:
- Nombre y apellido
- Dirección de correo electrónico
- Número de teléfono
Dirección, código postal, ciudad y país también se pueden sincronizar, pero requieren IDs de campos personalizados.
El endpoint de sincronización de contactos de ActiveCampaign actualiza automáticamente los contactos existentes cuando el email coincide.
¿Qué necesitas?
- Una cuenta de ActiveCampaign con acceso API (disponible en todos los planes).
- Tu URL API y tu clave API (en Configuración > Developer).
- Una cuenta activa de Heyloha con al menos un agente IA.
- Opcional: IDs de campos personalizados para dirección, código postal, ciudad y país.
Encontrar tus credenciales API en ActiveCampaign
Ve a Configuración
Inicia sesión en ActiveCampaign y ve a Configuración > Developer.
Copia tu URL API
La URL API se ve así: https://tucuenta.api-us1.com. Tu URL puede variar según tu región (por ej. api-eu1.com para Europa). Copia la URL exacta de tu cuenta de ActiveCampaign.
Copia tu clave API
La clave API está justo debajo de la URL API. Cópiala también.
IDs de campos personalizados para datos de dirección (opcional)
Si también quieres sincronizar datos de dirección, necesitas los IDs numéricos de tus campos personalizados:
Ve a Manage Fields
En ActiveCampaign, ve a Configuración > Manage Fields.
Busca o crea los campos
Busca los campos para dirección, código postal, ciudad y país. Créalos si no existen.
Anota los IDs numéricos
Cada campo personalizado tiene un ID numérico único. Lo encuentras haciendo clic en el campo y anotando el número en la URL. Anota los IDs para cada campo de dirección.
Configurar la integración en Heyloha
Ve a Agente, luego Integraciones
En el menú de la izquierda haz clic en Agente y abre la pestaña Integraciones. La sección Webhooks está arriba del todo.
Haz clic en Añadir webhook
En la sección Webhooks, haz clic en Añadir webhook. Se abre un formulario para configurar la conexión.
Elige 'ActiveCampaign' como plataforma
Selecciona ActiveCampaign en el formulario. El formulario muestra los campos para URL API y clave API.
Elige los canales (opcional)
Por defecto el webhook se aplica a todos los canales de tu agente. Para limitarlo, por ejemplo, solo al chat web o solo a WhatsApp, selecciona los canales que quieras. Si lo dejas vacío, la conexión se aplica a todos los canales.
Introduce tus credenciales API
Pega la URL API y la clave API que copiaste en ActiveCampaign.
Introduce los IDs de campos personalizados (opcional)
Cada campo personalizado tiene un ID numérico único. Lo encuentras haciendo clic en el campo y mirando el número en la URL. Anota los IDs para cada campo de dirección.
Nombra la integración
Elige un nombre reconocible, por ejemplo 'ActiveCampaign Leads'. Este nombre también se usa como nombre de función interna.
Selecciona los campos de contacto
Elige qué datos debe recopilar tu Agente IA. Selecciona al menos un correo electrónico.
Elige los disparadores de eventos
Selecciona cuándo debe activarse la integración: al capturar datos de contacto, al reservar una cita o al alcanzar un objetivo.
Describe cuándo debe usarse la conexión
Proporciona una instrucción sobre cuándo la IA debe activar esta integración.
Guarda y activa
Pon la integración en 'Activo' y haz clic en Guardar en el formulario. La conexión se activa al instante.
Probar la conexión
Después de guardar, prueba la conexión con el botón 'Probar conexión'. Se envía un contacto de prueba a ActiveCampaign.
- Verde 'Conectado': tus credenciales API son válidas.
- Error rojo: verifica tu URL API y tu clave API.
Registro de entrega
Cada intento de envío se registra. Heyloha reintenta hasta 4 veces en caso de errores temporales.
Preguntas frecuentes
¿Qué plan de ActiveCampaign necesito?
Cualquier plan con acceso API funciona. La clave API está disponible en Configuración > Developer.
¿Necesito crear campos personalizados para datos de dirección?
Solo si quieres sincronizar datos de dirección. Para nombre, email y teléfono, no se necesitan campos personalizados.
¿Puedo combinar ActiveCampaign con otras integraciones?
Sí. Cada agente IA puede tener múltiples integraciones.
Configurar integración HubSpotConfigurar integración webhook genérica