Status do WhatsApp atualizado

Disparado quando reporta um novo status de entrega da mensagem de WhatsApp enviada ao aluno (primeiro acesso ou reenvio no perfil)

Evento:

alpaclass.student_whatsapp_status_updated

Evento único disparado a cada novo status de entrega da mensagem de WhatsApp enviada ao aluno — na criação do aluno (primeiro acesso) ou no reenvio pelo perfil. O payload não distingue a origem do envio.

Cada mudança de status gera um novo disparo deste mesmo evento. Filtre por data.whatsapp.status (ou metadata.status), não pelo nome do evento.

| Status | Significado | |---|---| | sent | Enviada | | delivered | Entregue | | read | Lida | | undelivered | Não entregue | | failed | Falha |

Quando o evento não é enviado
Os status queued e canceled são apenas gravados internamente e não geram webhook. O evento também não é emitido se o envio não estiver ligado a um aluno, se a escola não tiver conta Eduzz no owner ou se o aluno não tiver matrícula ativa (não reembolsada, não expirada e não congelada).

Response params

event

string

Nome do evento (student_whatsapp_status_updated)

sentDate

string

Data do envio do evento (ISO 8601 UTC)

users

array of string

Contas Eduzz que devem receber o evento

metadata

object

Dados de rastreio do evento

metadata.teamId

string

Id da escola

metadata.studentId

array of string

Identificadores do aluno: publicId e id interno, nessa ordem

metadata.email

E-mail do aluno

metadata.status

enum

Status do WhatsApp rastreado neste evento

sent

delivered

read

undelivered

failed

data

object

Dados do evento

data.student

object

Dados do aluno

data.student.publicId

string

Id do aluno na escola

data.student.name

string

Nome do aluno

data.student.email

string

E-mail do aluno

data.student.phoneNullable

string

Telefone/Celular do aluno no formato internacional

data.whatsapp

object

Dados do disparo de WhatsApp

data.whatsapp.status

enum

Status do WhatsApp informado

sent

delivered

read

undelivered

failed

data.whatsapp.sentAtNullable

string

Data do envio original da mensagem (ISO 8601 UTC)

data.whatsapp.statusAt

string

Data do callback com o status atual (ISO 8601 UTC)

data.team

object

Dados da escola

data.team.id

string

Id da escola

data.team.name

string

Nome da escola

Payload

1{
2  "event": "student_whatsapp_status_updated",
3  "sentDate": "2026-08-14T18:12:31.120Z",
4  "users": [
5    "acc_123456"
6  ],
7  "metadata": {
8    "teamId": "77",
9    "studentId": [
10      "aln-abc123",
11      "123456"
12    ],
13    "email": "aluno@example.com",
14    "status": "delivered"
15  },
16  "data": {
17    "student": {
18      "publicId": "aln-abc123",
19      "name": "Ana Souza",
20      "email": "aluno@example.com",
21      "phone": "5511999999999"
22    },
23    "whatsapp": {
24      "status": "delivered",
25      "sentAt": "2026-08-14T18:10:00.000Z",
26      "statusAt": "2026-08-14T18:12:31.000Z"
27    },
28    "team": {
29      "id": "77",
30      "name": "Escola Exemplo"
31    }
32  }
33}