Carrusel de diapositivas antes de clase en un grupo de WhatsApp con la API de WhatsApp

Q: ¿Donde se preparan las imagenes de diapositivas?

En tu backend. El paso Whapi del catalogo es solo sendMessageCarousel. Programacion, exportacion LMS y URLs HTTPS publicas para JPEG quedan en own_backend.

Caso de uso

Cuando usar este flujo

El disparador es poco antes de una clase programada

Usa este flujo cuando un job programado se ejecuta poco antes de que empiece la sesion, no cuando un evento de negocio no relacionado genera un archivo puntual.

El destino es un grupo del curso existente

Usa este flujo cuando cada curso ya tiene un JID de grupo de WhatsApp y los estudiantes deben previsualizar diapositivas dentro de ese chat.

Las diapositivas salen como tarjetas de imagen deslizables

Usa este flujo cuando JPEG exportados deben mostrarse como un carrusel deslizable, no como un documento unico ni un informe visual semanal del LMS.

Chat de grupo de WhatsApp en un movil con un carrusel deslizable de diapositivas publicado poco antes de la clase.

Experiencia del cliente

Los estudiantes previsualizan diapositivas en el chat

Las presentaciones siguen en el LMS o en el equipo del profesor hasta que alguien publica manualmente en el grupo, asi que a menudo los estudiantes abren el chat sin una vista previa deslizable en el movil.

Tras el flujo, los estudiantes abren el grupo del curso y deslizan las diapositivas como carrusel antes de que empiece la clase. Los integradores construyen este resultado con la API de WhatsApp.

Flujo de trabajo

Publica el carrusel en el grupo

Se ejecuta el programador pre-clase

Tu programador se dispara poco antes de la sesion. Un worker lee LMS o calendario, resuelve el JID del grupo del curso y crea tarjetas del carrusel desde URLs HTTPS publicas de cada JPEG.

Envia el carrusel de diapositivas al grupo del curso

POST /messages/carousel

sendMessageCarousel entrega el mazo de tarjetas al grupo del curso. Pon el JID del grupo en to y la lista de tarjetas en cards.

Ver ejemplos de codigo

¿Necesitas seguimiento de entrega? Una respuesta API exitosa no significa que los estudiantes ya vean cada tarjeta. Mas sobre estado de entrega →

Requisitos previos

Antes de ejecutar el flujo

Conecta el numero de WhatsApp que publica en grupos del curso y autentica cada peticion con el token API de ese numero. La programacion, exportacion de diapositivas y cuerpo del carrusel quedan en tu backend.

1.Crea una cuenta Whapi.Cloud: Registrarse
2.Conecta tu cuenta de WhatsApp: Abrir la guia
3.Encuentra tu token API: Abrir la seccion

Opcional — profundiza en este flujo

Automatizar grupos de WhatsApp: Abrir la guia
Enviar mensaje con botones: Abrir la guia
Vision general de envio de mensajes: Abrir la guia

Implementación de API

Una llamada envia el carrusel

Esta llamada es el envio pre-clase. Coloca el mazo de tarjetas compilado en el chat del grupo del curso para que los estudiantes deslicen antes de la sesion.

Obtén tu token API gratis al registrarte en whapi.cloud y usalo en el codigo en lugar de Your_Token de los ejemplos.

Envia el carrusel de diapositivas al grupo del curso

Envia el carrusel de diapositivas al grupo del curso mapeado para que los estudiantes previsualicen en el movil antes de la clase.

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

Entrega

Saber cuando llego el carrusel

Una respuesta de envio exitosa no significa que los estudiantes ya recibieron el carrusel. El primer estado visible antes de un webhook es pending. Cambios posteriores llegan solo en statuses.post y statuses.put. Si el estado se queda en pending sin pasar a sent, delivered u otro ack, el mensaje no se entrego. Revisa el payload y los permisos de la cuenta.

Una respuesta de sendMessageCarousel no prueba que los estudiantes vean las diapositivas.
pending que no avanza significa que el carrusel no se entrego.
Observa statuses.post y statuses.put para acks posteriores.
Activa webhooks si tu worker debe reintentar cuando la entrega no termina.

Que leer sobre entrega y webhooks

Como se ve un webhook delivered: Ver callback
Que eventos enviamos al webhook: Ver eventos rastreados
Como configurar webhook en un canal: Abrir guia
Donde obtener la URL del webhook: Abrir guia
Ejemplos de payload de webhook: Ver formatos

Contacta soporte si algo salio mal

Cuando algo falla

Gestiona fallos en cada paso

Si el JID del grupo es incorrecto, faltan URLs de diapositivas, el envio del carrusel se rechaza o no se entrega, o el soporte de carrusel no esta disponible, corrige destino o activos, reintenta o haz fallback y no des por hecho el envio pre-clase.

¿El programador corrio pero fallo el envio?

El JID puede ser incorrecto, faltan URLs o sendMessageCarousel puede rechazarse o no entregarse tras preparar las tarjetas. Reintenta el worker, haz fallback a imagen o documento si falla el carrusel y no des por hecho el envio pre-clase. Si sigue fallando, contacta soporte Whapi con el id del canal y la respuesta fallida.

Contacta soporte si algo salio mal

