Carusel de slide-uri înainte de curs într-un grup WhatsApp cu WhatsApp API

Q: Unde se pregătesc imaginile slide-urilor?

Pe backend-ul tău. Pasul Whapi din catalog este doar sendMessageCarousel. Programarea, exportul LMS și URL-urile HTTPS publice pentru JPEG rămân în own_backend.

Caz de utilizare

Când să folosești acest flux

Declanșatorul este puțin înainte de o clasă programată

Folosește fluxul când un job programat pornește puțin înainte de sesiune, nu când un eveniment de business nelegat produce un fișier punctual.

Destinația este un grup de curs existent

Folosește fluxul când fiecare curs are deja un JID de grup WhatsApp și studenții trebuie să previzualizeze slide-urile în acel chat.

Slide-urile ies ca imagini glisabile

Folosește fluxul când JPEG-urile exportate trebuie să apară ca un carusel glisabil, nu ca un singur document sau raport vizual săptămânal LMS.

Chat de grup WhatsApp pe telefon cu carusel glisabil de slide-uri publicat puțin înainte de curs.

Experiența clientului

Studenții previzualizează slide-uri în chat

Prezentările rămân în LMS sau pe calculatorul profesorului până cineva postează manual în grup, așa că mulți studenți deschid chat-ul fără previzualizare glisabilă pe telefon.

După flux, studenții deschid grupul cursului și glisează slide-urile ca carusel înainte de curs. Integratorii construiesc acest rezultat cu WhatsApp API.

Flux de lucru

Publică caruselul în grup

Rulează planificatorul pre-curs

Planificatorul pornește puțin înainte de sesiune. Un worker citește LMS sau calendarul, rezolvă JID-ul grupului cursului și construiește carduri carusel din URL-uri HTTPS publice pentru fiecare JPEG.

Trimite caruselul de slide-uri în grupul cursului

POST /messages/carousel

sendMessageCarousel livrează stiva de carduri în grupul cursului. Pune JID-ul grupului în to și lista de carduri în cards.

Vezi exemple de cod

Ai nevoie de urmărirea livrării? Un răspuns API reușit nu înseamnă că studenții văd deja fiecare card. Despre statusul livrării →

Cerințe preliminare

Înainte să rulezi fluxul

Conectează numărul WhatsApp care postează în grupurile cursului și autentifică fiecare cerere cu tokenul API al acelui număr. Programarea, exportul de slide-uri și corpul caruselului rămân pe backend-ul tău.

1.Creează un cont Whapi.Cloud: Înregistrare
2.Conectează contul WhatsApp: Deschide ghidul
3.Găsește tokenul API: Deschide secțiunea

Opțional — aprofundează pentru acest flux

Automatizarea grupurilor WhatsApp: Deschide ghidul
Trimite mesaj cu butoane: Deschide ghidul
Prezentare generală trimitere mesaje: Deschide ghidul

Implementare API

Un apel trimite caruselul

Acest apel este livrarea pre-curs. Pune stiva de carduri compilată în chat-ul grupului cursului ca studenții să gliseze înainte de sesiune.

Obține tokenul API gratuit după înregistrare pe whapi.cloud și folosește-l în cod în loc de Your_Token din exemple.

Trimite caruselul de slide-uri în grupul cursului

Trimite caruselul de slide-uri în grupul mapat ca studenții să previzualizeze pe telefon înainte de curs.

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

Livrare

Știi când a sosit caruselul

Un răspuns de trimitere reușit nu înseamnă că studenții au primit deja caruselul. Primul status vizibil înainte de webhook este pending. Schimbările ulterioare vin doar pe statuses.post și statuses.put. Dacă statusul rămâne pending fără a trece la sent, delivered sau alt ack, mesajul nu a fost livrat. Verifică payload-ul și permisiunea contului.

Un răspuns de la sendMessageCarousel nu dovedește că studenții văd slide-urile.
pending care nu avansează înseamnă că caruselul nu a fost livrat.
Urmărește statuses.post și statuses.put pentru ack-uri ulterioare.
Activează webhook-urile dacă worker-ul trebuie să reîncerce când livrarea nu se finalizează.

Ce să citești despre livrare și webhook-uri

Cum arată un webhook delivered: Vezi callback-ul
Ce evenimente trimitem la webhook: Vezi evenimentele urmărite
Cum setezi webhook pe canal: Deschide ghidul
Unde obții URL-ul webhook: Deschide ghidul
Exemple payload webhook: Vezi formatele

Contactează suportul dacă ceva nu a mers bine

Când apare o problemă

Gestionează eșecurile la fiecare pas

Dacă JID-ul grupului este greșit, lipsesc URL-urile slide-urilor, trimiterea caruselului este respinsă sau nelivrată, sau suportul carusel este indisponibil, corectează ținta sau asset-urile, reîncearcă sau folosește fallback și nu considera livrarea pre-curs finalizată.

Planificatorul a rulat, dar livrarea a eșuat?

JID-ul poate fi greșit, URL-urile pot lipsi sau sendMessageCarousel poate fi respins sau nelivrat după ce cardurile sunt gata. Reîncearcă worker-ul, folosește fallback la imagine sau document dacă caruselul eșuează și nu considera livrarea pre-curs finalizată. Dacă tot eșuează, contactează suportul Whapi cu id-ul canalului și răspunsul eșuat.

Contactează suportul dacă ceva nu a mers bine

Depanare pe pas API

