Integraciones: hablá con otros sistemas
Cómo Nxar llama a APIs de afuera: creás una integración, la probás, usás su respuesta en una automation, le mandás datos y configurás cada tipo de autenticación.
- 6capítulos
- 62 minen total
- 8casos de uso
Distribuidora Del Sur vende al por mayor a almacenes y comercios. Paula administra el workspace de Nxar y Diego lleva los sistemas: el de gestión, el de logística y un par de servicios más, cada uno con su propia forma de pedir credenciales. En este recorrido vas a conectar Nxar con el mundo de afuera, sin escribir código:
- una integración que trae la cotización del dólar desde una API pública, probada desde la pantalla de configuración;
- una automation que guarda esa cotización en cada oportunidad nueva;
- otra integración que manda datos: cada cuenta nueva viaja al sistema de gestión;
- permisos para que la integración la pueda usar quien corresponde, y nadie más;
- y cómo enterarte cuando una llamada falla, con el registro de llamadas y los logs de la automation.
Al final, en los casos de uso, hay una receta por cada tipo de autenticación que soporta Nxar: bearer token, basic auth, API key en un header o en la URL, varios headers, OAuth2 client credentials y OAuth2 JWT bearer.
Todo el recorrido usa entidades que existen en cualquier workspace (Account y Opportunity) y APIs públicas de prueba que no piden cuenta, así que lo podés seguir en tu propio workspace tal cual.
Necesitás ser administrador del workspace. Las integraciones y las automations están en todos los planes; el capítulo de permisos usa permission sets, que piden plan Starter o superior. Un workspace nuevo arranca con 14 días de prueba.
Este recorrido es sobre llamadas que salen de Nxar. Para lo contrario, que otro sistema le mande datos a Nxar (webhooks, endpoints, la Public API), está el recorrido de recibir datos.
Paso a paso, en orden.
Cada capítulo deja algo funcionando y termina con cómo comprobarlo.
- 1
Qué es una integración
Una dirección de otro sistema, con sus credenciales, guardada una sola vez y llamada por nombre. En qué se diferencia de un conector del Marketplace y de la Public API.
- 2
Tu primera integración
Das de alta una integración contra una API pública de cotizaciones, la probás desde Configuración y guardás su respuesta como ejemplo.
- 3
Usar la respuesta en una automation
Cada oportunidad nueva guarda sola la cotización del día: una automation llama a la integración y copia un dato de la respuesta a un campo.
- 4
Mandar datos a otro sistema
Una integración POST que recibe datos del registro: cada cuenta nueva viaja al sistema de gestión, armada con campos de Nxar.
- 5
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.
- 6
Errores y registro de llamadas
Qué pasa cuando la otra API falla, cómo te enterás y cómo hacer que la automation siga por otro camino en vez de cortarse.
Lo mismo, aplicado a otros problemas.
Traer la cotización del dólar a una oportunidad
Cada oportunidad nueva guarda el dólar oficial del día, sacado de una API pública, sin que nadie lo cargue a mano.
Autenticación con bearer token
La API te dio un token o una clave de acceso y pide mandarlo como Authorization: Bearer. Cómo cargarlo y cómo probarlo.
Autenticación con usuario y contraseña (basic)
Sistemas más viejos o internos que piden usuario y contraseña en cada llamada. Cómo cargarlos y comprobar que el servicio los acepta.
API key en un header
El servicio te da una clave y pide mandarla en un header con un nombre propio, como X-Api-Key. Cómo configurarla y ver qué header sale.
API key en la URL
Servicios que piden la clave como parámetro de la dirección (?api_key=…). Cómo cargarla sin dejarla escrita en la URL de la integración.
Una API que pide varios headers
Además de la clave, el servicio pide headers fijos como el código de cliente o la versión. Cómo combinar headers por default con la autenticación, y para qué sirve el tipo Headers personalizados.
OAuth2 client credentials
APIs que no dan un token fijo sino un Client ID y un Client secret para pedir tokens que vencen. Qué completar, qué hace Nxar por detrás y cómo saber que funcionó.
OAuth2 JWT bearer
APIs que autentican con una clave privada RSA en nombre de un usuario, como la firma electrónica de DocuSign. Qué es cada campo y cómo leer los errores.