U kunt medewerkers vanuit uw bronsysteem aan actimo leveren met behulp van onze REST API. Hiermee kunt u drie kerntaken uitvoeren: medewerkers aanmaken, bijwerken en verwijderen in Actimo.

API oproeplimieten/-verzoeken:

Er is een limiet van 20 API-verzoeken/oproepen per API-sleutel, per seconde.

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

API-sleutel: Laat een beheerder van je platform contact opnemen met je integratiespecialist.

Spring naar: Relatie manager-werknemer maken

De API begrijpen

• Een medewerker in actimo wordt een Contact genoemd. Elk van deze krijgt zijn eigen ID (id) die je kunt gebruiken om bij te werken of wijzigingen aan te brengen.

• Je kunt alle API-aanroepen in onze UI zien via het tabblad Ontwikkelen. Als je een beheerderslogin op het platform krijgt van de eigenaar, kun je oproepen en payload kopiëren/plakken door de acties in de UI uit te voeren.

• Actimo heeft geen sandbox-omgeving. We raden je aan om de gesprekken te voeren in het productieplatform en je te richten op 1-2 testcontacten of contact op te nemen met je Customer Success Manager als je een testplatform nodig hebt.

• De API van Actimo is in JSON-formaat.

• Actimo wordt geleverd met standaardvelden zoals "voornaam" en "achternaam". Ten tweede is het ook mogelijk om aangepaste velden te maken als dat nodig is. Houd er rekening mee dat waar standaardvelden logische namen hebben naar de gegevens die ze bevatten, aangepaste velden data1, data2 enz. heten. Je kunt deze namen zien op het tabblad Ontwikkelaar in de UI.

Contacten maken

Om een contact aan te maken in actimo heb je het volgende gesprek nodig.

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

Voeg payload toe aan de body met noodzakelijke gegevens die je wilt toevoegen aan dat contact.

Contacten verwijderen

Om een contactpersoon in actimo te verwijderen, heb je het volgende gesprek nodig.

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

In dit voorbeeld verwijderen we drie contactpersonen tegelijk, gemarkeerd als de vetgedrukte parameters.

Contacten bijwerken

Om een contactpersoon bij te werken in actimo heb je de volgende oproep nodig.

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

Voeg payload toe aan de body met de benodigde gegevens die je wilt bijwerken bij de contactpersonen.

Toevoeging: Een manager-werknemerrelatie maken

Als je een relatie wilt maken tussen manager- en werknemercontacten, moet je het volgende doen. Houd er rekening mee dat je de contact-id van zowel de manager als de medewerker moet gebruiken.

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

Vragen?

Vragen over de API kun je stellen aan een van onze integratiespecialisten. Als je wordt aangenomen bij Actimo heb je al direct contact met een specialist.

Laat ons ook weten of dit nuttig was door op de onderstaande emoji's te klikken of feedback te sturen via support@actimo.com.