Stare	Ce înseamnă	Ce să faci
`400`	Wrong request parameters	Parametri greșiți — verifică `to`, `cards` și câmpurile corpului caruselului.
`401`	Need channel authorization for send message
`402`	Trial version limit exceeded
`403`	It is forbidden to send to this group/recipient	Interzis să trimiți la acest grup — confirmă JID-ul grupului și permisiunile canalului.
`404`	Media with specified id not found	Media negăsită — confirmă că fiecare URL sau id de card se rezolvă înainte de trimitere.
`413`	Request media too large
`415`	Unsupported media type
`429`	Too many requests
`500`	Internal Error

Întrebări frecvente

Întrebări de la integratori

Nu. Acest flux publică JPEG-uri ca un carusel puțin înainte de o clasă programată. Un fișier generic la alt eveniment folosește trimitere document și alt declanșator.

Nu. Acest flux vizează studenții dintr-un grup de curs înainte de o clasă. Rapoartele săptămânale pe clasă sau profesor sunt alt scenariu.

Dacă JID-ul este greșit, lipsesc URL-urile, trimiterea este respinsă sau nelivrată, sau caruselul este indisponibil, corectează ținta sau asset-urile, reîncearcă sau folosește fallback și nu considera livrarea pre-curs finalizată.

Pe backend-ul tău. Pasul Whapi din catalog este doar sendMessageCarousel. Programarea, exportul LMS și URL-urile HTTPS publice pentru JPEG rămân în own_backend.

Nu. Construiești corpul caruselului din URL-urile slide-urilor și trimiți cu sendMessageCarousel. Disponibilitatea caruselului și a butoanelor poate varia odată cu actualizările WhatsApp; planifică un fallback dacă suportul lipsește.

Get started with the API

Funcționalități WhatsApp suportate

Tot ce ai nevoie pentru a construi automatizări pe WhatsApp

Whapi.Cloud îți oferă acces la un set complet de funcționalități WhatsApp — mesaje, media, grupuri, canale, webhook-uri și altele. Construiește boți, automatizări și integrări fără limitări de funcții.

Ales de dezvoltatori

De încredere pentru peste 3.300 de dezvoltatori și echipe SaaS

Dezvoltatori din întreaga lume se bazează pe Whapi.Cloud pentru a crea automatizări, boți, integrări CRM, instrumente de mesagerie în masă și fluxuri avansate WhatsApp. Infrastructura noastră procesează milioane de cereri API cu o stabilitate ridicată — iar numărul crește în fiecare lună.

5,5K+

canale API active

21M+

cereri API pe lună

Începe perioada de test gratuit Citește toate recenziile

„Totul este simplu, intuitiv și ușor de folosit. Documentația este clară, iar toate informațiile necesare sunt la îndemână. Foarte bine făcut.”

Roberto K. / Web Developer

„Am conectat WhatsApp la fluxurile noastre în n8n în doar câteva minute. Fără cod, fără complicații — totul a funcționat din prima.”

Martin P. / Developer

„Whapi.Cloud a devenit o parte esențială a comunicării cu clienții. Am automatizat actualizări de produse, notificări de comenzi și mesaje de suport — fără șabloane sau aprobări Meta.”

Oscar T. / CTO

Asociate

Ghiduri lângă acest flux

Prezentare API grupuri WhatsApp

Integrează WhatsApp cu n8n

Trimitere mesaje view-once

Automatizarea grupurilor WhatsApp

Trimite mesaj cu butoane

Conectează WhatsApp la Make.com

Când să folosești acest flux

Studenții previzualizează slide-uri în chat

Publică caruselul în grup

Înainte să rulezi fluxul

Un apel trimite caruselul

Trimite caruselul de slide-uri în grupul cursului

Știi când a sosit caruselul

Ce să citești despre livrare și webhook-uri

Gestionează eșecurile la fiecare pas

Depanare pe pas API

Trimite caruselul de slide-uri în grupul cursului sendMessageCarousel · POST /messages/carousel

Întrebări de la integratori

E același lucru cu trimiterea unui fișier la grup la un eveniment de business?

E raportul vizual săptămânal de upload LMS?

Ce fac dacă studenții nu văd caruselul?

Unde se pregătesc imaginile slide-urilor?

Am nevoie de șablon de mesaj preaprobat pentru slide-uri?

Tot ce ai nevoie pentru a construi automatizări pe WhatsApp

API pentru Canale WhatsApp

Grupuri și Comunități WhatsApp

Fără șabloane sau aprobări

Webhooks în timp real

Toate tipurile de media și mesaje

Automatizarea comenzilor și produselor

Validare numere WhatsApp

Compatibil low-code și no-code

API pentru Statusuri WhatsApp

Status livrare și citire

Conectare multi-dispozitiv

Mesaje interactive și butoane

De încredere pentru peste 3.300 de dezvoltatori și echipe SaaS

5,5K+

21M+

„Totul este simplu, intuitiv și ușor de folosit. Documentația este clară, iar toate informațiile necesare sunt la îndemână. Foarte bine făcut.”

„Am conectat WhatsApp la fluxurile noastre în n8n în doar câteva minute. Fără cod, fără complicații — totul a funcționat din prima.”

„Whapi.Cloud a devenit o parte esențială a comunicării cu clienții. Am automatizat actualizări de produse, notificări de comenzi și mesaje de suport — fără șabloane sau aprobări Meta.”

Ghiduri lângă acest flux