> 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. # JobNimbus Con la [herramienta de webhook](/docs/es/reception-ai/integrations/webhooks) que encontrarás a continuación, tu recepcionista puede añadir a quien llama a JobNimbus como contacto en tu flujo de trabajo de leads, con su número de teléfono, dirección y lo que necesita, para que tu equipo pueda hacer seguimiento. ## Antes de empezar 1. En JobNimbus, selecciona el icono de tu perfil en la esquina superior derecha, después **Settings** → **API**, y crea una nueva clave de API. 2. Elige un **Access Profile** que pueda crear contactos y tenga solo los permisos que necesitas. La clave conserva los permisos que tenía el perfil al crearla. 3. Copia la clave de API completa, no el **Key ID**. JobNimbus solo la muestra una vez. La herramienta envía la clave en la cabecera de solicitud `Authorization` como `Bearer YOUR_API_KEY`. > **Warning** > > La clave de API permite acceder a tus datos de JobNimbus. Guárdala de forma segura y no la compartas. Las claves nuevas > caducan al cabo de un año, así que crea una sustituta antes de que ocurra. También necesitas los nombres exactos del flujo de trabajo de contactos y del estado en el que deben entrar los nuevos leads, tal como aparecen en la configuración de JobNimbus, por ejemplo `Customer` y `Lead`. ## Crea la herramienta Ve a **Integrations**, selecciona **Add integration**, elige **Webhook Tool** y completa los campos siguientes. | Campo | Valor | | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Nombre** | `create_jobnimbus_contact` | | **Descripción** | "Añade a quien llama a nuestro CRM como nuevo lead cuando necesita realizar un trabajo y no nos ha utilizado antes." | | **Método** | POST | | **URL** | `https://app.jobnimbus.com/api1/contacts` | | **Cabeceras de solicitud** | `Authorization`: `Bearer YOUR_API_KEY` | | **Parámetros del cuerpo** | `first_name` (cadena, obligatorio): "El nombre de quien llama." `last_name` (cadena, obligatorio): "El apellido de quien llama." `record_type_name` (cadena, obligatorio): "Siempre el valor exacto `Customer`." `status_name` (cadena, obligatorio): "Siempre el valor exacto `Lead`." `mobile_phone` (cadena, obligatorio): "El número de teléfono de quien llama, solo dígitos." `email` (cadena): "La dirección de correo electrónico de quien llama, si la ha facilitado." `address_line1` (cadena): "La dirección donde se necesita el trabajo." `city` (cadena): "La ciudad de esa dirección." `state_text` (cadena): "La provincia, como código de dos letras." `zip` (cadena): "El código postal." `description` (cadena, obligatorio): "Qué necesita quien llama, cuándo está disponible y cualquier otra cosa que te haya dicho." | | **Asignar a agentes** | **Recepcionista** | Sustituye `Customer` y `Lead` por los nombres de tu flujo de trabajo y estado. Selecciona **Enable** y, después, [prueba tu recepcionista](/docs/es/reception-ai/receptionist/testing) como una persona nueva que llama porque necesita una inspección del tejado. El contacto aparecerá en JobNimbus con el estado de lead. > **Tip** > > Añade un [procedimiento](/docs/es/reception-ai/receptionist/rules-and-procedures) que indique a tu recepcionista > que recopile la dirección completa antes de añadir a quien llama. ## Limitaciones * Para buscar contactos de JobNimbus se necesita un filtro de búsqueda JSON, por lo que esta herramienta no puede buscar a quien llama. Una persona que ya haya llamado puede añadirse dos veces. * Los trabajos, tareas y notas se vinculan a un contacto mediante campos anidados, que las herramientas de webhook no pueden enviar. La descripción del contacto contiene los detalles de la llamada en su lugar. Para buscar a quien llama por correo electrónico y crear trabajos vinculados a su contacto, usa las acciones **Find Contact by Email**, **Create Contact** y **Create Job** de JobNimbus mediante [Zapier](/docs/es/reception-ai/integrations/zapier). ## Resolución de problemas | Problema | Qué comprobar | | ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | | 401 o 403 de JobNimbus | El valor de la cabecera debe ser `Bearer` seguido de la clave de API completa, no el **Key ID**. Comprueba que la clave no haya caducado. | | Error sobre el flujo de trabajo o el estado | `record_type_name` y `status_name` deben coincidir exactamente con un flujo de trabajo de contactos y uno de sus estados. | | 403 con un mensaje de permisos | El **Access Profile** de la clave no puede crear contactos. Crea una nueva clave con un perfil que sí pueda. | | Los contactos no tienen dirección | Haz que la descripción indique a la recepcionista que pida la dirección completa antes de añadir a quien llama. |