Carrossel de slides antes da aula em grupo WhatsApp com a WhatsApp API

Q: Onde as imagens dos slides são preparadas?

No seu backend. O passo Whapi do catálogo é só sendMessageCarousel. Agendamento, exportação LMS e URLs HTTPS públicas para JPEGs ficam em own_backend.

Cenário de uso

Quando usar este fluxo

O gatilho é pouco antes de uma aula agendada

Use este fluxo quando um job agendado dispara pouco antes da sessão, não quando um evento de negócio não relacionado gera um arquivo pontual.

O destino é um grupo do curso existente

Use este fluxo quando cada curso já tem um JID de grupo WhatsApp e os alunos devem pré-visualizar slides dentro desse chat.

Os slides saem como cartões de imagem deslizáveis

Use este fluxo quando JPEGs exportados devem aparecer como um carrossel deslizável, não como anexo único ou relatório visual semanal do LMS.

Chat de grupo WhatsApp no celular com carrossel deslizável de slides publicado pouco antes da aula.

Experiência do cliente

Alunos pré-visualizam slides no chat

Os decks ficam no LMS ou no computador do professor até alguém postar manualmente no grupo, então muitos alunos abrem o chat sem prévia deslizável no celular.

Depois do fluxo, os alunos abrem o grupo do curso e deslizam os slides como carrossel antes da aula. Integradores constroem esse resultado com a WhatsApp API.

Fluxo de trabalho

Publique o carrossel no grupo

O agendador pré-aula executa

Seu agendador dispara pouco antes da sessão. Um worker lê LMS ou calendário, resolve o JID do grupo do curso e monta cartões do carrossel a partir de URLs HTTPS públicas de cada JPEG.

Envie o carrossel de slides ao grupo do curso

POST /messages/carousel

sendMessageCarousel entrega a pilha de cartões ao grupo do curso. Coloque o JID do grupo em to e a lista de cartões em cards.

Ver exemplos de código

Precisa rastrear entrega? Uma resposta de API bem-sucedida não significa que os alunos já veem cada cartão. Saiba sobre status de entrega →

Pré-requisitos

Antes de executar o fluxo

Conecte o número WhatsApp que publica nos grupos do curso e autentique cada requisição com o token API desse número. Agendamento, exportação de slides e corpo do carrossel ficam no seu backend.

1.Crie uma conta Whapi.Cloud: Cadastrar-se
2.Conecte sua conta WhatsApp: Abrir o guia
3.Encontre seu token API: Abrir a seção

Opcional — aprofunde neste fluxo

Automatizar grupos WhatsApp: Abrir o guia
Enviar mensagem com botões: Abrir o guia
Visão geral de envio de mensagens: Abrir o guia

Implementação da API

Uma chamada envia o carrossel

Esta chamada é a entrega pré-aula. Ela coloca a pilha de cartões compilada no chat do grupo do curso para os alunos deslizarem antes da sessão.

Obtenha seu token API grátis ao se registrar em whapi.cloud e use esse token no código em vez de Your_Token dos exemplos.

Envie o carrossel de slides ao grupo do curso

Envie o carrossel de slides ao grupo mapeado para os alunos pré-visualizarem no celular antes da aula.

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

Envio

Saiba quando o carrossel chegou

Uma resposta de envio bem-sucedida não significa que os alunos já receberam o carrossel. O primeiro status visível antes de um webhook é pending. Mudanças posteriores chegam só em statuses.post e statuses.put. Se o status permanecer pending sem ir para sent, delivered ou ack posterior, a mensagem não foi entregue. Verifique o payload e a permissão da conta.

Uma resposta de sendMessageCarousel não prova que os alunos veem os slides.
pending que não avança significa que o carrossel não foi entregue.
Observe statuses.post e statuses.put para acks posteriores.
Ative webhooks se seu worker deve tentar de novo quando a entrega não concluir.

O que ler sobre entrega e webhooks

Como é um webhook delivered: Ver o callback
Quais eventos enviamos ao webhook: Consultar eventos monitorados
Como configurar webhook no canal: Abrir o guia
Onde obter a URL do webhook: Abrir o guia
Exemplos de payload de webhook: Ver os formatos

Fale com nosso suporte se algo deu errado

Quando algo falha

Trate falhas em cada etapa

Se o JID do grupo estiver errado, URLs de slides faltarem, o envio do carrossel for rejeitado ou não entregue, ou o suporte a carrossel estiver indisponível, corrija destino ou assets, tente de novo ou faça fallback e não considere a entrega pré-aula concluída.

Agendador rodou, mas a entrega falhou?

O JID pode estar errado, URLs podem faltar ou sendMessageCarousel pode ser rejeitado ou não entregue após os cartões prontos. Reexecute o worker, faça fallback para imagem ou documento se o carrossel falhar e não considere a entrega pré-aula concluída. Se ainda falhar, contate o suporte Whapi com o id do canal e a resposta com falha.

Fale com nosso suporte se algo deu errado

Depurar por etapa da API

