Con la integración de Agillic, cada persona que se registra se crea o se actualiza como destinatario en Agillic. Aquí Agillic no usa listas: los destinatarios se agregan a tus datos de Agillic y tú armas tus grupos objetivo en Agillic.
Lo que necesitas
- Una cuenta de Agillic en la plataforma europea de Agillic y un usuario que pueda crear claves de API (normalmente un administrador).
Paso 1: Crea una clave de API en Agillic
- En Agillic, abre Settings y busca las claves de API (API credentials).
- Crea una clave nueva y ponle un nombre que reconozcas, por ejemplo, “Scratcher”.
- Copia la Developer key (también llamada clave de API) y el Secret. El secreto se muestra una sola vez.
Permisos que necesita la clave
Scratcher usa la clave para leer tus campos de datos de personas, buscar destinatarios por correo electrónico y crear y actualizar destinatarios. Si Agillic te permite limitar la clave, esta necesita acceso de lectura y escritura a los destinatarios y acceso de lectura a los datos de personas. No se requiere ningún otro acceso.
Paso 2: Conecta Agillic con Scratcher
- En Scratcher, ve a Configuración > Integraciones y haz clic en Agillic.
- Pega la Developer key y el Secret.
- Haz clic en Instalar integración. Scratcher inicia sesión en Agillic para verificarlos.
Paso 3: Actívala en una campaña
- En el editor, ve a Conectar > Integraciones > Agillic y haz clic en Activar.
- Si conectaste más de una cuenta, elígela en Seleccionar cuenta.
- En Asignación de campos, vincula cada campo de Scratcher con un campo de datos de personas de Agillic.
- En Campo de correo electrónico único, elige el campo de Agillic que usas para el correo electrónico: “Elige el campo de Agillic que usas para el correo electrónico (asegúrate de que también sea único en Agillic)”. Solo se muestran los campos de texto únicos. Si lo dejas vacío, Scratcher usa el campo EMAIL.
- En Filtrar por permisos (opcional), elige tu casilla de consentimiento de marketing para que solo se envíen las personas que aceptaron.
- Haz clic en Guardar y luego en Probar.
Para tener en cuenta: Agillic no tiene una lista para elegir, así que Scratcher empieza a enviar en cuanto haces clic en Activar. Actívala antes de que la campaña se publique o configúrala de inmediato.
Asignación de campos
- La dirección de correo electrónico siempre se envía al campo de correo electrónico único. No necesitas asignarla.
- La lista de campos muestra tus datos de personas de Agillic, con sus tipos. Las fechas se envían en el formato de Agillic, por ejemplo, 31.12.2025.
- Si tienes un campo de datos de personas para el opt-in, asígnale el campo Aceptado de un consentimiento.
Qué se envía y cuándo
Scratcher busca al destinatario por correo electrónico. Si no existe, se crea; de lo contrario, se actualiza. Los nuevos registros se envían en uno o dos minutos, y los leads existentes se envían cuando la activas. En Configuración > Integraciones > Estado de entrega puedes ver si cada lead era nuevo o ya existía en Agillic.
Solución de problemas
- “Agillic API request failed with status code ...”: Agillic no aceptó la solicitud. Un 401 o 403 significa que la clave se eliminó o no tiene acceso; conecta una clave nueva.
- Un mensaje de Agillic sobre un campo: un valor no coincide con el tipo de campo o falta un campo obligatorio. Revisa las asignaciones.