Сообщения для связи | Документация для разработчиков
Сообщения контактов
Обновлено: 3 ноября 2025 г
Функция «Сообщения контактов» позволяет отправлять пользователям WhatsApp подробную контактную информацию, такую как имена, номера телефонов, физические адреса и адреса электронной почты.
Когда пользователь WhatsApp нажимает на стрелку профиля в сообщении, отображается информация о контакте в режиме профиля:
Каждое сообщение может содержать информацию о 257 контактах, хотя для удобства использования и предотвращения негативных отзывов рекомендуется отправлять меньшее количество сообщений.
Обратите внимание, что метаданные контакта (например, адреса, даты рождения, электронные адреса) могут не поддерживаться получателем, особенно на его основном устройстве. Для получения информации об основных и связанных устройствах документации .
Параметры запроса
| Заполнитель | Описание | Пример значения |
|---|---|---|
<ACCESS_TOKEN>Нить |
Необходимый.
Системный токен или бизнес-токен . |
|
<ADDRESS_TYPE>Нить |
Необязательный.
Тип адреса, например, домашний или рабочий. |
Домашняя страница |
<API_VERSION>Нить |
Необязательный.
Версия Graph API. |
v25.0 |
<BIRTHDAY>Нить |
Необязательный.
Дата рождения контактного лица. Должна быть указана в ГГГГ-ММ-ДД . |
1999-01-23 |
<CITY>Нить |
Необязательный.
Город, где проживает контактное лицо. |
Менло-Парк |
<COMPANY_OR_ORG_NAME>Нить |
Необязательный.
Название компании, в которой работает контактное лицо. |
Счастливый кустарник |
<COUNTRY_CODE>Нить |
Необязательный.
Двухбуквенный код страны по стандарту ISO. |
НАС |
<COUNTRY_NAME>Нить |
Необязательный.
Название страны. |
Соединенные Штаты |
<DEPARTMENT_NAME>Нить |
Необязательный.
Отдел внутри компании. |
Юридические |
<EMAIL_ADDRESS>Нить |
Необязательный.
Адрес электронной почты контактного лица. |
|
<EMAIL_TYPE>Нить |
Необязательный.
Тип электронной почты, например, личная или рабочая. |
Работа |
<FIRST_NAME>Нить |
Необязательный.
Имя контактного лица. |
Барбара |
<FORMATTED_NAME>Нить |
Необходимый.
Отформатированное имя контакта. Оно будет отображаться в сообщении рядом с кнопкой со стрелкой, указывающей на профиль. |
Барбара Дж. Джонсон |
<JOB_TITLE>Нить |
Необязательный.
Должность контактного лица. |
Главный юрисконсульт |
<LAST_NAME>Нить |
Необязательный.
Фамилия контактного лица. |
Джонсон |
<MIDDLE_NAME>Нить |
Необязательный.
Второе имя Контакта. |
Джоана |
<PHONE_NUMBER>Нить |
Необязательный.
Номер телефона пользователя WhatsApp. |
+16505559999 |
<PHONE_NUMBER_TYPE>Нить |
Необязательный.
Тип телефонного номера. Например, мобильный, основной, iPhone, домашний, рабочий и т. д. |
Домашняя страница |
<PREFIX>Нить |
Необязательный.
Префикс для имени контакта, например, г-н, г-жа, д-р и т. д. |
Доктор. |
<STATE_CODE>Нить |
Необязательный.
Двухбуквенный код штата. |
Калифорния |
<STREET_NUMBER_AND_NAME>Нить |
Необязательный.
Адрес контактного лица. |
1. Lucky Shrub Way |
<SUFFIX>Нить |
Необязательный.
При необходимости добавьте суффикс к имени контактного лица. |
Эсквайр. |
<WEBSITE_TYPE>Нить |
Необязательный.
Тип веб-сайта. Например, корпоративный, рабочий, личный, страница в Facebook, Instagram и т. д. |
Компания |
<WEBSITE_URL>Нить |
Необязательный.
URL-адрес веб-сайта, связанного с контактом или его компанией. |
https://www.luckyshrub.com |
<WHATSAPP_USER_ID>Нить |
Необязательный.
Идентификатор пользователя WhatsApp. Если он не указан, в сообщении вместо стандартных кнопок отобразится кнопка «Пригласить в WhatsApp».
См. раздел «Поведение кнопок» ниже. |
19175559999 |
<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>Нить |
Необходимый.
Идентификатор бизнес-телефона WhatsApp. |
106540352242922 |
<WHATSAPP_USER_PHONE_NUMBER>Нить |
Необходимый.
Номер телефона пользователя WhatsApp. |
+16505551234 |
<ZIP_CODE>Нить |
Необязательный.
Почтовый индекс. |
94025 |
Если вы укажете в сообщении идентификатор WhatsApp контакта (через
wa_id ), сообщение будет содержать кнопку «Сообщение» и «Сохранить контакт» :
Если пользователь WhatsApp нажмет «Сообщение» , откроется новое сообщение с указанным контактом. Если пользователь нажмет «Сохранить контакт» , ему будет предложено сохранить контакт как новый или обновить существующий.
Если вы опустите
wa_id , обе кнопки будут заменены «Пригласить в WhatsApp» :
Комментарии отсутствуют
Комментарии отсутствуют