Перейти к основному содержимому

Начните работу с API групп | Документация для разработчиков

Начните работу с API групп

Обновлено: 14 ноября 2025 г
Условия доступа к API для групп
Для использования групповых функций ваша компания должна быть официальным бизнес-аккаунтом (OBA).

Обзор

Группы в этой сети доступны только по приглашению, а это значит, что потенциальные участники сами решают, присоединяться к группе или нет.
При создании группы генерируется уникальная ссылка-приглашение, которой вы можете поделиться с потенциальными участниками группы. Эта ссылка содержит информацию о группе, позволяя пользователям принять взвешенное решение о том, хотят ли они присоединиться к группе.
После присоединения пользователя к группе срабатывает веб-перехватчик, сигнализирующий о том, что теперь он может отправлять сообщения в группу.
Полный обзор доступных функций см. в разделе «Функции API групп» ниже.

Как начать использовать группы

Предварительные требования

Прежде чем начать работу с API групп, убедитесь в следующем:
    Ваш рабочий номер используется с Cloud API (а не с приложением WhatsApp Business).Ваш сервер веб-хуков настроен для использования с Cloud API.Ваше приложение подписано на следующие группы полей веб-перехватчика:
      group_lifecycle_updategroup_participants_updategroup_settings_updategroup_status_updateВаше приложение подключено к бизнес-аккаунту WhatsApp, зарегистрированному на ваш рабочий номер телефона.Ваше приложение имеет whatapp_business_messaging для бизнес-номера телефона.

      Шаг 2: Создайте группу

      Используйте конечную точку Create Group для создания группы, указав тему и, при необходимости, описание. После успешного создания группы будет возвращен group_lifecycle_update , подтверждающий успешное создание группы invite_link со ссылкой-приглашением, которой вы теперь можете поделиться с потенциальными участниками группы.

      Шаг 3: Пригласите пользователей WhatsApp в группу

      3.1 Добавьте шаблон ссылки-приглашения в группу в библиотеку шаблонов вашей учетной записи:
        Перейдите в библиотеку шаблонов .Слева нажмите меню «Приглашение в группу» , затем установите Приглашение в группу по запросу» .Выберите нужный шаблон, дайте ему имя и нажмите «Отправить».
        3.2 Отправьте ссылку-приглашение потенциальным участникам группы
        После утверждения шаблона используйте его для приглашения участников в группу, используя ссылку-приглашение, предоставленную в веб-хуке из шага 2.
        Чтобы отправить ссылку-приглашение, используя шаблон, который вы только что добавили в свою учетную запись, вы можете следовать инструкциям в справочнике « Отправка шаблона ссылки-приглашения в группу»
        3.3 Уведомление о присоединении участников к группе

        Шаг 4: Отправка и получение сообщений

        Теперь вы можете использовать конечную точку отправки сообщений Cloud API для отправки сообщений группе.
        Веб-хуки для отслеживания статуса «Отправлено», «Доставлено» и «Прочитано» будут срабатывать при появлении обновлений в группе. Ответы от участников также будут запускать веб-хуки.

        Функции

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