Категории

Создание контакта

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

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

POST http://one-api.notificore.ru/api/contacts


Request parameters

Parameter Required Type Description
phone yes integer Contact’s phone number.
groups array Lists IDs array
id no integer List ID (generated automatically when creating a contact list)
fields array the contact details for custom fields
id no integer Custom field ID
value no string Custom field data

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

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


Response parameters

Parameter Type Description
id integer Contact ID in the Notificore personal account, which is generated automatically when a contact is added to the Contact Book.
phone integer Contact’s 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 ― set by the system automatically when a contact is added to the Contact Book. 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 the list (generated automatically when creating a contact 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 against the HLR database. Possible values: sent, absent, active, unknown, failed.
hlr_last_check datetime The date and time when the contact’s phone number was last checked against the HLR. Display format ― Y-m-d H:i:s.

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

{
    "data": {
        "id": 1,
        "phone": 33601148802,
        "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"
    }
}