Карусель слайдов перед занятием в группе WhatsApp через WhatsApp API

Q: Где готовятся изображения слайдов?

На вашем backend. Шаг Whapi в каталоге — только sendMessageCarousel. Планирование, экспорт LMS и публичные HTTPS URL для JPEG остаются в own_backend.

Сценарий

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

Триггер — незадолго до запланированного занятия

Используйте поток, когда запланированная задача срабатывает незадолго до начала занятия, а не когда несвязанное бизнес-событие даёт разовый файл.

Назначение — существующая группа курса

Используйте поток, когда у каждого курса уже есть JID группы WhatsApp и студентам нужен предпросмотр слайдов в этом чате.

Слайды уходят как листаемые карточки-изображения

Используйте поток, когда экспортированные JPEG должны быть одним каруселем, а не одним документом или еженедельным визуальным отчётом LMS.

Чат группы WhatsApp на телефоне с листаемым каруселем слайдов, опубликованным незадолго до занятия.

Опыт клиента

Студенты смотрят слайды в чате

Презентации остаются в LMS или на компьютере преподавателя, пока кто-то вручную не опубликует в группе, поэтому студенты часто открывают чат без листаемого предпросмотра на телефоне.

После потока студенты открывают группу курса и листают слайды каруселью до начала занятия. Интеграторы строят этот результат через WhatsApp API.

Рабочий процесс

Опубликуйте карусель в группе

Срабатывает планировщик перед занятием

Планировщик запускается незадолго до сессии. Worker читает LMS или календарь, определяет JID группы курса и собирает карточки карусели из публичных HTTPS URL каждого JPEG.

Отправьте карусель слайдов в группу курса

POST /messages/carousel

sendMessageCarousel доставляет стопку карточек в группу курса. JID группы — в to, список карточек — в cards.

Примеры кода

Нужно отслеживание доставки? Успешный ответ API не значит, что студенты уже видят каждую карточку. О статусах доставки →

Что нужно заранее

Перед запуском потока

Подключите номер WhatsApp, который публикует в группах курса, и авторизуйте каждый запрос токеном API этого номера. Расписание, экспорт слайдов и тело карусели остаются на вашем backend.

1.Создайте аккаунт Whapi.Cloud: Регистрация
2.Подключите аккаунт WhatsApp: Открыть руководство
3.Найдите токен API: Открыть раздел

Необязательно — углубиться в этот поток

Автоматизация групп WhatsApp: Открыть руководство
Отправка сообщения с кнопками: Открыть руководство
Обзор отправки сообщений: Открыть руководство

Реализация API

Один вызов отправляет карусель

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

Получите токен API бесплатно после регистрации на whapi.cloud и используйте его в коде вместо Your_Token из примеров.

Отправьте карусель слайдов в группу курса

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

