Запросить номер телефона
Сервисное сообщение в открытом окне: просит пользователя WhatsApp поделиться номером телефона (REQUEST_CONTACT_INFO).
Используйте, когда пользователь известен только по BSUID и 24-часовое окно ещё открыто. body — текст над кнопкой. Отдельного текста кнопки у метода нет: подпись ставит WhatsApp.
Вне окна создайте шаблон UTILITY или MARKETING с кнопкой REQUEST_CONTACT_INFO через POST /addTemplate (поле text у кнопки не передавайте) и отправьте его через POST /sendTemplate. Параметров у этой кнопки при отправке нет.
Когда пользователь делится номером, входящий вебхук — сообщение contacts с origin: contact_request. Телефон записывается на тот же BSUID, сообщение попадает в историю.
JWT tokentoken<token>application/json- body
body*stringТекст над кнопкой «поделиться контактом».
1 <= length <= 1024phone?stringТелефон получателя с кодом страны. Можно phone, chatId или bsuid.
chatId?stringChat ID получателя ([email protected], BSUID @lid или username @username).
bsuid?stringBSUID, например US.13491208655302741918.
Server response example
application/json- response
sent?booleanid?stringУникальный идентификатор сообщения
message?stringУведомление о статусе отправки сообщения
description?stringКомментарий к результату отправки
curl -X POST 'https://api.1msg.io/123/sendContactInfo' \ -H 'Content-Type: application/json' \ -d '{ "bsuid": "US.13491208655302741918", "body": "Поделитесь номером телефона, чтобы мы могли с вами связаться."}'{ "sent": true, "id": "gBGGeRhGZTEfAgkJCh2wAz4ZH-8", "message": "Sent to [email protected]", "description": "Message has been sent to the provider"}