Saltar a la navegación
IntegracionesGuías de configuraciónServicio de campo

JobNimbus

Añade a quienes llaman por primera vez a JobNimbus como leads con una herramienta de webhook.

Con la herramienta de webhook 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.

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.

CampoValor
Nombrecreate_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étodoPOST
URLhttps://app.jobnimbus.com/api1/contacts
Cabeceras de solicitudAuthorization: Bearer YOUR_API_KEY
Parámetros del cuerpofirst_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 agentesRecepcionista

Sustituye Customer y Lead por los nombres de tu flujo de trabajo y estado.

Selecciona Enable y, después, prueba tu recepcionista como una persona nueva que llama porque necesita una inspección del tejado. El contacto aparecerá en JobNimbus con el estado de lead.

Añade un procedimiento 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.

Resolución de problemas

ProblemaQué comprobar
401 o 403 de JobNimbusEl 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 estadorecord_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 permisosEl Access Profile de la clave no puede crear contactos. Crea una nueva clave con un perfil que sí pueda.
Los contactos no tienen direcciónHaz que la descripción indique a la recepcionista que pida la dirección completa antes de añadir a quien llama.