Conectar Cuevr con otras herramientas

Entender el alcance

Cuevr se conecta a sus herramientas mediante una API v1 y webhooks, que pueden utilizarse en particular desde Make, n8n o Zapier. En un sentido, Cuevr avisa a su herramienta en cada momento clave de una propuesta; en el otro, su herramienta actúa sobre Cuevr con una clave de acceso: crear un cliente o una propuesta a partir de un trato, cerrar o reabrir el trato, leer la cualificación.

Las funciones de gestión se encuentran en Administración, pestaña Organización, tarjeta Integraciones, con un rol de propietario o administrador. Un miembro ve la tarjeta, pero no puede crear una clave ni añadir un destino.

Crear y gestionar una clave de acceso

1. En Claves de acceso, haga clic en Crear una clave de acceso y dele un nombre explícito.
2. En Lo que puede hacer la clave, elija los permisos necesarios para su flujo. Todo lo que necesitan Make o n8n marca todos los permisos, Nada los desmarca.
3. Haga clic en Crear la clave y después cópiela cuando se muestre: solo se mostrará una vez.
4. Pruebe la conexión con la ruta de verificación de la clave.
5. Para sustituir una clave, utilice Renovar la clave en el menú «…» de su línea: Cuevr crea una nueva clave con los mismos permisos, y la antigua sigue funcionando durante el plazo indicado en la ventana de confirmación, el tiempo de sustituirla en su escenario.
6. Revoque la clave con Revocar la clave cuando ya no se utilice o si se ha filtrado: deja de funcionar de inmediato.

La clave empieza por cuevr_. Para recibir una familia de eventos, la clave que suscribe un destino también debe tener el permiso de lectura de esa familia. Cuando un miembro deja la organización, o deja de ser administrador, las claves que ha creado se revocan.

Añadir y gestionar un destino webhook

1. Haga clic en Añadir un destino, pegue la Dirección proporcionada por su escenario y, si lo desea, una etiqueta.
2. En Lo que envía Cuevr, seleccione los eventos útiles.
3. Marque Incluir los datos del lector solo si su herramienta debe recibir el correo electrónico y el nombre del cliente potencial.
4. Haga clic en Añadir el destino y después copie el secreto de firma: solo se mostrará una vez.
5. Lance Enviar una prueba desde el menú «…» del destino; el evento técnico es cuevr.ping.
6. Siga el Registro de envíos. En caso de error, corrija el receptor, vuelva a probar y después utilice Reactivar si el destino se ha desactivado.

La organización puede tener hasta 10 destinos. El plazo de respuesta es de 10 segundos. Solo un estado HTTP 2xx significa entregado. Las URL deben estar en HTTPS. En caso de fallo, Cuevr reintenta varias veces a intervalos crecientes y después desactiva el destino tras errores repetidos; la causa se muestra bajo su nombre. Los eventos ocurridos mientras un destino está desactivado no se recuperan al reactivarlo. Una prueba fallida no cuenta contra el destino. El registro de envíos se conserva 30 días.

El menú «…» también ofrece Modificar, Desactivar y Eliminar. Cuando un miembro deja la organización, los destinos que ha creado se desactivan; puede reactivarlos.

Verificar la firma de los envíos

Cuevr firma cada envío en la cabecera X-Cuevr-Signature: una firma HMAC-SHA256 del timestamp (cabecera X-Cuevr-Timestamp) y del cuerpo, calculada con el secreto del destino. Haga que su herramienta receptora verifique esta firma antes de procesar un envío.

Renovar el secreto, en el menú «…» del destino, crea un nuevo secreto. Durante el plazo indicado, cada envío se firma con ambos: el nuevo en X-Cuevr-Signature, el antiguo en X-Cuevr-Signature-Previous. Pegue el nuevo secreto en su escenario antes del final de ese plazo.

Los veintiún eventos disponibles

Quince eventos están marcados de oficio al crear un destino:

Seis eventos solo salen hacia los destinos que los marcan:

Una firma no registra, por sí sola, un resultado comercial. Por tanto, hay que tratar por separado los eventos de firma y los de cambio de resultado.

Lo que la API permite sincronizar

Las rutas cubren la verificación de la clave y el catálogo de eventos, la consulta y la gestión de los clientes, la consulta y la creación de propuestas a partir de un trato, el cierre y la reapertura del trato, la lectura de la cualificación, así como la gestión, las pruebas y los registros de los webhooks. La publicación y la firma siguen siendo gestos que se hacen en Cuevr.

Al crear desde un CRM, las notas del trato se conservan tal cual al principio de la cualificación y se mantiene el idioma indicado. La pareja fuente externa + identificador externo permite repetir las creaciones sin crear un nuevo expediente en cada intento. El correo electrónico del propietario que llega desde el CRM debe corresponder a un miembro de la organización. Durante la prueba, una propuesta creada por la API cuenta entre las propuestas de prueba de ese miembro.

Con una suscripción inactiva, el acceso pasa a ser de solo lectura, con excepciones previstas para desactivar o eliminar un destino y revocar una clave. Los permisos de la clave y los del miembro siguen siendo determinantes.