Категории

​Изменение контакта

Метод позволяет внести изменения в существующий контакт: изменить номер телефона, данные в пользовательских полях контакта и добавить контакт в список. Обратите внимание, что в режиме тестового аккаунта есть ограничение на выполнение этого метода: вы можете изменить только номер телефона контакта на подтвержденный номер (проверка номера выполняется в личном кабинете на платформе Notificore).

Чтобы отредактировать контакт, сделайте запрос по этому URL:

PUT http://one-api.notificore.ru/api/contacts/{id}


Request parameters

Parameter Required Type Description
id Yes integer ID of a contact to be changed
phone Yes integer Contact’s phone number. Value in ITU format. 9 to 15 digits.
groups No array ID array of the contact list to add the contact to.
fields No array Other data in custom contact fields
id integer Contact custom field ID.
value string Value for the custom contact field


Request example

{
    "phone": 85267202829,
    "groups": [
        1
    ],
    "fields": [
        {
            "id": 25964,
            "value": "TARAS IVANOV"
        }
    ]
}


Response parameters

Parameter Type Description
id integer Contact ID for which the query was made.
phone integer Contact phone number.
fields array Contains embedded custom fields data
id integer Custom field ID.
value string Custom field data.
created_at datetime Date when the contact was created in the system. Display format: Y-m-d H:i:s
groups array Contains embedded data of the list where the contact is added.
id string ID of a list where the contact is added.
name string Name of the list where the contact is added.
description string Description of the list where the contact is added.
default bool Indicates whether the contact list is a default one.
created_at datetime Creation date of the list where the contact is added. Display format: Y-m-d H:i:s
hlr_status string Status of the contact phone number verification in the HLR database. Possible values: sent, absent, active, unknown, failed.
hlr_last_check string Date and time when the contact’s phone number was last verified against the HLR database. Display format: Y-m-d H:i:s

Если запрос успешен, вы получите ответ:
 

{
    "data": {
        "id": 1,
        "phone": 85267202829,
        "fields": {
            "additionalProp1": "string",
            "additionalProp2": "string",
            "additionalProp3": "string"
        },
        "created_at": "2022-04-28 14:21:16",
        "groups": [
            {
                "id": 1,
                "name": "string",
                "description": "string",
                "default": 0,
                "created_at": "2022-04-28 14:21:16"
            }
        ],
        "hlr_status": "string",
        "hlr_last_check": "2022-04-28 14:21:16"
    }
}