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

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

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

Обзор

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

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

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

group_lifecycle_updategroup_participants_updategroup_settings_updategroup_status_update

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

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

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

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

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

Поле recipient_type теперь поддерживает групповой , так и индивидуальный тип получателя.В «Кому» теперь поддерживается идентификатор группы , полученный при использовании API групп.

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

curl 'https://graph.facebook.com/v25.0/756079150920219/messages' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAAu...' \
-d ' { "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" } }'

Вебхуки

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

{
"object": "whatsapp_business_account",
"entry": [
     {
"id": ",
"changes": [
         {
"value": {
"messaging_product": "whatsapp",
"metadata": {
"display_phone_number": ",
"phone_number_id": "
               },
"statuses": [
                 {
"id": ",
"recipient_id": ",
"recipient_type": "group",
"status": "sent",
"timestamp": ",
                 }
               ]
           },
"field": "messages"
         }
       ]
     }
   ]
 }

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

{
"object": "whatsapp_business_account",
"entry": [
     {
"id": ",
"changes": [
         {
"value": {
"messaging_product": "whatsapp",
"metadata": {
"display_phone_number": ",
"phone_number_id": "
               },
"statuses": [
                 {
"id": ",
"recipient_id": ",
"recipient_type": "group",
"status": "failed",
"timestamp": ",
"errors": [
                     {
"code": ",
"заголовок": ",
"сообщение": ",
"error_data": {
"details": ",
                       },
"href": "/documentation/business-messaging/whatsapp/support/error-codes"
                    }
                  ]
                }
              ]
           },
"field": "messages"
         }
       ]
     }
   ]
 }

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

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

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

Вебхуки

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

{
"object": "whatsapp_business_account",
"entry": [{
"id": ",
"changes": [{
"value": {
"messaging_product": "whatsapp",
"metadata": {
"display_phone_number": ",
"phone_number_id": "
              },
"контакты": [{
"профиль": {
"имя": "
                  },
"wa_id": "
                }],
"messages": [{
"from": ",
"group_id": ",
"идентификатор": ",
"временная метка": ",
"текст": {
"тело": "
                  },
"type": "text"
                }]
          },
"field": "messages"
        }]
  }]
}

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

{
"object": "whatsapp_business_account",
"entry": [
    {
"id": ",
"changes": [
        {
"value": {
"messaging_product": "whatsapp",
"metadata": {
"display_phone_number": ",
"phone_number_id": ",
              },
"контакты": [
                {
"профиль": {
"имя": "
                  },
"wa_id": "
                }
              ],
"messages": [
                {
"from": ",
"group_id": ",
"идентификатор": ",
"временная метка": ",
"errors": [
                    {
"code": 130501,
"message": "Тип сообщения в настоящее время не поддерживается",
"title": "Неподдерживаемый тип сообщения",
"error_data": {
"details": "
                      }
                    }
                  ],
"type": "unsupported"
                }
              ]
          },
"field": "messages"
        }
      ]
    }
  ]
}

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

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

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

Пределы

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

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

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

в ответе на запрос синхронизации появится ошибка recipient_type и to type не совпадают,

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

{
"messaging_product": "whatsapp",
"recipient_type": "group",
"to": ",
"type": "pin",
"pin": {
"type": ",
"message_id": ""
expiration_days": "
  }
}

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

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

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

    {
"messaging_product": "whatsapp",
"contacts": [
        {
"input": "Y2FwaV9ncm91cDo....",
"wa_id": "Y2FwaV9ncm91cDo...."
        }
      ],
"messages": [
        {
"id": "wamid.HBgLM..."
        }
      ]
}

Вебхуки

Подпишитесь на messages , чтобы получать уведомления о статусе сообщений. Стандартные веб-хуки для статусов отправленных и доставленных сообщений будут получены для message_id в ответе.

сообщений можно узнать статуса здесь.

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

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

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

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

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

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

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