Situação	O que significa	O que fazer
`400`	Wrong request parameters	Parâmetros incorretos — verifique `to`, `cards` e campos do corpo do carrossel.
`401`	Need channel authorization for send message
`402`	Trial version limit exceeded
`403`	It is forbidden to send to this group/recipient	Proibido enviar a este grupo — confirme JID do grupo e permissões do canal.
`404`	Media with specified id not found	Mídia não encontrada — confirme que cada URL ou id de cartão resolve antes do envio.
`413`	Request media too large
`415`	Unsupported media type
`429`	Too many requests
`500`	Internal Error

Perguntas frequentes

Perguntas de integradores

Não. Este fluxo publica JPEGs como um carrossel pouco antes de uma aula agendada. Um arquivo genérico em outro evento usa envio de documento e outro gatilho.

Não. Este fluxo mira alunos em um grupo do curso antes de uma aula. Relatórios semanais por turma ou professor são outro cenário.

Se o JID estiver errado, URLs faltarem, o envio for rejeitado ou não entregue, ou o carrossel estiver indisponível, corrija destino ou assets, tente de novo ou faça fallback e não considere a entrega pré-aula concluída.

No seu backend. O passo Whapi do catálogo é só sendMessageCarousel. Agendamento, exportação LMS e URLs HTTPS públicas para JPEGs ficam em own_backend.

Não. Você monta o corpo do carrossel a partir das URLs dos slides e envia com sendMessageCarousel. Disponibilidade de carrossel e botões pode mudar com atualizações do WhatsApp; planeje um fallback se o suporte estiver indisponível.

Get started with the API

Recursos compatíveis do WhatsApp

Tudo o que você precisa para criar automações no WhatsApp

O Whapi.Cloud oferece acesso a um conjunto completo de recursos do WhatsApp — mensagens, mídia, grupos, canais, webhooks e muito mais. Crie bots, automações e integrações sem limitações de funcionalidades.

Escolhido por desenvolvedores

Confiado por mais de 3.300 desenvolvedores e equipes SaaS

Desenvolvedores no mundo inteiro utilizam o Whapi.Cloud para criar automações, bots, integrações com CRM, ferramentas de envio em massa e fluxos avançados de WhatsApp. Nossa infraestrutura processa milhões de requisições API com alta estabilidade — e esse número cresce a cada mês.

5,5K+

canais de API ativos

21M+

requisições API por mês

Iniciar teste gratuito Ver todas as avaliações

“Tudo é simples, intuitivo e fácil de navegar. A documentação é clara e todas as informações estão bem à mão. Trabalho excelente.”

Roberto K. / Desenvolvedor Web

“Conectamos o WhatsApp aos nossos fluxos usando o n8n em apenas alguns minutos. Sem código, sem complicações — funcionou de primeira.”

Martin P. / Desenvolvedor

“O Whapi.Cloud se tornou uma parte essencial da nossa comunicação com clientes. Automatizamos atualizações de produtos, notificações de pedidos e mensagens de suporte — tudo sem templates nem aprovações da Meta.”

Oscar T. / CTO

Relacionados

Guias ao lado deste fluxo

Visão geral da API de grupos WhatsApp

Integrar WhatsApp com n8n

Enviar mensagens view-once

Automatizar grupos WhatsApp

Enviar mensagem com botões

Conectar WhatsApp ao Make.com

Quando usar este fluxo

Alunos pré-visualizam slides no chat

Publique o carrossel no grupo

Antes de executar o fluxo

Uma chamada envia o carrossel

Envie o carrossel de slides ao grupo do curso

Saiba quando o carrossel chegou

O que ler sobre entrega e webhooks

Trate falhas em cada etapa

Depurar por etapa da API

Envie o carrossel de slides ao grupo do curso sendMessageCarousel · POST /messages/carousel

Perguntas de integradores

É o mesmo que enviar arquivo a um grupo por evento de negócio?

É o relatório visual semanal de uploads no LMS?

E se os alunos nunca virem o carrossel?

Onde as imagens dos slides são preparadas?

Preciso de modelo de mensagem pré-aprovado para os slides?

Tudo o que você precisa para criar automações no WhatsApp

API de Canais do WhatsApp

Grupos e Comunidades do WhatsApp

Sem templates ou aprovações

Webhooks em tempo real

Todos os tipos de mídia e mensagens

Automação de pedidos e produtos

Validação de números do WhatsApp

Compatível com low-code e no-code

API de Status do WhatsApp

Status de entrega e leitura

Conexão multidispositivo

Mensagens interativas e botões

Confiado por mais de 3.300 desenvolvedores e equipes SaaS

5,5K+

21M+

“Tudo é simples, intuitivo e fácil de navegar. A documentação é clara e todas as informações estão bem à mão. Trabalho excelente.”

“Conectamos o WhatsApp aos nossos fluxos usando o n8n em apenas alguns minutos. Sem código, sem complicações — funcionou de primeira.”

“O Whapi.Cloud se tornou uma parte essencial da nossa comunicação com clientes. Automatizamos atualizações de produtos, notificações de pedidos e mensagens de suporte — tudo sem templates nem aprovações da Meta.”

Guias ao lado deste fluxo