saas de educação
WhatsApp para edtech: a turma nasce no WhatsApp no momento da matrícula
Use WhatsApp na sua edtech para criar o grupo da turma quando a matrícula é confirmada, aprovar a entrada só de quem é aluno, mandar material e convite de aula ao vivo, tudo a partir da sua plataforma.
SaaS testa 14 dias com o time técnico ajudando na integração.
- conexões na D-API
- 1.875
- de uptime garantido em contrato
- 99,9%
- datacenters no Brasil
- 4
- por ligação de WhatsApp na API não-oficial
- R$ 0
Grupo de turma criado pela plataforma
POST /api/v1/groups/create com participantes, descrição, foto e mensagens só de administradores.
Entrada só para aluno matriculado
Com admin_approval, cada pedido de entrada vira webhook, e a sua plataforma aprova quem tem matrícula ativa.
Curso inteiro numa comunidade
Uma comunidade por curso, com grupo de avisos e um grupo por turma vinculado a ela.
Em educação online, a sensação de turma faz diferença na conclusão do curso. O aluno que entra no grupo, vê os colegas, recebe o lembrete da aula e encontra o material na conversa tende a seguir até o fim. Para uma edtech, o desafio é operar isso para centenas de turmas sem que alguém do time crie grupo, adicione aluno e remova ex-aluno à mão. O WhatsApp para edtech resolve isso quando a turma passa a ser criada e administrada pela própria plataforma.
Esta página mostra como plataformas de cursos, escolas de idiomas, cursinhos e produtores de conteúdo automatizam o ciclo da turma com a D-API: criação do grupo, entrada controlada, comunidade por curso, material e aula ao vivo.
Uma conexão por escola ou produtor
Cada cliente da sua edtech conecta o próprio número numa conexão isolada, criada pelo seu backend com POST /api/v1/sessions. É esse número que cria os grupos, manda os avisos e responde o aluno no privado. O aluno reconhece a escola, e a escola continua dona da relação.
Escolas com operação grande costumam separar números por função, por exemplo um para turmas e outro para atendimento comercial. Cada um vira uma conexão, e o seu banco decide qual delas faz o quê.
Quando o aluno é menor de idade, o contato principal costuma ser o responsável. Vale modelar isso desde o início: o telefone que entra no grupo, o que recebe o aviso de frequência e o que recebe a cobrança podem ser diferentes, e a sua plataforma guarda quem autorizou cada contato.
A turma nasce com a matrícula
O evento de matrícula confirmada na sua plataforma pode criar o grupo da turma na hora, já com a configuração certa:
POST /api/v1/groups/create
{
"sessionId": "escola-118-turmas",
"name": "Inglês B1, Turma Noite 11/26",
"participants": ["5511999999999", "5521988888888"],
"description": "Avisos, material e dúvidas da turma. Aulas às terças e quintas, 19h.",
"admin_only_messages": false,
"admin_approval": true,
"async": true
}
O campo admin_only_messages deixa o grupo só para avisos, quando a escola prefere assim, e admin_approval faz cada entrada passar por aprovação. Para turmas grandes, async: true cria o grupo em segundo plano e adiciona os participantes sem segurar o request. Os campos picture e disappearing_messages completam a configuração. A referência está na documentação da D-API.
Ao longo do curso, POST /api/v1/groups/{groupId}/participants adiciona quem matriculou depois, remove quem cancelou e promove o monitor da turma a administrador. Quando a matrícula termina, a remoção sai do mesmo evento que encerra o acesso à plataforma.
Entrada aprovada só para quem é aluno
Link de grupo vaza. Em curso pago, isso significa gente de fora assistindo ao que outros pagaram. Com admin_approval ligado, cada pedido de entrada pelo link gera o webhook group_participants.join-request, com o grupo e o requester_jid de quem pediu. A sua plataforma confere se aquele telefone tem matrícula ativa e chama POST /api/v1/groups/{groupId}/join-requests/approve para quem tem. Quem não tem pode ser reprovado pela rota de rejeição. O link de convite sai de GET /api/v1/groups/{groupId}/invite e pode ser revogado a qualquer momento.
Os eventos groups_participants.join e groups_participants.leave fecham o ciclo: a sua plataforma sabe quem entrou e quem saiu de cada turma, e o coordenador vê isso no painel.
Uma comunidade por curso
Curso com várias turmas organiza melhor numa comunidade. Com is_parent: true, a API cria a comunidade junto com o grupo de avisos e um subgrupo geral. Cada turma nova entra com parent_jid apontando para a comunidade, e grupos que já existiam podem ser vinculados depois com POST /api/v1/groups/{groupId}/link.
O desenho fica assim: avisos gerais do curso no grupo de avisos da comunidade, conversa e dúvidas em cada turma. A página sobre grupos pela API mostra as configurações de privacidade, nome, descrição e foto. Para comunicados abertos ao público, como abertura de turmas, o número da escola também pode criar um canal do WhatsApp.
Material na conversa
Apostila, exercício e gravação da aula chegam mais rápido onde o aluno já está. A sua plataforma pode mandar o material no grupo da turma ou no privado de cada aluno:
- PDF e documento.
POST /api/v1/messages/send/document, por URL ou base64, com nome de arquivo e legenda. - Vídeo curto e áudio.
send/videopara a explicação do professor esend/audiopara exercício de pronúncia. - Vários arquivos de uma vez.
send/albumagrupa imagens e vídeos num álbum só.
A página sobre envio de mídia cobre formatos e boas práticas. Uma dica que vale em turma grande: use o envio assíncrono com sequential: true quando o material tem várias partes que precisam chegar na ordem.
Aula ao vivo com convite no WhatsApp
O aluno esquece a aula ao vivo, não o WhatsApp. POST /api/v1/calls/send-event envia um convite de chamada agendada com title e scheduledTime. O convite pode criar um link de chamada do WhatsApp de áudio ou vídeo, para mentoria e aula particular, ou levar a URL da ferramenta de vídeo da escola em customCallLinkUrl, para a aula da turma inteira. O convite fica na conversa e o aluno entra com um toque.
Para o aluno que some, a mesma conta oferece outros canais. Uma ligação de WhatsApp pelo número da escola, na API não-oficial e sem custo extra por chamada, ou um SMS quando o aluno não responde mais no WhatsApp.
Por onde começar
Escolha um curso piloto e ligue o evento de matrícula da sua plataforma à criação do grupo, com admin_approval ativo. Trate o group_participants.join-request com a checagem de matrícula e a remoção no fim do curso. Depois acrescente a comunidade, o material e o convite de aula. O modelo de conexões por cliente e a cobrança por conexão estão na página de API de WhatsApp para SaaS.
Time D-API. Atualizado em .
Perguntas frequentes
Os grupos ficam no número de quem?
No número que a escola ou o produtor conectou à sua plataforma. Cada cliente da sua edtech tem a própria conexão, e os grupos são criados e administrados por ela.
Consigo remover o aluno quando a matrícula termina?
Sim. POST /api/v1/groups/{groupId}/participants aceita as ações de adicionar, remover, promover e rebaixar participantes.
Dá para fazer enquete com a turma?
A API envia enquetes com POST /api/v1/messages/send/poll. Os votos chegam no webhook como poll_update com os dados do voto criptografados, então planeje a leitura do resultado antes de depender dela num fluxo automático.
Mensagens de grupo podem atrapalhar o atendimento individual?
Se a conexão também atende alunos no privado, filtre por is_group no webhook. Se não precisa dos eventos de grupo, ignoreGroups descarta esses eventos na própria conexão.
A aula ao vivo acontece dentro do WhatsApp?
Pode acontecer ou não. O convite de chamada agendada cria um link de chamada do WhatsApp ou aponta para a URL da ferramenta de vídeo que a escola já usa.