Перейти к содержанию

Идентификатор чата#

Чат может быть индивидуальным или групповым. В случае группового чата идентификатор чата может содержать знак минус "-". Идентификатор чата может быть получен в вебхуках и методами GetChatHistory, GetMessage, LastIncomingMessages, LastOutgoingMessages, GetContacts, GetChats, CheckAccount.

Пример идентификатора индивидуального чата: chatId = "10000000"
Пример идентификатора группового чата: chatId = "-10000000000000"

Важно

Идентификатор чата представлен в строковом типе для обратной совместимости. Однако, рекомендуется выполнять преобразование из строки в число для более компактного хранения в базе данных. Число может быть как положительным - для индивидуальных чатов, так и отрицательным, для групповых чатов. Максимальная длина для групповых чатов составляет 16 символов. Длина идентификатора чата может увеличиться со временем.

Отправка сообщений по идентификатору чата#

Отправка сообщений по идентификатору чата является рекомендуемой. Если Идентификатор чата известен, то используйте его в методах отправки сообщений SendMessage и др. Если Идентификатор чата не известен, то вначале вызовите метод CheckAccount, получите значение chatId, и далее используйте chatId в методах отправки сообщений SendMessage и др.

Отправка сообщений по номеру телефона#

Для поддержки обратной совместимости с предыдущими версиями интерфейса допускается в методе отправки сообщений SendMessage и др, в качестве идентификатора чата указывать номер телефона клиента в формате phoneNumber@c.us. Допускается использовать только номера телефонов для РФ и РБ с кодами "7" и "375" соответственно.

Пример идентификатора чата для РФ: chatId = "79991234567@c.us"
Пример идентификатора чата для РБ: chatId = "375291234567@c.us"

Важно!

При отправке сообщений по номеру телефона система вернет Идентификатор чата, который назначит сервер во входящем вебхуке. Идентификатор чата будет отражен в вебхуке в параметре chatId. Поэтому, отправку по номеру телефона можно использовать только в случаях, когда не требуется обрабатывать входящие сообщения и статусы. Во всех остальных случаях рекомендуется вначале получать Идентификатор чата методом CheckAccount, а затем выполнять отправку по полученному значению chatId, а не по номеру телефона.

См. также: Рекомендации по отправке сообщений