Puoi fornire i dipendenti dal tuo sistema di origine ad actimo utilizzando la nostra API REST. Questo ti permetterà di gestire tre attività fondamentali come la creazione, l'aggiornamento e la cancellazione dei dipendenti in Actimo.

Limiti/richieste di chiamate API:

C'è un limite di 20 richieste/chiamate API per chiave API, al secondo.

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

Chiave API: Chiedi a un amministratore della tua piattaforma di contattare il tuo specialista dell'integrazione.

Vai a: Creare una relazione tra manager e dipendenti

Capire l'API

• Un dipendente in actimo viene chiamato Contatto. Ognuno di questi avrà un proprio ID (id) che potrai utilizzare per aggiornare o apportare modifiche.

• Puoi vedere tutte le chiamate API nella nostra interfaccia utente tramite la scheda Sviluppo. Se ottieni un accesso Admin alla piattaforma da parte del proprietario, puoi copiare/incollare le chiamate e il payload eseguendo le azioni nell'interfaccia utente.

• Actimo non dispone di un ambiente sandbox. Ti consigliamo di effettuare le chiamate nella piattaforma di produzione su 1-2 contatti di prova o di contattare il tuo Customer Success Manager se hai bisogno di una piattaforma di prova.

• L'API di Actimo è in formato JSON.

• Actimo viene fornito con campi predefiniti come "nome" e "cognome". Inoltre, se necessario, è possibile creare campi personalizzati. Tieni presente che mentre i campi predefiniti avranno nomi logici che seguono i dati che contengono, i campi personalizzati si chiameranno dati1, dati2 e così via. Puoi vedere questi nomi utilizzando la scheda sviluppatore dell'interfaccia utente.

Creazione di contatti

Per creare un contatto in actimo è necessaria la seguente chiamata.

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

Aggiungi il payload al corpo con i dati necessari che desideri aggiungere al contatto.

Elimina i contatti

Per eliminare un contatto in actimo è necessaria la seguente chiamata.

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

In questo esempio stiamo eliminando tre contatti in una volta sola, contrassegnati dai parametri evidenziati in grassetto.

Aggiornamento dei contatti

Per aggiornare un contatto in actimo è necessaria la seguente chiamata.

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

Aggiungi il payload al corpo con i dati necessari che desideri aggiornare sui contatti.

Add-on: Creare una relazione tra manager e dipendenti

Se desideri creare una relazione tra i contatti del manager e del dipendente, dovrai effettuare la seguente chiamata. Tieni presente che dovrai utilizzare l'id di contatto sia del manager che del dipendente.

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

Domande?

Le domande relative all'API possono essere rivolte a uno dei nostri specialisti dell'integrazione. Se stai entrando in Actimo avrai già un contatto diretto con uno specialista.

Facci sapere se ti è stato utile cliccando sulle emoji qui sotto o inviando un feedback all'indirizzo support@actimo.com.