GetChats#

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

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

Запрос#

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

GET

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

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

Ответ#

Поля ответа#

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

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

[
    {
        "chatId": "-10000000000000",
        "name": "GREEN-API Super Group",
        "type": "supergroup",
        "phoneNumber": 0,
        "username": "@green_api_supergroup"
    },
    {
        "chatId": "10000000",
        "name": "Василиса Премудрая",
        "type": "user",
        "phoneNumber": 79876543210,
        "username": "@vasilisa"
    },
    {
        "chatId": "-5098765432",
        "name": "GREEN-API Group",
        "type": "group",
        "phoneNumber": 0,
        "username": ""
    }
]

Ошибки#

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

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