curl --request POST \
     --url https://gate.whapi.cloud/messages/carousel \
     --header 'accept: application/json' \
     --header 'authorization: Bearer Your_Token' \
     --header 'content-type: application/json' \
     --data '
{
  "to": "[email protected]",
  "body": {
    "text": "Lecture slides for today's class \u2014 swipe to preview before we start."
  },
  "cards": [
    {
      "id": "slide-1",
      "text": "Slide 1 \u2014 Introduction",
      "media": {
        "media": "https://cdn.example.com/courses/cs101/slides/slide-01.jpg"
      },
      "buttons": [
        {
          "type": "quick_reply",
          "title": "Next",
          "id": "next-1"
        }
      ]
    },
    {
      "id": "slide-2",
      "text": "Slide 2 \u2014 Key concepts",
      "media": {
        "media": "https://cdn.example.com/courses/cs101/slides/slide-02.jpg"
      },
      "buttons": [
        {
          "type": "quick_reply",
          "title": "Next",
          "id": "next-2"
        }
      ]
    },
    {
      "id": "slide-3",
      "text": "Slide 3 \u2014 Summary",
      "media": {
        "media": "https://cdn.example.com/courses/cs101/slides/slide-03.jpg"
      },
      "buttons": [
        {
          "type": "url",
          "title": "Open LMS",
          "id": "lms-1",
          "url": "https://lms.example.com/cs101"
        }
      ]
    }
  ]
}
'

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://gate.whapi.cloud/messages/carousel",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "{\"to\":\"[email protected]\",\"body\":{\"text\":\"Lecture slides for today's class \\u2014 swipe to preview before we start.\"},\"cards\":[{\"id\":\"slide-1\",\"text\":\"Slide 1 \\u2014 Introduction\",\"media\":{\"media\":\"https://cdn.example.com/courses/cs101/slides/slide-01.jpg\"},\"buttons\":[{\"type\":\"quick_reply\",\"title\":\"Next\",\"id\":\"next-1\"}]},{\"id\":\"slide-2\",\"text\":\"Slide 2 \\u2014 Key concepts\",\"media\":{\"media\":\"https://cdn.example.com/courses/cs101/slides/slide-02.jpg\"},\"buttons\":[{\"type\":\"quick_reply\",\"title\":\"Next\",\"id\":\"next-2\"}]},{\"id\":\"slide-3\",\"text\":\"Slide 3 \\u2014 Summary\",\"media\":{\"media\":\"https://cdn.example.com/courses/cs101/slides/slide-03.jpg\"},\"buttons\":[{\"type\":\"url\",\"title\":\"Open LMS\",\"id\":\"lms-1\",\"url\":\"https://lms.example.com/cs101\"}]}]}",
  CURLOPT_HTTPHEADER => [
    "accept: application/json",
    "authorization: Bearer Your_Token",
    "content-type: application/json"
  ],
]);

$response = curl_exec($curl);
curl_close($curl);
echo $response;

import requests

