Чтобы отправлять клиентам текстовые сообщения, используйте узел messages
.
Убедитесь, что выполняются все требования из раздела Предварительные требования статьи Сообщения.
POST
к /messages
.Для отправки текстового сообщения требуется ID соответствующего пользователя в WhatsApp. Укажите text
в поле type
.
POST /v1/messages { "preview_url": false | true, "recipient_type": "individual", "to": "whatsapp-id", "type": "text", "text": { "body": "your-text-message-content" } }
Подробнее о параметрах:
Информацию о форматировании сообщений см. в этом разделе.
По умолчанию мобильное приложение WhatsApp распознает URL и делает их интерактивными. Чтобы активировать предварительный просмотр содержимого по URL, добавьте в тело сообщения параметр "preview_url": true
. URL должен начинаться с префикса http://
или https://
. Необходимо указать имя хоста. Сопоставление IP-адресов не выполняется.
Примечание. Использование preview_url
в этом сценарии отличается от использования в облачном API. Подробнее см. в разделе Messages справки облачного API.
{ "preview_url": true, "to": "whatsapp-id", "text": { "body": "You have to check out this amazing messaging service https://www.whatsapp.com/" }
Обычно получатели сообщений с URL видят интерактивные ссылки независимо от того, включен ли предварительный просмотр.
Предварительный просмотр содержимого по URL отображается только в одном из следующих случаев:
В случае успеха ответ содержит объект messages
с ID только что созданного сообщения.
{ "messages": [{ "id": "gBEGkYiEB1VXAglK1ZEqA1YKPrU" }] }
В случае сбоя ответ содержит сообщение об ошибке. Подробную информацию см. в статье Сообщения об ошибках и коды статусов.