nxar.Aprender
Integraciones: hablá con otros sistemas0 de 6 capítulos
  1. 1Qué es una integración
  2. 2Tu primera integración
  3. 3Usar la respuesta en una automation
  4. 4Mandar datos a otro sistema
  5. 5Quién puede usarla
  6. 6Errores y registro de llamadas

Casos de uso

  1. ·Traer la cotización del dólar a una oportunidad
  2. ·Autenticación con bearer token
  3. ·Autenticación con usuario y contraseña (basic)
  4. ·API key en un header
  5. ·API key en la URL
  6. ·Una API que pide varios headers
  7. ·OAuth2 client credentials
  8. ·OAuth2 JWT bearer

← Volver al recorrido

Capítulo 5 de 6 · 10 min

Quién puede usarla

Configurar una integración y ejecutarla son permisos distintos. Le das a los vendedores permiso para ejecutar la del dólar, y entendés en nombre de quién corre la automation.

Cambia quién está llamando a la integración. Nxar separa dos permisos:

PermisoQué deja hacerDónde se da
Manage IntegrationsVer, crear, editar y probar integraciones en ConfiguraciónPermission set → Access & Administration
Execute, por integraciónQue una automation o un componente la llame en nombre de esa personaPermission set → Integrations

El primero es para quien administra. El segundo es por integración: podés dejar que ventas use la del dólar y no la del sistema de gestión.

En nombre de quién corre la automation

Cada automation tiene un Correr como. Lo encontrás en el builder, en el botón de Configuración de la barra superior (el ícono de ajustes). Por defecto es Usuario que dispara: la automation corre en nombre de quien creó la oportunidad, y la integración se ejecuta con sus permisos.

Diálogo de configuración de la automation con el selector Correr como en Usuario que dispara
Correr como decide con qué permisos se llama a la integración.

Paula tiene acceso total (el permission set System Admin), y con eso puede ejecutar cualquier integración. Martín tiene Standard User, que no incluye ninguna. Por eso a él la llamada se le rechaza: la oportunidad se guarda igual, pero la automation se corta antes de copiar la cotización.

Si abrís los Logs de ejecución de la automation vas a ver esa corrida en failed, con un error que empieza con Permission denied: cannot execute integration "cotizacion_dolar".

Creá un permission set para usar la integración

ConfiguraciónAcceso y seguridadPermission Sets

Los permission sets del sistema, como Standard User, no se pueden editar. Por eso creamos uno chico, que se suma a lo que cada vendedor ya tiene. Nuevo, Label Integraciones de ventas (el Name se completa solo) y Create.

Dale permiso de ejecución

En la ficha del permission set, hacé clic en la categoría Integrations. Aparece la lista de integraciones del workspace con una columna Execute. Marcá Execute en Cotización del dólar y dejá sin marcar Alta de clientes en gestión. Save.

Categoría Integrations de un permission set con la columna Execute marcada para Cotización del dólar
Un permiso por integración: ventas usa la del dólar, no la del sistema de gestión.

Asignáselo a los vendedores

Volvé a la ficha del permission set. En Assigned users, Add Assignment, elegí a Martín (y al resto de ventas) y Assign.

La otra salida: cambiar el Correr como

A veces no querés repartir permisos, porque la integración es un detalle técnico que nadie tiene que “usar”. Para eso, en Correr como:

  • Un usuario en particular… corre siempre como el usuario que elijas, por ejemplo una cuenta de servicio que tenga el permiso Execute. Es la opción más prolija.
  • Sistema (sin chequeo de permisos) saltea todos los chequeos, también el de la integración. Funciona, pero la automation queda con acceso total al workspace y lo que crea queda sin dueño. Usala sólo si sabés por qué.

Un rechazo por permisos no se puede atajar: ni Continue flow if the call fails ni Fallback si esto falla (los vemos en el próximo capítulo) lo convierten en otra cosa. Es a propósito: si falta un permiso, la configuración está mal y tiene que verse.

Manage Integrations no da Execute. Alguien de sistemas puede tener el primero para mantener las integraciones y, aun así, sus propias oportunidades fallarían si no tiene también el segundo.

Cómo saber que te salió

Entrá como Martín (Configuración → Acceso y seguridad → Usuarios → (Martín) → Ingresar como este usuario) y creá una oportunidad. Recargá su página: Dólar oficial tiene la cotización. En los Logs de ejecución de la automation, esa corrida figura en success.

¿Llegaste al resultado de arriba?