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

Caso de uso · Integraciones: hablá con otros sistemas · 12 min

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.

El problema. Cotizás en dólares y cada vendedor anota el tipo de cambio de una fuente distinta, o se olvida. Querés que cada oportunidad nazca con el dólar oficial del día.

La idea. Una integración contra DolarApi (pública, sin clave), y una automation que corre al crear una oportunidad: llama a la integración y copia el valor de venta a un campo numérico. Si hiciste el recorrido, ya tenés todo esto; acá está en una sola página.

Probalo en un workspace de práctica

Un workspace con el escenario ya armado, que se borra solo a las 48 h. Estamos terminándolo.

La integración

ConfiguraciónIntegraciones y APIIntegrations

Nueva Integration: Etiqueta Cotización del dólar, Nombre cotizacion_dolar (corregilo a mano: el automático pierde las tildes), Método GET, URL https://dolarapi.com/v1/dolares. Crear.

En Test, Path (opcional) /oficial → Ejecutar Test. Tiene que dar 200 con compra y venta. Después, Guardar como sample response.

Bloque Test con resultado 200 y la cotización del dólar oficial
La API responde un objeto con compra y venta.

El campo

ConfiguraciónConstructor de appEntidadesOpportunityCampos

Nuevo campo: Label Dólar oficial, Tipo Number, API Name dolar_oficial, Decimales 2. Crear campo. Sumalo a la página en Record Pages → Default → Record Details → + Add field…

La automation

ConfiguraciónAutomatizaciónProcesos

Nuevo → Evento de registro, Label Cotización en oportunidades nuevas, Entidad Opportunity, Operación Crear, Momento Después → Nueva automation.

  1. Llamar Integración: Integration Cotización del dólar, Path /oficial, Output dolar, y Usar sample de la integración.
  2. Actualizar registro, unido al anterior: Registro del trigger, Campo dolar_oficial, Valor {{dolar.body.venta}}.

Guardar.

Nodo Actualizar registro con dolar_oficial igual a dolar.body.venta
La referencia va siempre con body: dolar.body.venta.

Si los vendedores no tienen acceso total, la automation corre con sus permisos y necesitan Execute sobre Cotización del dólar en algún permission set (categoría Integrations). Sin eso, la oportunidad se guarda pero queda sin cotización.

¿Preferís el dólar blue? Cambiá el Path del nodo a /blue. ¿Querés las dos? Dos nodos Llamar Integración con Outputs distintos (oficial y blue) contra la misma integración.

Cómo saber que te salió

Creá una oportunidad, recargá su página y fijate que Dólar oficial tenga el mismo número que venta en el Test. Los Logs de ejecución de la automation muestran la corrida en success.

¿Te funcionó?