ActiveCampaign Contacts
ActiveCampaign Contacts conecta tu flujo con tu cuenta de ActiveCampaign para trabajar con los contactos: darlos de alta, buscarlos por su identificador o por su correo, cambiar sus datos, eliminarlos, ponerles o quitarles una etiqueta y suscribirlos a una lista o darlos de baja de ella. También puede consultar los usuarios de tu cuenta de ActiveCampaign, es decir, las personas de tu equipo que pueden ser dueñas de un trato.
Es útil cuando los contactos llegan desde otro sitio, como un formulario web, una tienda o un chat, y quieres que entren en ActiveCampaign con sus etiquetas y listas sin hacerlo a mano.
Cuándo usarlo
- Alguien rellena el formulario de tu web y quieres crear el contacto en ActiveCampaign y suscribirlo a tu lista de novedades.
- Un cliente compra un producto y quieres ponerle la etiqueta de cliente para que entre en tus automatizaciones de ActiveCampaign.
- Un agente de IA atiende a un cliente por chat y necesita buscar su ficha por correo antes de responder.
- Un cliente pide darse de baja y quieres quitarlo de una lista concreta sin borrar el contacto.
- Quieres saber qué usuarios de tu equipo existen en ActiveCampaign para asignarles tratos después.
Configuración
Necesitas una credencial ActiveCampaign con la URL de la API y la clave API de tu cuenta. Las encuentras en ActiveCampaign, en Settings > Developer. Consulta Credenciales.
| Campo | Qué hace |
|---|---|
| Credential (obligatorio) | La credencial ActiveCampaign con la que se accede a tu cuenta. |
| Operation (obligatorio) | Lo que hace el componente. Ver Operaciones. Por defecto, Create Contact. |
| Search By | Solo en Get Contact. ID busca el contacto por su identificador y Email por su correo. Por defecto, ID. |
| Get By | Solo en Get Users. By ID trae un usuario concreto y All trae la lista de usuarios. Por defecto, All. |
El correo del contacto. Obligatorio en Create Contact y en Get Contact con Email. En Update Contact, solo si quieres cambiarlo. | |
| First Name | El nombre del contacto. En Create Contact y Update Contact. |
| Last Name | Los apellidos del contacto. En Create Contact y Update Contact. |
| Phone | El teléfono del contacto. En Create Contact y Update Contact. |
| Contact ID | El identificador del contacto en ActiveCampaign. Obligatorio en todas las operaciones salvo Create Contact, Get Users y Get Contact con Email. |
| Tag ID | El identificador de la etiqueta. Obligatorio en Add Tag y Remove Tag. |
| List ID | El identificador de la lista. Obligatorio en Add to List y Remove from List. |
| User ID | El identificador del usuario. Obligatorio en Get Users con By ID. |
| Limit | Solo en Get Users con All. Cuántos usuarios traer como máximo. Por defecto, 10. |
Operaciones
| Operación | Qué hace |
|---|---|
Create Contact | Crea un contacto nuevo con su correo y los datos que rellenes. |
Update Contact | Cambia los datos de un contacto existente. Solo se modifican los campos que rellenes; al menos uno tiene que tener valor. |
Get Contact | Trae la ficha de un contacto, buscándolo por su identificador o por su correo. |
Delete Contact | Elimina un contacto. |
Add Tag | Pone una etiqueta a un contacto. |
Remove Tag | Quita una etiqueta a un contacto. Si el contacto no la tenía, el componente da un error. |
Add to List | Suscribe un contacto a una lista. |
Remove from List | Da de baja un contacto de una lista. Si no estaba suscrito, el componente da un error. |
Get Users | Trae un usuario de tu cuenta de ActiveCampaign o la lista de usuarios. |
Opciones avanzadas
| Campo | Qué hace |
|---|---|
| Custom Fields | Valores para los campos personalizados del contacto, como pares de identificador del campo y valor. Se aplica al crear el contacto con Create Contact. |
Resultado
La salida Contact Data devuelve el contacto con el que has trabajado: su identificador, correo, nombre y el resto de datos que guarda ActiveCampaign. En Delete Contact, Add Tag, Remove Tag, Add to List y Remove from List devuelve una confirmación con los identificadores usados. En Get Users sale un elemento por cada usuario encontrado.
Puedes conectar el resultado a otro componente de ActiveCampaign, por ejemplo para crear un trato con el identificador del contacto, o a un agente para que lo use en su respuesta. El componente también se puede conectar a un Agente como herramienta, para que el agente decida cuándo crear o buscar contactos. Ver Tool Mode.
Ejemplo
Una academia quiere que cada persona que pide información en su web reciba su boletín.
- El formulario de la web llega al flujo con el nombre y el correo de la persona.
- Añade ActiveCampaign Contacts con la operación
Create Contacty rellena Email, First Name y Phone con los datos del formulario. - Añade un segundo ActiveCampaign Contacts con la operación
Add to List. En Contact ID pon el identificador que devuelve el primero y en List ID el de la lista del boletín.
Buenas prácticas
- Para casi todas las operaciones necesitas el Contact ID. Si solo tienes el correo, usa antes
Get Contactcon Search By enEmail. - Los identificadores de etiquetas y listas los obtienes con ActiveCampaign Tags y ActiveCampaign Lists.
Componentes relacionados
- ActiveCampaign Tags: crea y consulta las etiquetas.
- ActiveCampaign Lists: crea y consulta las listas.
- ActiveCampaign Deals: crea tratos asociados a un contacto.
- ActiveCampaign Accounts: asocia contactos a empresas.