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

Групповые сообщения

Обновлено: 14 ноября 2025 г

Обзор

В этом документе представлена исчерпывающая информация об API и веб-хуках, доступных для отправки и получения сообщений внутри групп. В нем подробно описана поддержка различных типов сообщений, включая:

Текстовые сообщенияСообщения СМИТекстовые шаблоныШаблоны на основе медиафайлов

Для получения уведомлений через веб-перехватчики о метаданных ваших групп, пожалуйста, подпишитесь на следующие поля веб-перехватчика:

group_lifecycle_updategroup_participants_updategroup_settings_updategroup_status_update

Для получения полной информации о веб-хуках для API групп, пожалуйста, посетите наш справочник по веб-хукам для API групп .

Отправлять group message

~~Для отправки группового сообщения используйте существующую конечную точку отправки сообщений:~~

ПОЧТА /<BUSINESS_PHONE_NUMBER_ID> /сообщения

~~Данная конечная точка была расширена для поддержки групповых сообщений следующим образом:~~

Он тип_получателя ~~field now supports~~ группа ~~as well as~~ individual.Он к ~~field now supports the~~ group ID ~~that is obtained when using the Groups API.~~

Пример отправки группового сообщения

локон 'https://graph.facebook.com/v25.0/756079150920219/messages' \
-ЧАС 'Content-Type: application/json' \
-ЧАС 'Authorization: Bearer EAAAu...' \
-д ' { "messaging_product": "whatsapp", "recipient_type": "group", "to": "Y2FwaV9ncm91cDoxNzA1NTU1MDEzOToxMjAzNjM0MDQ2OTQyMzM4MjAZD", "type": "text", "text": { "preview_url": true, "body": "This is another destination option: https://www.luckytravel.com/DDLmU5F1Pw" } }'

Вебхуки

Пример отправки группового сообщения

{
"объект": "whatsapp_business_account",
"вход": [
     {
"идентификатор": "<WHATSAPP_BUSINESS_ACCOUNT_ID> ",
"изменения": [
         {
"ценить": {
"messaging_product": "WhatsApp",
"метаданные": {
"display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
"идентификатор_номера_телефона": "<BUSINESS_PHONE_NUMBER_ID>"
               },
"статусы": [
                 {
"идентификатор": "<WHATSAPP_MESSAGE_ID> ",
"recipient_id": "<GROUP_ID>",
"recipient_type": "группа",
«статус»: "sent",
"временная метка": "<WEBHOOK_TRIGGER_TIMESTAMP>",
                 }
               ]
           },
"поле": "сообщения"
         }
       ]
     }
   ]
 }

Пример ошибки при отправке группового сообщения

{
"объект": "whatsapp_business_account",
"вход": [
     {
"идентификатор": "<WHATSAPP_BUSINESS_ACCOUNT_ID> ",
"изменения": [
         {
"ценить": {
"messaging_product": "WhatsApp",
"метаданные": {
"display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
"идентификатор_номера_телефона": "<BUSINESS_PHONE_NUMBER_ID>"
               },
"статусы": [
                 {
"идентификатор": "<WHATSAPP_MESSAGE_ID> ",
"recipient_id": "<GROUP_ID>",
"recipient_type": "группа",
«статус»: "неуспешный",
"временная метка": "<WEBHOOK_TRIGGER_TIMESTAMP>",
"ошибки": [
                     {
"код": "<ERROR_CODE>",
"заголовок": "<ERROR_TITLE>",
"сообщение": "<ERROR_MESSAGE>",
"error_data": {
"подробности": "<ERROR_DETAILS>",
                       },
"href": "/documentation/business-messaging/whatsapp/support/error-codes"
                    }
                  ]
                }
              ]
           },
"поле": "сообщения"
         }
       ]
     }
   ]
 }

Получайте групповые сообщения

Для получения информации о статусе сообщений, поступивших в группу, можно использовать следующие веб-хуки.

Объект сообщения содержит group_id , указывающее на то, что это групповое сообщение. from в сообщения и в объекте contact указывают на одного и того же участника, отправившего это сообщение.

Вебхуки

Receive group message webhook sample

{
"объект": "whatsapp_business_account",
"вход": [{
"идентификатор": "<WHATSAPP_BUSINESS_ACCOUNT_ID> ",
"изменения": [{
"ценить": {
"messaging_product": "WhatsApp",
"метаданные": {
"display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
"идентификатор_номера_телефона": "<BUSINESS_PHONE_NUMBER_ID>"
              },
"контакты": [{
"профиль": {
"имя": "<WHATSAPP_USER_NAME>"
                  },
"ва_ид": "<WHATSAPP_USER_PHONE_NUMBER> "
                }],
"сообщения": [{
"от": "<GROUP_PARTICIPANT_PHONE_NUMBER>",
"group_id": "<GROUP_ID>",
"идентификатор": "<WHATSAPP_MESSAGE_ID> ",
"временная метка": "<WEBHOOK_TRIGGER_TIMESTAMP>",
"текст": {
"тело": "<MESSAGE_BODY>"
                  },
"тип": "текст"
                }]
          },
"поле": "сообщения"
        }]
  }]
}

