> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt. # FieldPulse Con las [herramientas de webhook](/docs/es/reception-ai/integrations/webhooks) 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](mailto: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`. > **Warning** > > 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](/docs/es/reception-ai/receptionist/testing) 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. > **Tip** > > Añade un [procedimiento](/docs/es/reception-ai/receptionist/rules-and-procedures) 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. |