url = "https://gate.whapi.cloud/messages/carousel"
payload = {
    "to": "[email protected]",
    "body": {
        "text": "Lecture slides for today's class \u2014 swipe to preview before we start."
    },
    "cards": [
        {
            "id": "slide-1",
            "text": "Slide 1 \u2014 Introduction",
            "media": {
                "media": "https://cdn.example.com/courses/cs101/slides/slide-01.jpg"
            },
            "buttons": [
                {
                    "type": "quick_reply",
                    "title": "Next",
                    "id": "next-1"
                }
            ]
        },
        {
            "id": "slide-2",
            "text": "Slide 2 \u2014 Key concepts",
            "media": {
                "media": "https://cdn.example.com/courses/cs101/slides/slide-02.jpg"
            },
            "buttons": [
                {
                    "type": "quick_reply",
                    "title": "Next",
                    "id": "next-2"
                }
            ]
        },
        {
            "id": "slide-3",
            "text": "Slide 3 \u2014 Summary",
            "media": {
                "media": "https://cdn.example.com/courses/cs101/slides/slide-03.jpg"
            },
            "buttons": [
                {
                    "type": "url",
                    "title": "Open LMS",
                    "id": "lms-1",
                    "url": "https://lms.example.com/cs101"
                }
            ]
        }
    ]
}
headers = {
    "accept": "application/json",
    "authorization": "Bearer Your_Token",
    "content-type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

const response = await fetch('https://gate.whapi.cloud/messages/carousel', {
  method: 'POST',
  headers: {
    accept: 'application/json',
    authorization: 'Bearer Your_Token',
    'content-type': 'application/json',
  },
  body: JSON.stringify({
    "to": "[email protected]",
    "body": {
      "text": "Lecture slides for today's class \u2014 swipe to preview before we start."
    },
    "cards": [
      {
        "id": "slide-1",
        "text": "Slide 1 \u2014 Introduction",
        "media": {
          "media": "https://cdn.example.com/courses/cs101/slides/slide-01.jpg"
        },
        "buttons": [
          {
            "type": "quick_reply",
            "title": "Next",
            "id": "next-1"
          }
        ]
      },
      {
        "id": "slide-2",
        "text": "Slide 2 \u2014 Key concepts",
        "media": {
          "media": "https://cdn.example.com/courses/cs101/slides/slide-02.jpg"
        },
        "buttons": [
          {
            "type": "quick_reply",
            "title": "Next",
            "id": "next-2"
          }
        ]
      },
      {
        "id": "slide-3",
        "text": "Slide 3 \u2014 Summary",
        "media": {
          "media": "https://cdn.example.com/courses/cs101/slides/slide-03.jpg"
        },
        "buttons": [
          {
            "type": "url",
            "title": "Open LMS",
            "id": "lms-1",
            "url": "https://lms.example.com/cs101"
          }
        ]
      }
    ]
  }),
});

console.log(await response.text());

OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"to\":\"[email protected]\",\"body\":{\"text\":\"Lecture slides for today's class \\u2014 swipe to preview before we start.\"},\"cards\":[{\"id\":\"slide-1\",\"text\":\"Slide 1 \\u2014 Introduction\",\"media\":{\"media\":\"https://cdn.example.com/courses/cs101/slides/slide-01.jpg\"},\"buttons\":[{\"type\":\"quick_reply\",\"title\":\"Next\",\"id\":\"next-1\"}]},{\"id\":\"slide-2\",\"text\":\"Slide 2 \\u2014 Key concepts\",\"media\":{\"media\":\"https://cdn.example.com/courses/cs101/slides/slide-02.jpg\"},\"buttons\":[{\"type\":\"quick_reply\",\"title\":\"Next\",\"id\":\"next-2\"}]},{\"id\":\"slide-3\",\"text\":\"Slide 3 \\u2014 Summary\",\"media\":{\"media\":\"https://cdn.example.com/courses/cs101/slides/slide-03.jpg\"},\"buttons\":[{\"type\":\"url\",\"title\":\"Open LMS\",\"id\":\"lms-1\",\"url\":\"https://lms.example.com/cs101\"}]}]}");
Request request = new Request.Builder()
  .url("https://gate.whapi.cloud/messages/carousel")
  .post(body)
  .addHeader("accept", "application/json")
  .addHeader("authorization", "Bearer Your_Token")
  .addHeader("content-type", "application/json")
  .build();

Response response = client.newCall(request).execute();

using RestSharp;

var options = new RestClientOptions("https://gate.whapi.cloud/messages/carousel");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("accept", "application/json");
request.AddHeader("authorization", "Bearer Your_Token");
request.AddHeader("content-type", "application/json");
request.AddJsonBody({"to":"[email protected]","body":{"text":"Lecture slides for today's class \u2014 swipe to preview before we start."},"cards":[{"id":"slide-1","text":"Slide 1 \u2014 Introduction","media":{"media":"https://cdn.example.com/courses/cs101/slides/slide-01.jpg"},"buttons":[{"type":"quick_reply","title":"Next","id":"next-1"}]},{"id":"slide-2","text":"Slide 2 \u2014 Key concepts","media":{"media":"https://cdn.example.com/courses/cs101/slides/slide-02.jpg"},"buttons":[{"type":"quick_reply","title":"Next","id":"next-2"}]},{"id":"slide-3","text":"Slide 3 \u2014 Summary","media":{"media":"https://cdn.example.com/courses/cs101/slides/slide-03.jpg"},"buttons":[{"type":"url","title":"Open LMS","id":"lms-1","url":"https://lms.example.com/cs101"}]}]});
var response = await client.PostAsync(request);

Console.WriteLine("{0}", response.Content);

package main

import (
	"bytes"
	"fmt"
	"io"
	"net/http"
)