Пример веб-перехватчика для получения неподдерживаемых групповых сообщений

{
"объект": "whatsapp_business_account",
"вход": [
    {
"идентификатор": "<WHATSAPP_BUSINESS_ACCOUNT_ID> ",
"изменения": [
        {
"ценить": {
"messaging_product": "WhatsApp",
"метаданные": {
"display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
"идентификатор_номера_телефона": "<BUSINESS_PHONE_NUMBER_ID>",
              },
"контакты": [
                {
"профиль": {
"имя": "<WHATSAPP_USER_NAME>"
                  },
"ва_ид": "<WHATSAPP_USER_PHONE_NUMBER> "
                }
              ],
"сообщения": [
                {
"от": "<GROUP_PARTICIPANT_PHONE_NUMBER>",
"group_id": "<GROUP_ID>",
"идентификатор": "<WHATSAPP_MESSAGE_ID> ",
"временная метка": "<WEBHOOK_TRIGGER_TIMESTAMP>",
"ошибки": [
                    {
"код": 130501,
"сообщение": "Message type is not currently supported",
"заголовок": "Unsupported message type",
"error_data": {
"подробности": "<ERROR_DETAILS>"
                      }
                    }
                  ],
"тип": "unsupported"
                }
              ]
          },
"поле": "сообщения"
        }
      ]
    }
  ]
}

Закрепить и открепить групповое сообщение

~~Закрепление сообщения подчеркивает его актуальность.~~

Порядок отображения закрепленных сообщений основан на хронологическом порядке родительских сообщений, начиная с самых новых. Если при запросе на закрепление уже закреплены три сообщения, самое старое закрепленное сообщение будет автоматически откреплено.

Пределы

~~При вызове API одновременно можно закрепить только одно сообщение.Закреплять или откреплять сообщения может только администратор группы.Одновременно может существовать не более 3 закрепленных сообщений.~~

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

ПОЧТА /<BUSINESS_PHONE_NUMBER_ID> /сообщения

~~Note: You will receive an error in the sync response if the~~ тип_получателя и к ~~type do not match.~~

Текст запроса

{
"messaging_product": "WhatsApp",
"recipient_type": "группа",
"к": "<GROUP_ID>",
"тип": "pin",
"pin": {
"тип": "<PIN_OPERATION>",
"message_id": "<MESSAGE_ID>",
"expiration_days": "<EXPIRATION>"
  }
}

Параметры тела

~~Заполнитель~~	~~Описание~~	~~Пример значения~~
`<GROUP_ID>` ~~Нить~~	~~Необходимый~~ ~~Группа, в которой вы закрепляете сообщение.~~	`Y2FwaV9ncm91cDoxOTUwNTU1MDA3OToxMjAzNjMzOTQzMjAdOTY0MTUZD`
`<PIN_OPERATION>` ~~Нить~~	~~Необходимый~~ ~~Операция закрепления, которую вы выполняете над группой.~~ ~~Can either be~~ `"pin"` ~~или~~ `"unpin"`	`приколоть`
`<MESSAGE_ID>` ~~Нить~~	~~Необходимый~~ ~~Уникальный идентификатор сообщения, которое вы закрепляете или открепляете в группе.~~	`wamid.HBgLM...`
`<EXPIRATION>` ~~Целое число~~	~~Required when~~ `PIN_OPERATION` ~~является~~ `приколоть` ~~Продолжительность действия заколки в днях. Может составлять от 1 до 30 дней.~~	`4`

Ответный текст

    {
"messaging_product": "WhatsApp",
"контакты": [
        {
"вход": "Y2FwaV9ncm91cDo....",
"ва_ид": "Y2FwaV9ncm91cDo...."
        }
      ],
"сообщения": [
        {
"идентификатор": "wamid.HBgLM..."
        }
      ]
}

Вебхуки

~~Подпишитесь на~~ сообщения ~~webhook topic to receive message status notifications. Standard sent and delivered statuses webhooks will be received for the~~ message_id ~~in the response.~~

~~Learn more about the messages~~ статус ~~webhook object here~~

Веб-хуки статуса групповых сообщений

При отправке сообщений группе вы получите веб-перехватчик, когда сообщение будет доставлено или прочитано.

Вместо отправки нескольких вебхуков для каждого обновления статуса, мы будем отправлять агрегированный вебхук.

Это означает, что если вы отправляете сообщение и настроены на получение нескольких «прочитано» или «доставлено» , мы отправим вам один агрегированный веб-хук, содержащий несколько статуса .

Каждый полученный вами веб-хук относится только к одному сообщению, отправленному одной группе и имеющему один тип статуса.

Узнайте больше о веб-перехватчике статуса групповых сообщений

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