Ви можете додати співробітників з вашої вихідної системи до actimo за допомогою нашого REST API. Це дозволить вам виконувати три основні завдання: створювати, оновлювати та видаляти співробітників в Actimo.

API Ліміти/запити на виклики:

Існує обмеження на 20 запитів/викликів API на один ключ API в секунду.

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

Ключ API: Попросіть адміністратора вашої платформи зв'язатися зі спеціалістом з інтеграції.

Перейти до: Побудова відносин між керівником і працівником

Розуміння API

• Співробітник в actimo називається контактом. Кожен з них отримає власний ідентифікатор (id), який ви можете використовувати для оновлення або внесення змін.

• Ви можете побачити всі виклики API в нашому інтерфейсі на вкладці "Розробка". Якщо ви отримали від власника логін адміністратора платформи, ви можете копіювати/вставляти виклики та корисне навантаження, виконуючи відповідні дії в інтерфейсі користувача.

• Actimo не має середовища пісочниці. Ми рекомендуємо здійснювати дзвінки на виробничій платформі, орієнтуючись на 1-2 тестові контакти, або звернутися до вашого менеджера по роботі з клієнтами, якщо вам потрібна тестова платформа.

• API Actimo має формат JSON.

• Actimo постачається з полями за замовчуванням, такими як "ім'я" та "прізвище". По-друге, також можна створювати кастомні поля, якщо це необхідно. Майте на увазі, що якщо поля за замовчуванням матимуть логічні назви після даних, які вони містять, то користувацькі поля називатимуться data1, data2 і т.д. Ви можете побачити ці імена на вкладці розробника в інтерфейсі користувача.

Створення контактів

Для того, щоб створити контакт в actimo, вам потрібно зробити наступний дзвінок.

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

Додайте до тіла повідомлення необхідні дані, які ви хочете додати до цього контакту.

Видалення контактів

Щоб видалити контакт в actimo, вам потрібно зробити наступний дзвінок.

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

У цьому прикладі ми видаляємо одразу три контакти, позначені параметрами, виділеними жирним шрифтом.

Оновлення контактів

Щоб оновити контакт в actimo, вам потрібно зробити наступний дзвінок.

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

Додайте до тіла повідомлення необхідні дані, які ви хочете оновити в контактах.

Доповнення: Побудова відносин між керівником і працівником

Якщо ви хочете створити зв'язок між контактами менеджера та співробітника, вам потрібно зробити наступний дзвінок. Майте на увазі, що вам потрібно буде використовувати контактний ідентифікатор як менеджера, так і співробітника.

ПОСИЛАННЯ: https://a.actimo.com/api/v1/contacts/8562183/relationships

Питання?

Питання щодо API можна задати одному з наших спеціалістів з інтеграції. Якщо ви приєднаєтеся до Actimo, ви вже матимете безпосередній контакт з фахівцем.

Будь ласка, повідомте нам, чи був цей матеріал корисним, натиснувши на смайлик нижче або надіславши відгук на support@actimo.com.