func main() {
	body := []byte(`{"to":"[email protected]","body":{"text":"Lecture slides for today's class \u2014 swipe to preview before we start."},"cards":[{"id":"slide-1","text":"Slide 1 \u2014 Introduction","media":{"media":"https://cdn.example.com/courses/cs101/slides/slide-01.jpg"},"buttons":[{"type":"quick_reply","title":"Next","id":"next-1"}]},{"id":"slide-2","text":"Slide 2 \u2014 Key concepts","media":{"media":"https://cdn.example.com/courses/cs101/slides/slide-02.jpg"},"buttons":[{"type":"quick_reply","title":"Next","id":"next-2"}]},{"id":"slide-3","text":"Slide 3 \u2014 Summary","media":{"media":"https://cdn.example.com/courses/cs101/slides/slide-03.jpg"},"buttons":[{"type":"url","title":"Open LMS","id":"lms-1","url":"https://lms.example.com/cs101"}]}]}`)
	req, _ := http.NewRequest("POST", "https://gate.whapi.cloud/messages/carousel", bytes.NewReader(body))
	req.Header.Set("accept", "application/json")
	req.Header.Set("authorization", "Bearer Your_Token")
	req.Header.Set("content-type", "application/json")

	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()
	out, _ := io.ReadAll(res.Body)
	fmt.Println(string(out))
}

Get API KEY for free

Доставка

Когда карусель доехала

Успешный ответ отправки не значит, что студенты уже получили карусель. Первый статус до webhook — pending. Дальнейшие изменения приходят только на statuses.post и statuses.put. Если статус остаётся pending и не переходит в sent, delivered или более поздний ack, сообщение не доставлено. Проверьте payload и право аккаунта на такой тип отправки.

Ответ sendMessageCarousel не доказывает, что студенты видят слайды.
pending, который не меняется, значит карусель не доставлен.
Следите за statuses.post и statuses.put для последующих ack.
Включите webhooks, если worker должен повторять при незавершённой доставке.

Что читать про доставку и webhooks

Как выглядит webhook delivered: Смотреть callback
Какие события уходят на webhook: Список событий
Как настроить webhook на канале: Открыть руководство
Где взять URL webhook: Открыть руководство
Примеры payload webhook: Смотреть форматы

Свяжитесь с поддержкой, если что-то пошло не так

Если что-то ломается

Обрабатывайте сбои на каждом шаге

Если JID группы неверный, нет URL слайдов, отправка карусели отклонена или не доставлена, или поддержка карусели временно недоступна — исправьте цель или ресурсы, повторите или используйте запасной путь и не считайте отправку перед занятием завершённой.

Планировщик сработал, но отправка не удалась?

JID может быть неверным, URL могут отсутствовать, или sendMessageCarousel отклонён или не доставлен после готовности карточек. Повторите worker, используйте запасную отправку изображения или документа при сбое карусели и не считайте отправку завершённой. Если после повтора всё ещё ошибка — свяжитесь с поддержкой Whapi с id канала и ответом с ошибкой.

Свяжитесь с поддержкой, если что-то пошло не так

Диагностика по шагам API

Статус	Что значит	Что делать
`400`	Wrong request parameters	Неверные параметры — проверьте `to`, `cards` и поля тела карусели.
`401`	Need channel authorization for send message
`402`	Trial version limit exceeded
`403`	It is forbidden to send to this group/recipient	Запрещено отправлять в эту группу — проверьте JID группы и права канала.
`404`	Media with specified id not found	Media не найдена — убедитесь, что каждый URL или id карточки доступен до отправки.
`413`	Request media too large
`415`	Unsupported media type
`429`	Too many requests
`500`	Internal Error

Частые вопросы

Вопросы интеграторов

Нет. Этот поток публикует JPEG одним каруселем незадолго до запланированного занятия. Разовая отправка файла по другому событию использует документ и другой триггер.

Нет. Этот поток для студентов в группе курса перед одним занятием. Еженедельные отчёты по классу или преподавателю — отдельный сценарий.

