Перейти к основному содержимому

Сообщения для связи | Документация для разработчиков

Сообщения контактов

Обновлено: 3 ноября 2025 г
Функция «Сообщения контактов» позволяет отправлять пользователям WhatsApp подробную контактную информацию, такую ​​как имена, номера телефонов, физические адреса и адреса электронной почты.
Когда пользователь WhatsApp нажимает на стрелку профиля в сообщении, отображается информация о контакте в режиме профиля:
Каждое сообщение может содержать информацию о 257 контактах, хотя для удобства использования и предотвращения негативных отзывов рекомендуется отправлять меньшее количество сообщений.
Обратите внимание, что метаданные контакта (например, адреса, даты рождения, электронные письма) могут не поддерживаться получателем, особенно на его основном устройстве. Для получения информации об основных и связанных устройствах, документации .

Синтаксис запроса

Используйте POST / /messages для отправки сообщения контакта пользователю WhatsApp.
curl 'https://graph.facebook.com/<API_VERSION> /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID> /messages' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer<ACCESS_TOKEN> ' \ -d ' { "messaging_product": "whatsapp", "to": "<WHATSAPP_USER_PHONE_NUMBER> ", "тип": "контакты", "контакты": [ { "адреса": [ { "улица": "<STREET_NUMBER_AND_NAME> ", "город": "<CITY> ", "состояние": "<STATE_CODE> ", "zip": "<ZIP_CODE> ", "страна": "<COUNTRY_NAME> ", "country_code": "<COUNTRY_CODE> ", "тип": "<ADDRESS_TYPE> " }<!-- Additional addresses objects go here, if using --> ], "день рождения": "<BIRTHDAY> ", "emails": [ { "email": "<EMAIL_ADDRESS> ", "тип": "<EMAIL_TYPE> " }<!-- Additional emails objects go here, if using --> ], "имя": { "форматированное_имя": "<FULL_NAME> ", "имя": "<FIRST_NAME> ", "фамилия": "<LAST_NAME> ", "второе имя": "<MIDDLE_NAME> ", "суффикс": "<SUFFIX> ", "префикс": "<PREFIX> " }, "org": { "company": "<COMPANY_OR_ORG_NAME> ", "отделение": "<DEPARTMENT_NAME> ", "заголовок": "<JOB_TITLE> " }, "телефоны": [ "телефон": "<PHONE_NUMBER> ", "тип": "<PHONE_NUMBER_TYPE> ", "wa_id": "<WHATSAPP_USER_ID> " }<!-- Additional phones objects go here, if using --> ], "urls": [ { "url": "<WEBSITE_URL> ", "тип": "<WEBSITE_TYPE> " }<!-- Additional URLs go here, if using --> ] } ] }'
Параметры запроса

Заполнитель

Описание

Пример значения

<ACCESS_TOKEN>
Нить
EAAAN6tcBzAUBOZC82CW7iR2LiaZBwUHS4Y7FDtQxRUPy1PHZClDGZBZCgWdrTisgMjpFKiZAi1FBBQNO2IqZBAzdZAA16lmUs0XgRcCf6z1LLxQCgLXDEpg80d41UZBt1FKJZCqJFcTYXJvSMeHLvOdZwFyZBrV9ZPHZASSqxDZBUZASyFdzjiy2A1sippEsF4DVV5W2IlkOSr2LrMLuYoNMYBy8xQczzOKDOMccqHEZD
<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» :
Пример запроса
Пример запроса на отправку сообщения контактам, содержащим два физических адреса, два адреса электронной почты, два номера телефона и два URL-адреса веб-сайтов.
curl 'https://graph.facebook.com/v25.0/106540352242922/messages' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer EAAJB...' \ -d ' { "messaging_product": "whatsapp", "to": "+16505551234", "type": "contacts", "contacts": [ { "addresses": [ { "street": "1 Lucky Shrub Way", "city": "Menlo Park", "state": "CA", "zip": "94025", "country": "United States", "country_code": "US", "type": "Office" }, { "street": "1 Hacker Way", "city": "Menlo Park", "state": "CA", "zip": "94025", "country": "United Штаты", "country_code": "США", "type": "Всплывающее окно" } ], "birthday": "1999-01-23", "emails": [ { "email": " [email protected] ", "type": "Работа" }, { "email": " [email protected] ", "type": "Работа (старая)" } ], "name": { "formatted_name": "Барбара Дж. Джонсон", "first_name": "Барбара", "last_name": "Джонсон", "middle_name": "Джоана", "suffix": "Esq.", "prefix": "Dr." }, "org": { "company": "Lucky Shrub", "department": "Legal", "title": "Lead Counsel" }, "phones": [ { "phone": "+16505559999", "type": "Landline" }, { "phone": "+19175559999", "type": "Mobile", "wa_id": "19175559999" } ], "urls": [ { "url": "https://www.luckyshrub.com", "type": "Company" }, { "url": "https://www.facebook.com/luckyshrubplants", "type": "Company (FB)" } ] } ] }'
Пример ответа
{ "messaging_product": "whatsapp", "contacts": [ { "input": "+16505551234", "wa_id": "16505551234" } ], "messages": [ { "id": "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1RjQyNUE3NEYxMzAzMzQ5MkEA" } ] }

    
        

    


            

        

    


    


    
    

        

             Вернуться наверх