Идентификатор чата#
Чат может быть индивидуальным или групповым. В случае группового чата идентификатор чата может содержать знак минус "-". Идентификатор чата может быть получен в вебхуках и методами 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
, а не по номеру телефона.
См. также: Рекомендации по отправке сообщений