Actimo: Aprovisionamiento de empleados con la API REST de Actimo
Puedes aprovisionar empleados desde tu sistema fuente a actimo utilizando nuestra API REST. Esto te permitirá manejar tres tareas principales como crear, actualizar y eliminar empleados en Actimo.
Límites/peticiones de llamadas a la API:
Hay un límite de 20 peticiones/llamadas API por Clave API, por segundo.
Doc. API: https://app.swaggerhub.com/apis-docs/Actimo/Actimo
Clave API: Haz que un administrador de tu plataforma se ponga en contacto con tu especialista en integración.
Salta a: Crear la relación jefe-empleado
Comprender la API
Un empleado en actimo se denomina Contacto. Cada uno de ellos obtendrá su propio identificador (id), que podrás utilizar para actualizar o realizar cambios.
Puedes ver todas las llamadas a la API en nuestra interfaz de usuario a través de la pestaña Desarrollar. Si obtienes un acceso de administrador a la plataforma por parte del propietario, puedes copiar/pegar las llamadas y la carga útil realizando las acciones en la interfaz de usuario.
Actimo no tiene un entorno sandbox. Te recomendamos que realices las llamadas en la plataforma de producción dirigiéndote a 1-2 contactos de prueba o que te pongas en contacto con tu Gestor de Éxito de Clientes si necesitas una plataforma de prueba.
La API de Actimo está en formato JSON.
Actimo viene con campos por defecto como "nombre" y "apellidos". En segundo lugar, también es posible crear campos personalizados si es necesario. Ten en cuenta que mientras que los campos por defecto tendrán nombres lógicos según los datos que lleven, los campos personalizados se llamarán datos1, datos2, etc. Puedes ver estos nombres utilizando la pestaña de desarrollador en la interfaz de usuario.
Crear contactos
Para crear un contacto en actimo necesitarás la siguiente llamada.
POST: https://a.actimo.com/api/v1/contacts
Añade la carga útil al cuerpo con los datos necesarios que desees añadir a ese contacto.
Borrar contactos
Para eliminar un contacto en actimo necesitarás la siguiente llamada.
DEL: https://a.actimo.com/api/v1/contacts?forceAnonymize=false&ids=8562180&ids=8562181&ids=8562182
En este ejemplo estamos eliminando tres contactos a la vez marcados como los parámetros resaltados en negrita.
Actualizar contactos
Para actualizar un contacto en actimo necesitarás la siguiente llamada.
PUT: https://a.actimo.com/api/v1/contacts/"id de contacto"
Añade la carga útil al cuerpo con los datos necesarios que desees actualizar en los contactos.

Complemento: Crear una relación jefe-empleado
Si deseas crear una relación entre los contactos del manager y del empleado, tendrás que hacer la siguiente llamada. Ten en cuenta que tendrás que utilizar el identificador de contacto tanto del jefe como del empleado.
PUT: https://a.actimo.com/api/v1/contacts/8562183/relationships

¿Tienes preguntas?
Las preguntas relativas a la API pueden dirigirse a uno de nuestros especialistas en integración. Si te incorporas a Actimo, ya tendrás contacto directo con un especialista.
Por favor, haznos saber si te ha resultado útil haciendo clic en los emoticonos de abajo o enviándonos tus comentarios a través de support@actimo.com.
0 comentarios
Inicie sesión para dejar un comentario.