Отправка текстовых сообщений

Чтобы отправлять клиентам текстовые сообщения, используйте узел messages.

Прежде чем начать

Убедитесь, что выполняются все требования из раздела Предварительные требования статьи Сообщения.

Ограничения:

  • максимальная длина текстового сообщения — 4 096 символов.

Шаг 1. Выполните запрос 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"
    }
}

Подробнее о параметрах:

Информацию о форматировании сообщений см. в этом разделе.

Отправка URL в текстовых сообщениях

По умолчанию мобильное приложение 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 отображается только в одном из следующих случаев:

  1. Компания отправила пользователю шаблон сообщения.
  2. Пользователь начал переписку по ссылке "Прямая связь".
  3. Пользователь добавил номер телефона компании в свою адресную книгу и начал переписку.

Шаг 2. Проверьте ответ.

В случае успеха ответ содержит объект messages с ID только что созданного сообщения.

{
  "messages": [{
    "id": "gBEGkYiEB1VXAglK1ZEqA1YKPrU"
  }]
}  

В случае сбоя ответ содержит сообщение об ошибке. Подробную информацию см. в статье Сообщения об ошибках и коды статусов.