Your AI Connector Docs

FluentCRM

¿Para quién es esto? Empresas que mantienen su lista de correo en FluentCRM dentro de su propio sitio de WordPress y desean que las conversaciones la alimenten. Si no utiliza FluentCRM, puede omitir esta página.

¿Utiliza una herramienta de CRM o correo electrónico diferente? Cualquier herramienta con una API puede conectarse: consulte Conectar una herramienta que no listamos.

FluentCRM es un plugin de CRM y marketing por correo electrónico que reside dentro de WordPress: contactos, etiquetas, listas y las campañas que les envía. Conectarlo a Your AI Connector le da a sus automatizaciones pasos que escriben en él, de modo que un nuevo cliente potencial de WhatsApp se convierte en un contacto de FluentCRM con la etiqueta correcta, y la secuencia de correo electrónico que ya creó toma el control desde allí. Sin exportaciones, sin copiar y pegar, sin esperar hasta el viernes.

No se instala nada en su sitio de WordPress. Usted conecta su propio sitio con sus propios datos de inicio de sesión, y nosotros llamamos a la API que FluentCRM ya expone.

Disponibilidad: Las automatizaciones están disponibles en todas las cuentas. Ya están en su barra lateral y no hay nada que habilitar o solicitar.

Lo que necesitas

FluentCRM funciona sobre la API REST de WordPress, por lo que requiere exactamente los mismos detalles que la conexión de WordPress:

  • El sitio de WordPress en el que se ejecuta FluentCRM, accesible a través de https, en WordPress 5.6 o superior.
  • Enlaces permanentes bonitos activados (Ajustes → Enlaces permanentes, cualquier opción que no sea “Simple”), que es lo que hace que la dirección /wp-json/ funcione.
  • Una contraseña de aplicación para el usuario de WordPress con el que debe actuar la automatización: Usuarios → Perfil → Contraseñas de aplicación → Añadir nueva. WordPress la muestra una vez, en bloques separados por espacios. Cópiela con los espacios.

Ese usuario debe tener permiso para gestionar FluentCRM en WordPress. Su contraseña de inicio de sesión real nunca se utiliza, y eliminar la contraseña de aplicación más tarde revoca exactamente esta conexión.

Conectar FluentCRM

Se conecta desde dentro de una automatización, la primera vez que utiliza un paso de FluentCRM.

  1. Abra Automatizaciones en la barra lateral (bajo el grupo AI Studio) y abra o cree una automatización.
  2. Añada un paso y busque FluentCRM en el selector de pasos.
  3. Elija la acción que desee. El paso le pedirá que se conecte primero.
  4. Rellene los tres campos:
    • URL del sitio es la dirección del sitio de WordPress en el que se ejecuta FluentCRM, comenzando con https://.
    • Nombre de usuario de WordPress es el nombre de usuario con el que inicia sesión, no su correo electrónico.
    • Contraseña de aplicación es la contraseña que creó anteriormente, pegada con sus espacios.
  5. Haga clic en conectar.

Comprobamos los detalles con su sitio antes de guardar nada, leyendo un contacto de FluentCRM. Los detalles incorrectos, o un sitio donde /wp-json/ no se resuelve, son rechazados en pantalla con el motivo. Su contraseña de aplicación se almacena cifrada y nunca se le vuelve a mostrar.

Las etiquetas y listas se proporcionan como ID

Esto es lo único que debe saber antes de crear nada. Todos los campos que aceptan etiquetas o listas requieren sus números de ID, separados por comas, no sus nombres. 1, 2 funciona; Newsletter, VIP no, y el editor lo marcará bajo el campo. Un ID que resulta ser incorrecto solo cuando se ejecuta la automatización (por ejemplo, uno que provino de un paso anterior) detiene el paso con un error, en lugar de ejecutarse silenciosamente sin esa etiqueta.

Encontrará los números en FluentCRM: abra Etiquetas o Listas en el menú de FluentCRM, y el ID de cada fila aparece en la barra de direcciones cuando la abre. Anote los pocos que planea usar una vez y listo.

Las acciones

Cada acción es un paso en el lienzo de automatización, y cada campo acepta datos de pasos anteriores con los botones habituales de inserción de datos.

Crear o actualizar contacto

