FieldPulse | ElevenLabs Documentation

Con las herramientas de webhook de abajo, tu recepcionista puede reconocer a quienes llaman y ya están en FieldPulse, añadir a quienes llaman por primera vez como clientes potenciales y dejar un comentario en la ficha del cliente con lo que necesitan para que tu equipo pueda hacer seguimiento.

Antes de empezar

FieldPulse emite claves API previa solicitud. Ponte en contacto con el soporte de FieldPulse en support@fieldpulse.com o a través del chat de la aplicación y solicita una clave API. Cada herramienta de abajo la envía en el encabezado de solicitud x-api-key.

La clave API puede leer y modificar tus datos de FieldPulse. Guárdala de forma segura y no la compartas.

Crea las herramientas

Para cada herramienta, ve a Integraciones, selecciona Añadir integración, elige Herramienta de webhook y establece Asignar a agentes en Recepcionista.

Buscar a quien llama

Campo	Valor
Nombre	`find_fieldpulse_customer`
Descripción	”Busca a quien llama en nuestra lista de clientes por nombre o número de teléfono. Úsala al inicio de una llamada sobre un trabajo.”
Método	GET
URL	`https://ywe3crmpll.execute-api.us-east-2.amazonaws.com/stage/customers`
Encabezados de solicitud	`x-api-key`: tu clave API
Parámetros de consulta	`search` (cadena, obligatorio): “El nombre completo o el número de teléfono de quien llama.”

Añadir un cliente nuevo

Campo	Valor
Nombre	`create_fieldpulse_customer`
Descripción	”Añade a quien llama como cliente nuevo cuando `find_fieldpulse_customer` no lo haya encontrado.”
Método	POST
URL	`https://ywe3crmpll.execute-api.us-east-2.amazonaws.com/stage/customers`
Encabezados de solicitud	`x-api-key`: tu clave API
Parámetros del cuerpo	`first_name` (cadena, obligatorio): “El nombre de quien llama.” `last_name` (cadena, obligatorio): “El apellido de quien llama.” `phone` (cadena, obligatorio): “El número de teléfono de quien llama, incluido el prefijo.” `email` (cadena): “La dirección de correo electrónico de quien llama, si ha proporcionado una.” `status` (cadena, obligatorio): “Siempre el valor exacto `lead`.” `service_address_1` (cadena): “La dirección donde se necesita el trabajo.” `service_address_city` (cadena): “La ciudad de esa dirección.” `service_address_state` (cadena): “La provincia o estado.” `service_address_zip_code` (cadena): “El código postal.”

Registra los detalles de la llamada

Campo	Valor
Nombre	`add_fieldpulse_comment`
Descripción	”Deja un comentario en la ficha de cliente de quien llama con lo que necesita. Úsala cuando tengas su ID de cliente.”
Método	POST
URL	`https://ywe3crmpll.execute-api.us-east-2.amazonaws.com/stage/comments`
Encabezados de solicitud	`x-api-key`: tu clave API
Parámetros del cuerpo	`commentable_type` (cadena, obligatorio): “Siempre el valor exacto `customer`.” `commentable_id` (número, obligatorio): “El ID del cliente, de `find_fieldpulse_customer` o `create_fieldpulse_customer`.” `text` (cadena, obligatorio): “Lo que necesita quien llama, cuándo está disponible y cómo contactarle.”

Selecciona Activar en cada herramienta y después prueba tu recepcionista como una persona nueva que llama porque necesita una reparación. El cliente aparecerá en FieldPulse como cliente potencial, con el comentario de tu recepcionista.

Añade un procedimiento para nuevos trabajos: busca a quien llama, añádelo si no lo encuentras y registra después los detalles de la llamada.

Limitaciones

Los trabajos necesitan un tipo de trabajo, un estado y datos de facturación de tu cuenta de FieldPulse, por lo que tu recepcionista no los crea. Tu equipo convierte el cliente potencial en un trabajo.
Tu recepcionista no puede comprobar la disponibilidad de técnicos ni reservar una hora.
Las herramientas de webhook no pueden enviar listas, por lo que no pueden añadir etiquetas ni campos personalizados a un cliente.

Resolución de problemas

Problema	Qué comprobar
401 de FieldPulse	El encabezado debe llamarse `x-api-key` y contener una clave vigente.
400 de FieldPulse	Lee la lista de errores de la respuesta. `status` debe ser exactamente `lead` y los números de teléfono deben ser válidos.
No se encuentra a quienes ya han llamado	FieldPulse busca coincidencias con los datos almacenados. Prueba con el nombre de quien llama y también con su número de teléfono.
No se añade el comentario	`commentable_id` debe ser el ID de un cliente existente. Comprueba que la herramienta de búsqueda o creación se haya ejecutado primero.
429 de FieldPulse	Has alcanzado el límite de solicitudes de FieldPulse. Espera e inténtalo de nuevo.