Если JID неверный, нет URL, отправка отклонена или не доставлена, или карусель недоступен — исправьте цель или ресурсы, повторите или используйте запасной путь и не считайте отправку завершённой.

На вашем backend. Шаг Whapi в каталоге — только sendMessageCarousel. Планирование, экспорт LMS и публичные HTTPS URL для JPEG остаются в own_backend.

Нет. Вы собираете тело карусели из URL слайдов и отправляете через sendMessageCarousel. Доступность каруселя и кнопок может меняться с обновлениями WhatsApp; запланируйте запасной путь, если поддержка недоступна.

Get started with the API

Поддерживаемые функции WhatsApp

Всё, что нужно для создания автоматизации WhatsApp

Whapi.Cloud предоставляет доступ к полному набору функций WhatsApp — сообщениям, медиа, группам, каналам, вебхукам и не только. Создавайте ботов, автоматизации и интеграции без функциональных ограничений.

Выбор разработчиков

Нам доверяют 3 300+ разработчиков и SaaS-команд

Разработчики по всему миру используют Whapi.Cloud для создания автоматизаций, ботов, CRM-интеграций, массовых рассылок и продвинутых WhatsApp-воркфлоу. Наша инфраструктура обрабатывает миллионы API-запросов с высокой стабильностью — и этот показатель растёт каждый месяц.

5,5K+

активных API-каналов

21M+

API-запросов в месяц

Начать бесплатный доступ Все отзывы

«Всё просто, интуитивно и легко. Документация понятная, и вся нужная информация всегда под рукой. Отличная работа.»

Roberto K. / Web-разработчик

«Мы подключили WhatsApp к нашим процессам через n8n всего за несколько минут. Без кода, без сложностей — всё заработало с первого раза.»

Martin P. / Разработчик

«Whapi.Cloud стал важной частью нашей коммуникации с клиентами. Мы автоматизировали обновления по продуктам, уведомления о заказах и поддержку — без шаблонов и модерации.»

Oscar T. / CTO

Смежные материалы

Материалы рядом с этим потоком

Обзор WhatsApp Groups API

Интеграция WhatsApp с n8n

Отправка view-once сообщений

Автоматизация групп WhatsApp

Отправка сообщения с кнопками

Подключение WhatsApp к Make.com

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

Студенты смотрят слайды в чате

Опубликуйте карусель в группе

Перед запуском потока

Один вызов отправляет карусель

Отправьте карусель слайдов в группу курса

Когда карусель доехала

Что читать про доставку и webhooks

Обрабатывайте сбои на каждом шаге

Диагностика по шагам API

Отправьте карусель слайдов в группу курса sendMessageCarousel · POST /messages/carousel

Вопросы интеграторов

Это то же самое, что отправить файл в группу по бизнес-событию?

Это еженедельный визуальный отчёт загрузок в LMS?

Что если студенты так и не видят карусель?

Где готовятся изображения слайдов?

Нужен ли заранее одобренный шаблон сообщения для слайдов?

Всё, что нужно для создания автоматизации WhatsApp

API каналов WhatsApp

Группы и сообщества WhatsApp

Без шаблонов и модерации

Webhooks в реальном времени

Все типы медиа и сообщений

Автоматизация заказов и товаров

Проверка номеров WhatsApp

Поддержка low-code и no-code

API статусов WhatsApp

Статусы доставки и прочтения

Мульти-девайс подключение

Интерактивные сообщения и кнопки

Нам доверяют 3 300+ разработчиков и SaaS-команд

5,5K+

21M+

«Всё просто, интуитивно и легко. Документация понятная, и вся нужная информация всегда под рукой. Отличная работа.»

«Мы подключили WhatsApp к нашим процессам через n8n всего за несколько минут. Без кода, без сложностей — всё заработало с первого раза.»

Материалы рядом с этим потоком