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

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

Текстовые сообщения

Обновлено: 3 ноября 2025 г
Текстовые сообщения — это сообщения, содержащие только основной текст и, при желании, предварительный просмотр ссылки.

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

Используйте 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", "recipient_type": "individual", "to": "<WHATSAPP_USER_PHONE_NUMBER> ", "type": "text", "text": { "preview_url":<ENABLE_LINK_PREVIEW> , "тело": "<BODY_TEXT> " } }'

Параметры запроса

Заполнитель Описание Пример значения
<ACCESS_TOKEN>
Нить
EAAAN6tcBzAUBOZC82CW7iR2LiaZBwUHS4Y7FDtQxRUPy1PHZClDGZBZCgWdrTisgMjpFKiZAi1FBBQNO2IqZBAzdZAA16lmUs0XgRcCf6z1LLxQCgLXDEpg80d41UZBt1FKJZCqJFcTYXJvSMeHLvOdZwFyZBrV9ZPHZASSqxDZBUZASyFdzjiy2A1sippEsF4DVV5W2IlkOSr2LrMLuYoNMYBy8xQczzOKDOMccqHEZD
<API_VERSION>
Нить
Необязательный.
Версия Graph API.
v25.0
<BODY_TEXT>
Нить
Необходимый.
Основной текст. URL-адреса автоматически преобразуются в гиперссылки.
Максимальное количество символов: 4096.
По запросу, вот ссылка на наш новейший продукт: https://www.meta.com/quest/quest-3/
<ENABLE_LINK_PREVIEW>
Логический
Необязательный.
Установите значение true , чтобы клиент WhatsApp попытался отобразить предварительный просмотр ссылки для любого URL-адреса в тексте сообщения.
истинный
<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>
Нить
Необходимый.
Идентификатор бизнес-телефона WhatsApp.
106540352242922
<WHATSAPP_USER_PHONE_NUMBER>
Нить
Необходимый.
Номер телефона пользователя WhatsApp.
+16505551234
В WhatsApp можно настроить отображение предварительного просмотра первого URL-адреса в тексте сообщения, если он присутствует. URL-адреса должны начинаться с http:// или https:// . Если в тексте сообщения содержится несколько URL-адресов, будет отображен только первый.
Если этот параметр опущен или если не удается получить предварительный просмотр ссылки, вместо нее будет отображена кликабельная ссылка.

Пример запроса

Пример запроса на отправку текстового сообщения с включенным предварительным просмотром ссылок и текстовым телом, содержащим ссылку.
curl 'https://graph.facebook.com/ v25.0 /106540352242922/messages' \ - H 'Content-Type: application/json' \ - H 'Authorization: Bearer EAAJB...' \ - d ' { "messaging_product": "whatsapp", "recipient_type": "individual", "to": "+16505551234", "type": "text", "text": { "preview_url": true, "body": "Как и было запрошено, вот ссылка на наш новейший продукт: https://www.meta.com/quest/quest-3/" } }'

Пример ответа

{ "messaging_product": "whatsapp", "contacts": [ { "input": "+16505551234", "wa_id": "16505551234" } ], "messages": [ { "id": "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1RjQyNUE3NEYxMzAzMzQ5MkEA" } ] }