1. Obtener la clave API en Housecall Pro
Antes de configurar cualquier flujo, necesitas generar la credencial de acceso.
Paso 1: Generar la API Key
Inicia sesión en tu cuenta de Housecall Pro.
Haz clic en el ícono de My Apps en la esquina superior derecha y selecciona Go to App Store.
Abre la aplicación API Key Management y haz clic en Generate API Key.
Dale un nombre (por ejemplo, "Integración de Workflows") y establece los permisos en Full Access (Acceso total).
Copia el valor de la clave API generada.
(Nota: Esta opción está disponible para los planes pagos de Housecall Pro que soportan acceso API).
2. Conectar la cuenta en la plataforma
Ahora vas a pegar esa clave para autorizar la conexión.
Paso 1: Conectar vía Workflow Builder (Recomendado)
Abre la sección de Automatización y selecciona o crea un flujo de trabajo.
Añade un disparador o acción y busca "Housecall Pro" en la pestaña de Aplicaciones (Apps).
Selecciona la opción deseada (ej. Trabajo programado).
En el panel lateral, haz clic en Connect your account (Conectar tu cuenta).
Pega tu clave API de Housecall Pro en la ventana emergente y haz clic en Guardar. El panel se actualizará para mostrar que estás "Conectado".
3. Configurar un Disparador (Ejemplo: Trabajo Programado)
Una vez conectada la cuenta, vas a configurar qué evento iniciará tu automatización.
Paso 1: Añadir y configurar el disparador
Dentro del flujo, haz clic en Añadir Disparador (Add Trigger).
Busca Housecall Pro y selecciona Job scheduled (Trabajo programado).
Selecciona la cuenta conectada y dale un nombre descriptivo al disparador (ej. "Nueva reserva de trabajo").
(Opcional) Añade filtros si solo quieres que se dispare bajo ciertas condiciones (por tipo de trabajo, etiqueta o empleado asignado).
Paso 2: Probar el disparador
Haz clic en Find new records (Buscar nuevos registros) dentro del panel de prueba.
El sistema buscará los trabajos programados más recientes. Selecciona uno en el menú desplegable para usarlo como referencia.
Confirma que los datos del trabajo y del cliente aparecen correctamente y haz clic en Guardar disparador.
4. Configurar una Acción (Ejemplo: Crear nuevo cliente)
Ahora vas a configurar qué respuesta o comando se enviará hacia Housecall Pro.
Paso 1: Añadir y configurar la acción
Dentro del flujo, haz clic en Añadir para insertar un nuevo paso.
Busca Housecall Pro y selecciona Create new customer (Crear nuevo cliente).
Selecciona la cuenta conectada y dale un nombre a la acción.
Paso 2: Mapear los campos de información
Nombre y Apellido (Obligatorio): Asigna las variables de tu flujo (ej.
{{contact.first_name}}).Correo y Empresa (Opcional): Asigna los datos correspondientes.
Número Móvil (Opcional): Debe tener exactamente 10 dígitos y solo números (ej. 5125551234). Si el formato es incorrecto, la plataforma rechazará la acción.
Paso 3: Probar la acción
Haz clic en Test Action (Probar acción). Ten en cuenta que esto creará un cliente real en tu cuenta de Housecall Pro, por lo que puedes usar un nombre de prueba como "TEST - BORRAR".
Verifica en Housecall Pro que el cliente se haya creado y guarda la acción en tu flujo.
Conclusión
Conectar Housecall Pro a tus automatizaciones es un proceso estructurado:
Generas una clave API (Full Access) desde el App Store de Housecall Pro.
Pegas esa clave dentro del constructor de flujos para establecer la conexión.
Añades un Disparador (para reaccionar a lo que pasa en Housecall Pro) o una Acción (para enviar datos desde la web o CRM hacia Housecall Pro).
Siempre mapeas correctamente los campos (especialmente los números de 10 dígitos) y realizas pruebas antes de publicar.