WhatsApp Business API для командной рассылки — создать группу WhatsApp

Обзор сценария

В этом сценарии используется API групп с операцией создания, чтобы создать именованную WhatsApp-группу для командной рассылки. Окно сессии на 24 часа не требуется, так как вызов — это действие по управлению каналом.

Пример шаблона

Создана внутренняя группа для рассылки — поделитесь ссылкой-приглашением со своей командой.

Когда использовать

Используйте это решение, когда отделу продаж или маркетинга нужна выделенная группа в WhatsApp для внутренних рассылок и координации кампаний, а создание групп вручную в приложении Business не масштабируется на разные каналы или автоматизацию. Это подходит для разработчиков, которые интегрируют триггеры CRM или админки, небольших команд, создающих именованный канал рассылки, и агентств, создающих клиентские группы кампаний без ручных административных шагов.

Как это работает

1. Триггер

   Мероприятие администратора или событие в CRM инициируют создание групп для команды.

   event · triggered

2. Событие захвата

   groups create задаёт имя группы и внутреннее описание рассылки.

   POST /groups

3. Собрать и отправить

   API возвращает метаданные группы, включая ссылку приглашения.

   POST /groups

4. Доставлено

   Система отправляет URL для приглашения авторизованным членам команды.

   delivered

Техническая реализация

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

1. Ключ 1MSG API · Как получить ключ API
2. Аккаунт WhatsApp Business · Как подключить WABA
3. Открыть 24-часовое окно сессии · Как работает 24-часовое окно
4. Подключение клиента · Как управлять согласием клиентов

Примеры кода

#!/usr/bin/env bash
set -euo pipefail

# === Configuration (replace "___" placeholders) ===
API_BASE_URL="https://api.1msg.io"        # production 1MSG API base URL
CHANNEL_ID="___"                           # channel ID from 1MSG dashboard
API_TOKEN="___"                            # channel JWT token (Bearer)



URL="${API_BASE_URL%/}/${CHANNEL_ID}/groups"

read -r -d '' PAYLOAD <<JSON || true
{
  "groupName": "Sales team Q1",
  "description": "Internal broadcast"
}
JSON

RESPONSE="$(curl -s -w '\n%{http_code}' -X POST "$URL" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${API_TOKEN}" \
  -d "$PAYLOAD")"

HTTP_CODE="$(printf '%s' "$RESPONSE" | tail -n1)"
BODY="$(printf '%s' "$RESPONSE" | sed '$d')"

case "$BODY" in
  *'"created":true'*) ok=1 ;;
  *) ok=0 ;;
esac

if [ "$HTTP_CODE" -ge 200 ] && [ "$HTTP_CODE" -lt 300 ] && [ "$ok" -eq 1 ]; then
  echo "$BODY"
else
  echo "$BODY" >&2
  exit 1
fi

Статус ответа и доставки

HTTP 2xx и JSON "sent": trueозначают, что 1MSG принял сообщение для отправки — это не значит, что оно уже достигло телефона клиента. Сохраните idполе (выглядит как wamid.…) для сопоставления уведомлений о доставке.

{
  "sent": true,
  "id": "wamid.HBgLMzgwNjM5...",
  "message": "Message accepted for delivery"
}

Доставка прибытия происходит позже, как отдельный обратный вызов. Зарегистрируйте POST …/webhookвебхук, и 1MSG отправит обновления статуса на ваш HTTPS-адрес в hooks[]полезной нагрузке верхнего уровня

{
  "hooks": [
    {
      "id": "gBGGeSaGViBfAgnlzOSHEwK9O6F",
      "type": "message",
      "status": "sent",
      "timestamp": "1654864094",
      "recipient_id": "556123122026"
    }
  ]
}

Если вы предпочитаете не получать обратные вызовы, вместо этого используйте опрос GET {base}/{channel}/hookInfo?messageId=<id>. На практике доставка часто завершается за считанные секунды, но контракт API этого не гарантирует, поэтому никогда не блокируйте процесс в ожидании её.

Распространённые ошибки

ЧАСТО ЗАДАВАЕМЫЕ ВОПРОСЫ