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

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

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

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

Запрос синтаксис

Используйте ПОЧТА /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID> /сообщения Конечная точка для отправки сообщения от контактов пользователю 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 ID в сообщении (через 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" } ] }

    
        

    


            

        

    


    


    
    

        

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