Ejemplos básicos

Este es un compendio de ejemplos cortos sobre como acceder al API de SalesUp!® / Upnify® en varios lenguajes.

Acceso al sistema via integración

Para acceder al sistema es necesario contar con una llave de acceso denominada "token" que tienen que acompañar a cada petición para que ésta sea respondida por el API. Dichos tokens son de dos tipos:

  • Integración. Son tokens que no tienen expiración y se utilizan para integraciones. Sin embargo su uso es limitado ya que funcionan solo en algunas rutas del API
  • Sesión. Los tokens de sesión están ligados a un usuario del sistema, por lo que los permisos los heredará del mismo. Tiene acceso a todas las rutas del API.

Es posible intercambiar un token de integración por uno de sesión para poder ocupar más rutas en el API. Esto te permitirá mantener tus datos de acceso (usuario/contraseña) independientes al acceso via API.

El siguiente ejemplo muestra cómo acceder al sistema, intercambiando un token de integración por uno de sesión:

Integración de prospectos

El siguiente ejemplo muestra cómo enviar prospectos o clientes al sistema desde un archivo CSV. Estas integraciones se pueden invocar también como resultado de un formato web (generación de leads) o para aplicaciones móviles en donde se recopilen datos o simplemente para interacción entre algunos sistemas.

Nota: Esta integración en particular no requiere token de autenticación, solo token de integración.

Creación de grupos

El siguiente ejemplo indica cómo crear o agregar un nuevo grupo de usuarios, los grupos de usuarios nos permiten segmentar o dividir a los ejecutivos en lo que conocemos como grupos de ventas. Los grupos de ventas son creados para tener una mejor administración sobre un grupo de ejecutivos. A los grupos se les pueden asignar permisos específicos o definir si es necesario auditarlos.

Nota: Para este ejemplo, los ejecutivos que pertenezcan al nuevo grupo, tendrán activa la opción de requerir auditar las ventas que estos realicen.

Creación de Comisiones

El siguiente ejemplo muestra cómo agregar una nueva comisión al sistema, las comisiones constan de un nombre y porcentaje, las comisiones son aplicadas a los ejecutivos, lo cual les permite obtener un porcentaje de las ventas realizadas.

Nota: Para este ejemplo, hay que destacar que cualquier valor representado como porcentaje en el sistema, siempre se encontrará en base 1, es decir 0.1 representa un 10%, 0.5 un 50% y 1 el 100%.