> ## Documentation Index
> Fetch the complete documentation index at: https://gowa-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Экспериментальные интерактивные сообщения

> Отправлять кнопки ответа, вызовы действию, списки выбора, запросы о местоположении и карусели изображений.

`POST /send/interactive` посылает сообщения WhatsApp native-flow через выбранное устройство. Используйте Basic Auth, `X-Device-Id` и JSON-тел. Эта конечная точка поддерживает немедленные REST отправки. Запланированные посылки и MCP не выявляют его.

> [!WARNING]
>
> Эта экспериментальная конечная точка использует неофициальный протокол WhatsApp. Отображение получателя зависит от клиента и может быть изменено без уведомления. Тестирование целевых клиентов перед использованием. Успешный ответ API подтверждает отправку подтверждения, не доставки или рендеринга.

Установите URL сервера и учетные данные перед запуском примера curl. Используйте публичный URL-адрес HTTPS для удаленного сервера и включите `APP_BASE_PATH` при настройке.

```bash theme={null}
export GOWA_URL=http://localhost:3000
export GOWA_USER=admin
export GOWA_PASSWORD=replace-with-your-password
export DEVICE_ID=my-device
```

## Отправка кнопок

```bash theme={null}
curl --user "$GOWA_USER:$GOWA_PASSWORD" \
  -H 'Content-Type: application/json' -H "X-Device-Id: $DEVICE_ID" \
  "$GOWA_URL/send/interactive" --data '{
    "phone": "628123456789",
    "body": "Confirm your order?",
    "footer": "Order 123",
    "buttons": [
      {"name": "quick_reply", "params": {"display_text": "Confirm", "id": "confirm"}},
      {"name": "quick_reply", "params": {"display_text": "Cancel", "id": "cancel"}}
    ]
  }'
```

`phone` принимает номер телефона или полный пользователь или группу JID. Для отправки сообщений группе требуется разрешение на членство и публикацию. Не поддерживается рассылка и получатели рассылки.

Укажите на верхнем уровне либо `buttons`, либо `cards`. Если указаны оба поля или ни одного, проверка завершится ошибкой.

| Название кнопки | Требуемые параметры |
| - | - |
| `quick_reply` | Непустые строки `display_text` и `id`. |
| `cta_url` | Nonempty `display_text` и абсолютный HTTP или HTTPS `url`. |
| `cta_copy` | Непустые строки `display_text` и `copy_code`. |
| `cta_call` | Непустые строки `display_text` и `phone_number`. |
| `single_select` | Непустая `title` и `sections`. Каждая секция требует непустой `rows`; каждая строка требует непустой строки `id` и `title`. |
| `send_location` | Объект JSON, такой как `{}`. Должно быть единственной кнопкой в сообщении без карт. |

Для выбора списка используйте следующие параметры:

```json theme={null}
{
  "name": "single_select",
  "params": {
    "title": "Choose a size",
    "sections": [{
      "title": "Sizes",
      "rows": [
        {"id": "small", "title": "Small"},
        {"id": "large", "title": "Large"}
      ]
    }]
  }
}
```

## Запросить местоположение

```json theme={null}
{
  "phone": "628123456789",
  "body": "Share your delivery location",
  "buttons": [{"name": "send_location", "params": {}}]
}
```

Отправить этот JSON в `/send/interactive`. Получатель должен выбрать для общего доступа местоположение. Конечная точка не получает местоположение без их действия.

## Отправить изображение карусели

```json theme={null}
{
  "phone": "628123456789",
  "body": "Choose a product",
  "cards": [
    {
      "title": "Product A",
      "body": "Available in blue",
      "image_base64": "<raw JPEG or PNG base64>",
      "buttons": [{"name": "quick_reply", "params": {"display_text": "Choose A", "id": "choose_a"}}]
    },
    {
      "title": "Product B",
      "body": "Available in green",
      "image_base64": "<raw JPEG or PNG base64>",
      "buttons": [{"name": "quick_reply", "params": {"display_text": "Choose B", "id": "choose_b"}}]
    }
  ]
}
```

Замените заполнители изображений на стандартные base64, без префикса URL данных. Изображения являются необязательными для отдельных карт. GOWA размещает изображения на 1280 пикселей, преобразует их в JPEG, создает эскизы и загружает их в WhatsApp. Не принимаются URL-адреса изображений.

## Ограничения запросов

| Поле | Лимит |
| - | - |
| Сообщение `body` | Необходимые и незаполненные, максимум 4096 байт. |
| Сообщение `footer` | Максимум 256 байт. |
| `buttons` | От 1 до 10 сообщений на карту. |
| Кнопка `params` | JSON объекта, максимум 16,384 байта. |
| `cards` | 2–10 карт. |
| Поле `body` карточки | Необходимые и незаполненные, максимум 4096 байт. |
| Карта `title` и `footer` | Максимум 256 байт каждый. |
| Карта `image_base64` | Максимум 2,800,000 кодированных символов и 2,000,000 декодированных байт, также с учетом установленного размера изображения сервера. |
| Декодированное изображение | JPEG или PNG, максимум 4096 пикселей на сторону. |

Также применяется общий лимит HTTP-запросов сервера. Используйте маленькие изображения при отправке нескольких карт. Недопустимый выбор или размер возвращает ошибку проверки перед отправкой.

## Обрабатывать ответы и квитанции

Успешно отправлены возвращают нормальный конверт успеха с помощью `results.message_id` и не верифицирован статус, в котором говорится, что рендеринг получателя. Используйте [incoming webhooks](https://gowa-docs.mintlify.site/ru/concepts/webhooks.md) для ответов и событий `message.ack` для чеков. Повтор после неоднозначного таймаута может дублировать сообщения.

По проходящим тестам Android сообщалось о действиях рабочего ответа, URL, копирования, вызова, выбора, местоположения и карусели. Эти отчеты не позволяют установить совместимость между аккаунтами, iOS или WhatsApp Web. Индивидуальные карточки карусели могут отображать нерешенные значки, даже если родительское сообщение имеет флажки, и получатель может ответить. Эта проблема остается нерешенной.

Конечная точка не регистрирует официальные шаблоны или поддерживает встроенные Flows, каталоги или родные платежи.


## Related topics

- [Отправка сообщений](https://gowa-docs.mintlify.site/ru/examples/sending-messages.md)
- [Справочник по API](https://gowa-docs.mintlify.site/ru/api-reference/introduction.md)
- [GOWA: WhatsApp REST API](https://gowa-docs.mintlify.site/ru/index.md)
- [Скачать медиа из сообщения](https://gowa-docs.mintlify.site/ru/api-reference/message/скачать-медиа-из-сообщения.md)
- [Получить последние сообщения (канал)](https://gowa-docs.mintlify.site/ru/api-reference/newsletter/получить-последние-сообщения-канал.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.