Lo que vas a lograr
Vas a crear o editar una acción que envía los productos de una oportunidad, sin escribir el cuerpo JSON a mano.Requisitos
- Rol de propietario o administrador en la cuenta de Eva.
- Una conexión de API propia ya creada en Configuración > Integraciones.
- Los nombres de campo que tu sistema espera para cada producto. Pídeselos a quien administra ese sistema.
Configura la lista de productos
1
Abre las acciones
En Configuración > Integraciones, abre API propia. Baja hasta Acciones para CRM.
2
Elige la acción
Para cambiar una acción guardada, selecciona Editar en su renglón. Para una nueva, llena Nombre interno, Etiqueta visible y Ruta.
3
Activa la lista
Abre Lista de productos y activa Enviar los productos de la oportunidad. Aparecen tres datos: SKU, cantidad y precio unitario.
4
Escribe las claves de tu sistema
En Clave de la lista, escribe el nombre con el que tu sistema recibe la lista. En cada renglón, escribe la clave de tu sistema y elige el dato del producto. Para sumar otro, selecciona Agregar dato.
5
Guarda
Selecciona Crear acción para CRM o Guardar cambios. El Cuerpo JSON muestra la misma lista.
Cómo saber que funcionó
Debajo de los renglones, Eva describe el envío con una frase, por ejemplo: «Cada producto de la oportunidad envía el SKU, la cantidad y el precio unitario en «productos»». Al volver a abrir la acción con Editar, los renglones siguen ahí.Si algo sale mal
- La lista dice «Personalizada». El cuerpo JSON tiene una lista escrita a mano que los renglones no pueden mostrar. Eva la conserva tal cual; se edita en Cuerpo JSON.
- La oportunidad muestra «Falta el SKU de» y el nombre de un producto. Ese producto no tiene SKU y la acción lo necesita, así que no se envió nada. Corrige el producto en la oportunidad y selecciona Reintentar.
- La oportunidad muestra «El sistema externo respondió» y un texto. Ese texto es el motivo que dio tu sistema. Corrige lo que indica y selecciona Reintentar.
Consulta el estatus del registro en tu sistema
Una acción que crea un registro en tu sistema, por ejemplo una preventa, puede consultar después su estatus. La acción necesita la Ruta del ID externo, porque Eva consulta el registro con ese ID.1
Abre la acción
En Acciones para CRM, selecciona Editar en el renglón de la acción que crea el registro. La acción usa el método POST.
2
Activa la consulta
Abre Consultar estatus y activa Consultar el estatus desde la oportunidad. Eva propone la ruta de la acción seguida de
{{link.external_record_id}}.3
Escribe la ruta y el campo
En Ruta para consultar, deja
{{link.external_record_id}} donde va el ID. En Campo del estatus en la respuesta, escribe el nombre del campo, por ejemplo status.4
Guarda
Selecciona Guardar cambios. Debajo de los campos, Eva describe con una frase la consulta que hará.
Actualiza el estatus desde la oportunidad
En la oportunidad, el registro que creó la acción muestra su estatus y el botón Actualizar. Al seleccionarlo, Eva consulta tu sistema en ese momento y muestra el estatus tal como llega, con la hora de la consulta.- «Estatus: sin consultar» indica que nadie ha consultado ese registro todavía.
- Si la consulta falla, Eva conserva el último estatus y explica el motivo debajo, por ejemplo «no se encontró en el sistema».
- «sin acceso al sistema» indica que la conexión perdió su acceso. Vuelve a conectarla en Configuración > Integraciones.