Integraciones: recibí datos de otros sistemas
Endpoints con token, la API pública y los formularios públicos, contados con una tienda online que necesita que sus reclamos, ventas y consultas lleguen solos a Nxar.
- 6capítulos
- 74 minen total
- 4casos de uso
Tienda Raíz es Julieta, que administra el workspace, y Martín, el desarrollador que le armó la tienda online. Entre los dos van a conectar la web con Nxar. Nada de esto sale de Nxar hacia afuera: acá todo entra. Otro sistema (la tienda, un formulario, un script) le manda datos a Nxar y Nxar los guarda como registros.
En este recorrido vas a:
- elegir la puerta de entrada que corresponde a cada caso, sin abrir las cuatro;
- armar un endpoint propio: una URL de tu workspace que recibe un JSON y crea un Case;
- probarlo con
curly ver exactamente qué llegó y qué contestó Nxar; - decidir qué recibe el endpoint, qué valida y qué devuelve;
- usar la API pública con una API key para crear y actualizar registros desde código;
- publicar un formulario que crea Contacts sin escribir una línea.
Usamos sólo entidades estándar (Account, Contact, Case, Opportunity), así que podés seguirlo en cualquier workspace. Los ejemplos de curl están listos para pegar: sólo cambiás la dirección de tu workspace y el token.
Necesitás ser administrador del workspace: los endpoints y la API pública piden el permiso manage_endpoints, y los formularios públicos manage_public_forms. El permission set System Admin trae los dos. Para los ejemplos de terminal alcanza con curl, que viene instalado en macOS, Linux y Windows 10 o posterior.
Paso a paso, en orden.
Cada capítulo deja algo funcionando y termina con cómo comprobarlo.
- 1
Qué puerta usar
Las cuatro formas en que otro sistema le manda datos a Nxar, qué credencial usa cada una y cómo elegir la que corresponde a tu caso.
- 2
Tu primer endpoint
Armás una automation de tipo Endpoint de API que crea un Case con lo que manda la tienda, y la publicás en una URL protegida con un token secreto.
- 3
Probalo y mirá qué llegó
Llamás al endpoint desde Nxar y con curl, encontrás el Case creado y leés en Audit Logs el cuerpo exacto que llegó y lo que contestó Nxar.
- 4
Qué recibe y qué contesta
Cómo se validan los inputs, por qué un campo que no declaraste no llega al flujo, qué devuelve el endpoint y cuándo conviene contestar sólo el acuse.
- 5
La API pública
Prendés la API, creás una API key y desde código creás un Contact, leés un Case y le cambiás el estado, con los permisos de quien creó la key.
- 6
Formularios públicos
Publicás el formulario Escribinos de la tienda: cada envío crea un Contact, sin código y sin servidor, y ves cada envío en Submissions.
Lo mismo, aplicado a otros problemas.
Una venta de la tienda crea una oportunidad
Tu tienda online avisa cada venta mayorista con un JSON y en Nxar aparece una Opportunity ganada, sin duplicados aunque la tienda reintente.
Un sistema externo actualiza el estado de un caso
El sistema del depósito marca como resuelto un Case de Nxar cuando entrega el reemplazo, con un PATCH a la API pública.
Un formulario de reclamos que no duplica contactos
Un formulario público crea un Case y lo vincula al Contact del cliente: si el email ya existe usa ese Contact, si no, lo crea.
Probar un webhook sin escribir código
Probás un endpoint de Nxar con el botón Probar, con Postman o con una herramienta no-code, y encontrás en Audit Logs por qué falló una llamada.