Состояние инстанса GREEN-API.

authorized — номер подключён и всё работает; notAuthorized — нужно заново отсканировать QR в консоли GREEN-API; blocked — номер забанен.

Настройки инстанса, включая флаги уведомлений.

Без incomingWebhook: yes журналы входящих сообщений и отметки прочитанным не работают.

Список известных инстансу чатов и контактов (id, имя, тип).

Обновление списка на стороне WhatsApp занимает до 5 минут; пустой ответ сразу после подключения — норма, повторите позже.

Последние сообщения чата, новые первыми.

Основной инструмент чтения переписки. Постраничного обхода у GREEN-API нет — можно только увеличить count (по умолчанию у шлюза 100).

Входящие по всем чатам за последние minutes минут (по умолчанию сутки).

Чтобы посмотреть, что нового вообще пришло, не перебирая чаты. Требует включённого incomingWebhook.

Исходящие по всем чатам за последние minutes минут со статусом доставки.

Карточка контакта: имя, аватар, признак бизнес-аккаунта, последний онлайн.

Для групп не работает — используйте get_group_data.

Данные группы: название, владелец, участники, права.

Есть ли WhatsApp у номера. Проверяйте перед первой отправкой незнакомцу.

Ссылка на файл из сообщения с вложением (по idMessage из истории).

Ссылка временная — скачивайте сразу.

Одно событие из очереди входящих (FIFO, хранится 24 часа).

Возвращает receiptId и body, либо null, если за receive_timeout секунд (5–60) ничего не пришло. После обработки события вызовите delete_notification, иначе следующий вызов вернёт то же самое.

Удаляет обработанное событие из очереди по receiptId.

Отправляет текст в чат. Возвращает idMessage.

Действие необратимо и видно человеку на том конце — спрашивайте подтверждение у пользователя перед вызовом.

Отправляет локальный файл (до 100 МБ) в чат.

Как и send_message — действие необратимо, спрашивайте подтверждение.

Отправляет файл по публичной ссылке — без выкачивания на эту машину.

Отмечает чат прочитанным. Без id_message — весь чат.

Собеседник увидит две синие галочки, так что это тоже заметное действие.

Меняет настройки инстанса; инстанс при этом перезагружается (до 5 минут).

Нужен в основном один раз при подключении: {"incomingWebhook": "yes", "outgoingMessageWebhook": "yes", "outgoingAPIMessageWebhook": "yes"} — без этого журналы входящих и исходящих остаются пустыми.