Адресные сообщения | Документация для разработчиков
Адресные сообщения
Обновлено: 7 ноября 2025 г
Эта функция доступна только для компаний, расположенных в Индии, и их клиентов в Индии.
Сообщения с адресом позволяют пользователям проще делиться адресом доставки с компанией через WhatsApp.
Адресные сообщения — это интерактивные сообщения, состоящие из 4 основных частей:
заголовка , тела , нижнего колонтитула и действия . Внутри компонента действия бизнес-логика задаёт имя «address_message» и соответствующие параметры.В таблице ниже перечислены поля, поддерживаемые адресным сообщением.
| Название поля | Наклейка на дисплей | Тип ввода | Поддерживаемые страны | Ограничения |
|---|---|---|---|---|
имя |
Имя |
текст |
Индия |
Никто |
номер телефона |
Номер телефона |
тел |
Индия |
Только действительные номера телефонов |
in_pin_code |
Пин-код |
текст |
Индия |
Максимальная длина: 6 |
номер дома |
Номер квартиры/дома |
текст |
Индия |
Никто |
номер_этажа |
Номер этажа |
текст |
Индия |
Никто |
номер_башни |
Номер башни |
текст |
Индия |
Никто |
название_здания |
Название здания/квартиры |
текст |
Индия |
Никто |
адрес |
Адрес |
текст |
Индия |
Никто |
достопримечательность_район |
Достопримечательность/Район |
текст |
Индия |
Никто |
город |
Город |
текст |
Индия |
Никто |
состояние |
Состояние |
текст |
Индия |
Никто |
Обработка ошибок
Если код города телефонного номера для указанной страны неверен, компании не смогут запросить адресное сообщение у получателя. Например, компании не смогут запросить адресное сообщение у получателя, у которого страна указана как «Индия», но телефонный номер имеет код города «65».
После отправки адресного сообщения компания ожидает, пока пользователь введёт адрес и отправит его обратно. Введённый пользователем адрес передаётся через веб-хук, зарегистрированный в процессе настройки .
Шаги обработки адресного сообщения
Процесс отправки адресного сообщения включает следующие этапы:
address_message.Пользователь взаимодействует с сообщением, нажав на кнопку призыва к действию (CTA), после чего открывается экран ввода адреса. Пользователь заполняет свой адрес и отправляет формуПосле отправки пользователем формы с адресом партнер получает уведомление через веб-хук, содержащее подробную информацию об адресе, предоставленном пользователем
Пример сообщения с адресом в Индии
На следующей диаграмме показана типичная последовательность обработки адресного сообщения.
Проверьте свой ответ
В случае успешного ответа предоставляется
messages с идентификатором для вновь созданного сообщения.Неудачный ответ содержит сообщение об ошибке. Дополнительную информацию разделах «Коды ошибок» и «Коды состояния»
Функция не поддерживается
В случае, если клиент не поддерживает
address_message , сообщения молча отбрасываются, и в веб-перехватчик отправляется сообщение об ошибке. Ниже показано уведомление веб-перехватчика, которое будет отправлено обратно: