GetChats#

Метод предназначен для получения списка чатов текущего аккаунта.

Для метода используются ограничения на частоту запросов в секунду.

Запрос#

Для получения списка контактов требуется выполнить запрос по адресу:

GET

{{apiUrl}}/waInstance{{idInstance}}/getChats/{{apiTokenInstance}}

Для получения параметров запроса apiUrl, idInstance и apiTokenInstance обратитесь к разделу Перед началом работы.

Ответ#

Поля ответа#

Поле	Тип	Описание
`chatId`	string	Идентификатор корреспондента или группового чата
`name`	string	Имя чата (Название группы либо имя контакта)
`type`	string	Тип чата. Может принимать значения `user`, `group`, `supergroup`, `channel`
`phoneNumber`	integer	Номер телефона контакта Если номер телефона скрыт, или контакт являестя группой, принимает значение `0`

Пример тела ответа#

[
    {
        "chatId": "-10000000000000",
        "name": "GREEN-API Super Group",
        "type": "supergroup",
        "phoneNumber": 0
    },
    {
        "chatId": "10000000",
        "name": "Василиса Премудрая",
        "type": "user",
        "phoneNumber": 79876543210
    },
    {
        "chatId": "-5098765432",
        "name": "GREEN-API Group",
        "type": "group",
        "phoneNumber": 0
    },
    {
        "chatId": "10000002",
        "name": "Иван Царевич",
        "type": "user",
        "phoneNumber": 0
    }
]

Ошибки#

Перечень общих для всех методов ошибок смотрите в разделе Стандартные ошибки

Код HTTP	Описание ошибки	Возможные решения
200	Метод getContacts возвращает пустой массив `[]`	Обратиться в службу техподдержки