Capítulo 3 de 6 · 14 min

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.

La integración ya sabe traer la cotización. Ahora hace falta alguien que la llame en el momento justo y haga algo con lo que vuelve. Ese alguien es una automation: cuando se crea una oportunidad, llama a la integración y copia el valor de venta a un campo de la oportunidad.

Para leer un dato de la respuesta usás una referencia entre llaves dobles. Si guardás la respuesta con el nombre dolar, el valor de venta está en {{dolar.body.venta}}: dolar es la respuesta entera, body es lo que contestó la API y venta es el campo que te interesa.

Un campo para guardar la cotización

ConfiguraciónConstructor de appEntidadesOpportunityCampos

Nuevo campo. En Datos: Label Dólar oficial, Tipo Number. El API Name que se genera pierde la tilde: corregilo a dolar_oficial. En Configuración, Decimales: 2. Pasá por Permisos sin marcar nada y hacé clic en Crear campo.

Mostralo en la página de la oportunidad

Un campo nuevo no se agrega solo a la página del registro. En la pestaña Record Pages de Opportunity, abrí la página Default, seleccioná el bloque Record Details y, con + Add field…, sumá Dólar oficial. Save.

Creá la automation

ConfiguraciónAutomatizaciónProcesos

Botón Nuevo. Completá:

Tipo: Evento de registro.
Label: Cotización en oportunidades nuevas. El API name se completa solo.
Entidad: Opportunity.
Operación: Crear. Momento: Después.

Hacé clic en Nueva automation. Se abre el builder, con el trigger en el canvas.

Sumá el nodo Llamar Integración

En el panel Agregar nodos, grupo Integraciones, arrastrá Llamar Integración al canvas. Como es el primer nodo, queda unido al trigger. Seleccionalo y, en la pestaña Configurar del inspector:

Integration: Cotización del dólar.
Método HTTP: dejá Predeterminado de la integration (GET).
Path (optional): /oficial.
Body (JSON, optional): vacío; un GET no lleva cuerpo.
Output: dolar. Es el nombre con el que vas a leer la respuesta más adelante.
En Sample de salida, hacé clic en Usar sample de la integración: trae el ejemplo que guardaste en el capítulo anterior.

Builder de automations con el nodo Llamar Integración seleccionado y el inspector mostrando Integration, Path /oficial, Output dolar y el sample de salida — El nodo guarda la respuesta en dolar. El sample de salida sólo sirve para que el builder sugiera campos.

Probá el nodo sin correr la automation

Pestaña Test del inspector. El Path ya viene con /oficial. Ejecutar test: ves el 200 y la Respuesta, igual que en Configuración. Si la API agregó campos desde que guardaste el ejemplo, Guardar como output sample lo actualiza.

Pestaña Test del inspector con el endpoint de DolarApi, el resultado 200 y la respuesta JSON — La pestaña Test llama de verdad, con los valores que escribas: las referencias entre llaves no se resuelven acá.

Copiá la venta a la oportunidad

Arrastrá Actualizar registro (grupo Datos) debajo del nodo anterior y unilos: arrastrá desde el punto de abajo de Llamar Integración hasta el nodo nuevo. En Configurar:

Registro a actualizar: Registro del trigger, la oportunidad que se acaba de crear.
Campos a actualizar: con + agregá una fila. Campo: dolar_oficial. Valor: {{dolar.body.venta}}.

Inspector del nodo Actualizar registro con el campo dolar_oficial y el valor dolar.body.venta entre llaves dobles — La referencia lleva body en el medio: dolar.body.venta.

Guardá

Guardar, arriba a la derecha. La automation nació Activa: desde ahora corre en cada oportunidad nueva.

Al escribir la referencia, el autocompletado puede ofrecerte dolar.venta, sin body. Esa referencia queda vacía al correr. La respuesta de la API está siempre adentro de body: escribí {{dolar.body. y elegí venta de las sugerencias, o escribila completa.

La automation corre después de guardar la oportunidad y por separado: guardar no espera a la API. Si abrís la oportunidad apenas la creaste, recargá la página para ver la cotización.

Cómo saber que te salió

Creá una oportunidad nueva (Opportunities → Nuevo), por ejemplo Prueba dólar, y guardala.
Recargá su página: Dólar oficial muestra la venta del día, el mismo número que viste en el Test.
En el builder de la automation, el botón de Logs de ejecución (el ícono de la barra superior) lista una corrida con estado success.

¿Llegaste al resultado de arriba?

En la referencia