Añade un contacto o actualiza el que ya tiene este correo electrónico. Enviar el mismo correo dos veces los actualiza en lugar de fallar, por lo que puede ejecutar esto en cada nuevo cliente potencial sin necesidad de comprobarlo primero.

  • Email es la dirección de correo electrónico del contacto. Obligatorio. Por lo general, es el correo electrónico del contacto proveniente del disparador.
  • Nombre, Apellido y Teléfono son opcionales.
  • Estado se selecciona de una lista: Subscribed (Suscrito), Pending (Pendiente), Unsubscribed (No suscrito) o Transactional (Transaccional). Obligatorio, porque FluentCRM necesita uno, y también se aplica a los contactos existentes: Subscribed vuelve a suscribir a alguien que se había dado de baja, así que elíjalo solo cuando la persona haya solicitado unirse. Pending envía el correo electrónico de doble opt-in de FluentCRM.
  • Tag IDs son las etiquetas que se les asignarán, separadas por comas. Opcional.
  • List IDs son las listas a las que se les añadirá, separadas por comas. Opcional.

Buscar contacto por correo electrónico

Busca un contacto por dirección de correo electrónico y devuelve su id, sus etiquetas y sus listas.

  • Email es la dirección que se debe buscar. Obligatorio.

Su salida es lo que necesitan los pasos siguientes, ya que funcionan con un id de contacto.

Añadir etiquetas al contacto

Adjunta una o más etiquetas a un contacto que ya existe.

  • Contact ID es qué contacto. Obligatorio. Normalmente se obtiene de un paso Find contact by email (Buscar contacto por correo electrónico) anterior en la automatización.
  • Email es el correo electrónico del contacto. Obligatorio, porque FluentCRM solicita el correo electrónico en cada actualización.
  • Tag IDs son las etiquetas que se adjuntarán, separadas por comas. Obligatorio.
  • Change status es opcional. Si se deja en Keep current status (Mantener estado actual), el estado del contacto no se modifica, por lo que etiquetar a alguien que se dio de baja no lo vuelve a suscribir.

Eliminar etiquetas del contacto

Los mismos campos, eliminando etiquetas en lugar de añadirlas.

Añadir contacto a listas

  • Contact ID, Email y List IDs (separados por comas), con la misma opción de Change status.

Un ejemplo de automatización

Cada nuevo cliente potencial de WhatsApp llega a FluentCRM, etiquetado según su procedencia.

  1. Activador: mensaje entrante de un nuevo contacto.
  2. Crear o actualizar contacto, con el correo electrónico, nombre y teléfono del contacto provenientes del activador, y el ID de lista de su lista principal.
  3. Añadir etiquetas al contacto no es necesario aquí, porque el paso 2 ya puede incluir los IDs de etiqueta. Úselo cuando la etiqueta se añada más adelante en la conversación.

Y la versión donde la etiqueta se añade más tarde, que es la más útil:

  1. Activador: se añade una etiqueta al contacto, por ejemplo asked about pricing, por parte de su agente de IA.
  2. Buscar contacto por correo electrónico, con el correo electrónico del contacto.
  3. Añadir etiquetas al contacto, usando el ID del paso 2, el mismo correo electrónico y el ID de etiqueta de FluentCRM para su secuencia de precios.

La propia automatización de FluentCRM envía entonces la secuencia de correos electrónicos que inicia esa etiqueta. La conversación ocurre en WhatsApp, el proceso de nutrición ocurre por correo electrónico y nadie mueve una fila manualmente entre ellos.

Información útil

  • Los pasos que requieren un ID de contacto van después de un paso de búsqueda (Find). Esa es la estructura normal: buscar el contacto y luego actuar sobre el ID que devolvió el paso de búsqueda.
  • Las salidas viajan hacia adelante. Todo lo que devuelve una acción está disponible para los pasos posteriores como variables.
  • IDs, no nombres, para cada campo de etiqueta y lista. Un nombre en ese campo se marca en el editor y detiene el paso cuando se ejecuta.
  • Algunos proveedores de alojamiento eliminan el encabezado Authorization antes de que WordPress lo vea, lo que hace que una contraseña de aplicación correcta parezca incorrecta. Si sus datos son definitivamente correctos y la conexión sigue siendo rechazada, eso es lo que debe consultar con su proveedor de alojamiento.
  • No existe un disparador que supervise FluentCRM. Nada lo consulta para detectar cambios. Para que FluentCRM inicie una automatización, añada un disparador de Webhook a la automatización y apunte un webhook saliente de FluentCRM a la dirección que le proporciona.
  • Cualquier cosa que no esté en la lista anterior todavía se puede realizar con el paso HTTP request.

Próximos pasos