Contacts API - ua
- Anastasiia
- Smart Sender
За допомогою цього API можна переглядати, знаходити, додавати, редагувати, об'єднувати та видаляти контакти в проекті.
Отримання.
Дозволяє отримувати список контактів у проекті.
GET https://api.smartsender.com/v1/contacts
Основні параметри:
Назва | Опис | Валідація |
|---|---|---|
page | Запрошувана сторінка | Мінімальне значення 1 |
limitation | Кількість даних для виводу на сторінці | Мінімальне значення 1, максимальне 20 |
У разі успішної відповіді отримаєте таке:
{
"cursor": Cursor,
"collection": Contact[]
}
Опис відповіді:
Пошук.
Дозволяє знайти збіги контактів за допомогою ключового слова.
GET https://api.smartsender.com/v1/contacts/search
Основні параметри:
Назва | Опис | Валідація |
|---|---|---|
page | Запрошувана сторінка | Мінімальне значення 1 |
limitation | Кількість даних для виводу на сторінці | Мінімальне значення 1, максимальне 20 |
term | Ключове слово для пошуку | Не пусте |
У разі успішної відповіді отримаєте таке:
Опис відповіді:
Пошук за ID.
Отримання інформації про контакт за ідентифікатором.
У разі успішної відповіді отримайте об'єкт типу Contact
Пошук за ID (простий).
Отримання інформації про контакт за ідентифікатором.
У разі успішної відповіді отримайте об'єкт типу Contact
У цьому методі змінні будуть передані як ключ-значення без детальної інформації про самих змінних.
Пошук чату за ID.
Отримання контакту чату за ідентифікатором.
У разі успішної відповіді отримайте об'єкт типу Chat.
Пошук доступних комунікацій з ID.
Отримання списку доступних комунікацій контакту за ідентифікатором.
Основні параметри:
Назва | Опис | Валідація |
|---|---|---|
page | Запрошувана сторінка | Мінімальне значення 1 |
limitation | Кількість даних для виводу на сторінці | Мінімальне значення 1, максимальне 20 |
У разі успішної відповіді отримаєте таке:
Опис відповіді:
Оновлення.
Оновлює дані вибраного клієнта.
Основні параметри: Вкажіть усі необхідні параметри, щоб оновити запит. Це можуть бути як і змінні, ітак системні поля.
Основні параметри:
Назва | Тип | Опис |
|---|---|---|
values | Об'єкт (ключ-значення) | Усі необхідні параметри для оновлення запиту. Це можуть бути як і змінні, так і системні поля. |
Важливо! Якщо вказано неправильне значення для оновлення поля, поле буде пропущено та інше оновлення буде оброблено.
У разі успішної відповіді отримаєте таке:
Запуск події.
Запускає вибрану подію для контакту.
Основні параметри:
Назва | Опис |
|---|---|
name | Назва події, регістр має значення |
У разі успішної відповіді отримаєте таке:
Об'єднання.
Поєднує одного клієнта з іншим. Всі теги, воронки, змінні будуть синхронізовані на користь {contactId}, а всі значення, що відсутня, будуть взяті з {targetContactId}.
У разі успішної відповіді отримаєте таке:
(DEPRECATED) Видалення.
Дозволяє видалити вибраний контакт.
У разі успішної відповіді отримаєте таке:
Створення.
Створення контакту доступне лише для платформи Smart Messenger, використовуючи Channels API (створення шлюзу). Для цього Вам потрібний ідентифікатор каналу.