Pular para o conteúdo
D-APITestar grátis

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/video para a explicação do professor e send/audio para exercício de pronúncia.
  • Vários arquivos de uma vez. send/album agrupa 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.

A gente também é SaaS

SaaS liberado pelo time testa 14 dias grátis, com um grupo de onboarding em que o time técnico da D-API acompanha a integração no seu produto.

Continue por aqui

Liberar seu teste grátis

Responda rapidinho e o time libera seu teste pelo WhatsApp, com o time técnico ajudando na integração.

Seus dados são usados só pra liberar o teste. Sem spam.