Vous pouvez provisionner des employés depuis votre système source vers actimo en utilisant notre API REST. Cela vous permettra de gérer les trois tâches principales que sont la création, la mise à jour et la suppression d'employés dans Actimo.

Limites/demandes d'appel à l'API :

Il y a une limite de 20 demandes/appels d'API par clé d'API, par seconde.

Doc API : https://app.swaggerhub.com/apis-docs/Actimo/Actimo

Clé API: Demandez à un administrateur de votre plateforme de contacter votre spécialiste de l'intégration.

Aller à : Créer une relation de manager à employé

Comprendre l'API

• Dans actimo, un employé est appelé contact. Chacun d'entre eux aura son propre identifiant (id) que vous pourrez utiliser pour le mettre à jour ou le modifier.

• Vous pouvez voir tous les appels d'API dans notre interface utilisateur via l'onglet Développer. Si le propriétaire de la plateforme vous donne un login d'administrateur, vous pouvez copier/coller les appels et la charge utile en effectuant les actions dans l'interface utilisateur.

• Actimo ne dispose pas d'un environnement sandbox. Nous vous recommandons d'effectuer les appels dans la plateforme de production en ciblant 1 ou 2 contacts de test ou de contacter votre Customer Success Manager si vous avez besoin d'une plateforme de test.

• L'API d'Actimo est au format JSON.

• Actimo est livré avec des champs par défaut tels que "prénom" et "nom". Ensuite, il est également possible de créer des champs personnalisés si nécessaire. Gardez à l'esprit que les champs par défaut porteront des noms logiques correspondant aux données qu'ils contiennent, tandis que les champs personnalisés seront appelés data1, data2, etc. Vous pouvez voir ces noms dans l'onglet "Développeur" de l'interface utilisateur.

Création de contacts

Pour créer un contact dans actimo, vous avez besoin de l'appel suivant.

POST : https://a.actimo.com/api/v1/contacts

Ajoutez au corps du message les données nécessaires que vous souhaitez ajouter à ce contact.

Supprimer des contacts

Pour supprimer un contact dans actimo, vous avez besoin de l'appel suivant.

DEL : https://a.actimo.com/api/v1/contacts?forceAnonymize=false&ids=8562180&ids=8562181&ids=8562182

Dans cet exemple, nous supprimons trois contacts à la fois, marqués par les paramètres en gras.

Mise à jour des contacts

Pour mettre à jour un contact dans actimo, vous avez besoin de l'appel suivant.

PUT : https://a.actimo.com/api/v1/contacts/ "contact id"

Ajoutez au corps du message les données nécessaires que vous souhaitez mettre à jour sur les contacts.

Add-on : Créer une relation de manager à employé

Si vous souhaitez créer une relation entre les contacts du manager et de l'employé, vous devez effectuer l'appel suivant. Gardez à l'esprit que vous devrez utiliser l'identifiant de contact du responsable et de l'employé.

PUT :https://a.actimo.com/api/v1/contacts/8562183/relationships

Des questions ?

Les questions relatives à l'API peuvent être adressées à l'un de nos spécialistes de l'intégration. Si vous êtes en train d'être intégré à Actimo, vous aurez déjà un contact direct avec un spécialiste.

N'hésitez pas à nous faire savoir si cela vous a été utile en cliquant sur les emoji ci-dessous ou en nous envoyant vos commentaires à l'adresse support@actimo.com.