GetContacts#
Метод предназначен для получения списка контактов текущего аккаунта.
Запрос#
Для получения списка контактов требуется выполнить запрос по адресу:
GET https://api.green-api.com/waInstance{{idInstance}}/GetContacts/{{apiTokenInstance}}
Для получения параметров запроса idInstance
и apiTokenInstance
обратитесь к разделу Перед началом работы.
Ответ#
Поля ответа#
Поле | Тип | Описание |
---|---|---|
id | string | Идентификатор корреспондента или группового чата |
name | string | Имя контакта. Возможные значения: |
1) Если аккаунт записан в телефонную книгу, то получаем имя из книги | ||
2) Если аккаунт не записан в телефонную книгу, то получаем имя из профиля WhatsApp | ||
3) Если аккаунт не записан в телефонную книгу и не назначено имя профиля в WhatsApp, то получаем пустое поле | ||
type | string | Тип контакта. Возможные значения: |
user - контакт приналдежит корреспонденту | ||
group - контакт является групповым чатом |
Пример тела ответа#
[
{
"id": "11001234567@c.us",
"name": "Иван Петров",
"type": "user"
},
{
"id": "79001234568@c.us",
"name": "Люся Сидорова",
"type": "user"
},
{
"id": "79001234569-1479621234@g.us",
"name": "Моя группа",
"type": "group"
}
]
Ошибки GetContacts#
Перечень общих для всех методов ошибок смотрите в разделе Стандартные ошибки
Пример кода на Python#
import requests
url = "https://api.green-api.com/waInstance{{idInstance}}/getContacts/{{apiTokenInstance}}"
payload = {}
headers= {}
response = requests.request("GET", url, headers=headers, data = payload)
print(response.text.encode('utf8'))