Depurar por paso API

Estado	Que significa	Que hacer
`400`	Wrong request parameters	Parametros incorrectos — revisa `to`, `cards` y campos del cuerpo del carrusel.
`401`	Need channel authorization for send message
`402`	Trial version limit exceeded
`403`	It is forbidden to send to this group/recipient	Prohibido enviar a este grupo — confirma JID del grupo y permisos del canal.
`404`	Media with specified id not found	Media no encontrada — confirma que cada URL o id de tarjeta resuelve antes del envio.
`413`	Request media too large
`415`	Unsupported media type
`429`	Too many requests
`500`	Internal Error

Preguntas frecuentes

Preguntas de integradores

No. Este flujo publica JPEG como un carrusel poco antes de una clase programada. Un archivo generico en otro evento usa envio de documento y otro disparador.

No. Este flujo apunta a estudiantes en un grupo del curso antes de una clase. Informes semanales por clase o profesor son otro escenario.

Si el JID es incorrecto, faltan URLs, el envio se rechaza o no se entrega, o el carrusel no esta disponible, corrige destino o activos, reintenta o haz fallback y no des por hecho el envio pre-clase.

En tu backend. El paso Whapi del catalogo es solo sendMessageCarousel. Programacion, exportacion LMS y URLs HTTPS publicas para JPEG quedan en own_backend.

No. Construyes el cuerpo del carrusel desde tus URLs y envias con sendMessageCarousel. La disponibilidad de carrusel y botones puede cambiar con actualizaciones de WhatsApp; planifica un fallback si no esta disponible.

Get started with the API

Funciones compatibles de WhatsApp

Todo lo que necesitas para crear automatizaciones en WhatsApp

Whapi.Cloud te da acceso a un conjunto completo de funciones de WhatsApp — mensajería, multimedia, grupos, canales, webhooks y más. Crea bots, automatizaciones e integraciones sin limitaciones de funciones.

Elegido por desarrolladores

Confiado por más de 3.300 desarrolladores y equipos SaaS

Desarrolladores de todo el mundo confían en Whapi.Cloud para crear automatizaciones, bots, integraciones con CRM, herramientas de mensajería masiva y flujos avanzados de WhatsApp. Nuestra infraestructura procesa millones de solicitudes API con alta estabilidad, y este número crece cada mes.

5,5K+

canales API activos

21M+

solicitudes API al mes

Comenzar prueba gratuita Ver todas las reseñas

“Todo es simple, intuitivo y fácil de usar. La documentación es clara y toda la información está justo donde la necesito. Excelente trabajo.”

Roberto K. / Desarrollador Web

“Conectamos WhatsApp a nuestros flujos en n8n en solo unos minutos. Sin código, sin complicaciones — todo funcionó a la primera.”

Martin P. / Desarrollador

“Whapi.Cloud se convirtió en una parte clave de nuestra comunicación con clientes. Automatizamos actualizaciones de productos, notificaciones de pedidos y mensajes de soporte — sin plantillas ni aprobaciones de Meta.”

Oscar T. / CTO

Relacionado

Guias junto a este flujo

Vision general API de grupos WhatsApp

Integrar WhatsApp con n8n

Enviar mensajes view-once

Automatizar grupos de WhatsApp

Enviar mensaje con botones

Conectar WhatsApp a Make.com

Cuando usar este flujo

Los estudiantes previsualizan diapositivas en el chat

Publica el carrusel en el grupo

Antes de ejecutar el flujo

Una llamada envia el carrusel

Envia el carrusel de diapositivas al grupo del curso

Saber cuando llego el carrusel

Que leer sobre entrega y webhooks

Gestiona fallos en cada paso

Depurar por paso API

Envia el carrusel de diapositivas al grupo del curso sendMessageCarousel · POST /messages/carousel

Preguntas de integradores

¿Es lo mismo que enviar un archivo a un grupo por un evento de negocio?

¿Es el informe visual semanal de subidas al LMS?

¿Y si los estudiantes nunca ven el carrusel?

¿Donde se preparan las imagenes de diapositivas?

¿Necesito una plantilla de mensaje preaprobada para las diapositivas?

Todo lo que necesitas para crear automatizaciones en WhatsApp

API de Canales de WhatsApp

Grupos y Comunidades de WhatsApp

Sin plantillas ni aprobaciones

Webhooks en tiempo real

Todos los tipos de medios y mensajes

Automatización de pedidos y productos

Validación de números de WhatsApp

Compatible con low-code y no-code

API de Estados de WhatsApp

Estado de entrega y lectura

Conexión multidispositivo

Mensajes interactivos y botones

Confiado por más de 3.300 desarrolladores y equipos SaaS

5,5K+

21M+

“Todo es simple, intuitivo y fácil de usar. La documentación es clara y toda la información está justo donde la necesito. Excelente trabajo.”

“Conectamos WhatsApp a nuestros flujos en n8n en solo unos minutos. Sin código, sin complicaciones — todo funcionó a la primera.”

“Whapi.Cloud se convirtió en una parte clave de nuestra comunicación con clientes. Automatizamos actualizaciones de productos, notificaciones de pedidos y mensajes de soporte — sin plantillas ni aprobaciones de Meta.”

Guias junto a este flujo