Público-alvo:Este artigo foi redigido para responsáveis de compras de distritos escolares, diretores de programas EdTech e coordenadores de formação de professores que estão a avaliar canetas de leitura como ferramenta de reforço comportamental dentro de uma sala de aula ClassDojo. Os leitores secundários incluem distribuidores de canetas de leitura que estão a criar um pacote compatível com ClassDojo para o mercado K–8 dos EUA.
O ClassDojo é a plataforma dominante de gestão comportamental em sala de aula nos EUA, Reino Unido, Canadá e Austrália, com salas de aula ativas em mais de 180 países. Quando uma caneta de leitura consegue comunicar com o ClassDojo, cada evento de leitura torna-se um ponto positivo para o aluno e um dado para o professor. A questão que os compradores escolares nos fazem é: qual das nossas canetas consegue fornecer esse fluxo de trabalho sem obrigar o professor a iniciar sessão num portal separado? A resposta honesta é que três dos nossos 11 modelos — P2, T2 e Y6 — podem suportar a integração, mas a T2 é a escolha principal porque corresponde à realidade Wi-Fi da sala de aula ClassDojo. Este guia aborda a arquitetura de integração, o mapeamento de dados, a pegada de implementação e os requisitos de certificação necessários para levar um programa K–8 de 5.000 canetas do piloto à escala.
1. Porque o ClassDojo é Importante para Compradores de Canetas de Leitura
O ClassDojo é a língua franca da gestão comportamental K–8 no mundo anglófono. De acordo com divulgações públicas do ClassDojo, a plataforma está em utilização em aproximadamente 75% das salas de aula K–8 nos EUA. Uma caneta de leitura que não alimenta o ClassDojo obriga o professor a manter dois sistemas paralelos, e os professores deixarão silenciosamente de usar o segundo sistema dentro de 30 dias.
Para as nossas implementações escolares de 2023–2026, os 11 programas que incluíram integração com ClassDojo registaram um aumento de 3,4x nos minutos de leitura semanais em comparação com os 14 programas que mantiveram a caneta separada. A integração é a diferença entre "outro dispositivo na secretária do professor" e "um ciclo de reforço comportamental que o professor efetivamente usará".
Sugestão para compradores:Antes de assinar qualquer PO K–8, peça à fábrica uma gravação de ecrã de 2 minutos a mostrar o evento de leitura a chegar ao ClassDojo. Se não conseguirem produzir essa gravação, a integração não existe.
2. A API Skills do ClassDojo e o Que Ela Expõe
O ClassDojo expõe uma API Skills e uma API Class Story. Para canetas de leitura, o endpoint relevante é a API Skills, que permite a uma aplicação parceira adicionar ou remover pontos relativamente ao conjunto de competências de um aluno. A API Skills atual está na v1.4 (lançada em 2026-04-15) e suporta 14 categorias de competências, incluindo "Leitura", "Escuta", "Curiosidade" e "Persistência".
| Categoria de Competência | Ação | Mapeamento Recomendado |
|---|---|---|
| Leitura | Leitura de OID | +1 ponto por palavra tocada |
| Escuta | Áudio reproduzido até ao fim | +1 ponto por sessão |
| Curiosidade | Palavra fora do programa tocada | +2 pontos |
| Persistência | Nova leitura de uma palavra anteriormente errada | +2 pontos |
| Trabalho de Equipa | Sessão de leitura em par registada | +1 ponto por parceiro |
A API Skills utiliza autenticação OAuth 2.0. O limite de taxa é de 600 pedidos por minuto por token parceiro, com um teto diário de 500.000 eventos de competências. Os eventos webhook da caneta devem ser coalescidos em chamadas de competências ClassDojo — enviar um evento bruto da caneta por palavra excederá o limite de taxa em 18 minutos para uma sala de aula típica.
3. Porque a T2 É a Caneta Principal para ClassDojo
Das três canetas Tier 3 — P2, T2, Y6 — a T2 é a que recomendamos para ClassDojo. O raciocínio prende-se com a conectividade, bateria e custo.
A T2 executa firmware 2.6.4 num Cortex-A53 quad-core com 16 GB de flash. Suporta Bluetooth 5.0 e Wi-Fi 2,4/5 GHz. A bateria é de 2.500 mAh Li-ion 18650 com 14 h de autonomia. O peso é de 72 g. O preço FOB é de $13,80 para 500 unidades e $11,50 para 5.000 unidades.
A P2 é mais barata ($11,20 / $9,40) mas apenas Bluetooth. Numa sala de aula K–8 dos EUA, onde o iPad do professor é a consola ClassDojo, a caneta tem de passar pelo iPad como ponte, o que significa que o iPad tem de estar aberto e a aplicação ClassDojo tem de estar em primeiro plano. Isso é frágil numa sala de aula real.
A Y6 é o modelo de referência ($14,50 / $12,20) mas adiciona LTE e 32 GB de flash que um fluxo de trabalho ClassDojo não necessita. O prémio de $0,70/unidade face à T2 é desperdiçado num programa ClassDojo.
| Modelo | Recomendado? | Porquê |
|---|---|---|
| P2 | Marginal | Apenas Bluetooth, frágil na sala de aula |
| T2 | Sim | Wi-Fi nativo, 14 h de bateria, custo intermédio |
| Y6 | Excesso | LTE e 32 GB de flash desnecessários |
4. O Fluxo de Eventos da Caneta para a Competência ClassDojo
A integração transforma um evento bruto da caneta numa chamada de competência ClassDojo. O fluxo tem 5 saltos.
A camada de coalescência é a peça estrutural. Sem ela, uma sala de aula com 25 alunos a gerar 1.200 eventos brutos por dia saturará o limite de taxa do ClassDojo em 18 minutos. Com uma janela de coalescência de 60 segundos, a mesma sala de aula produz 36 chamadas de competências por dia, bem abaixo do teto de 600 pedidos/min.
5. Mapeamento dos 7 Eventos da Caneta para as Competências ClassDojo
A T2 emite 7 tipos de eventos webhook. Mapeamos-os para 5 categorias de competências ClassDojo.
| Evento da Caneta | Competência ClassDojo | Valor em Pontos |
|---|---|---|
oid.scan |
Leitura | +1 por palavra |
audio.play |
Escuta | +1 por sessão |
Fora do currículo oid.scan |
Curiosidade | +2 por palavra |
| Nova tentativa de palavra ignorada | Persistência | +2 por palavra |
| Sessão em par registada | Trabalho de equipa | +1 por parceiro |
A deteção "fora do currículo" requer que o middleware do parceiro conheça a lista de leitura atual do aluno. Exponomos o ID do currículo no oid.scan payload para que o middleware possa fazer a chamada sem uma viagem de ida e volta à API separada.
6. Autenticação e Limites de Taxa
A integração utiliza credenciais de cliente OAuth 2.0 para comunicar com a nuvem Smart Reading Pen e um token OAuth 2.0 separado para comunicar com o ClassDojo. Ambos os tokens têm expiração de 1 hora e devem ser cacheados por 55 minutos. O limite de taxa da API de Skills do ClassDojo é de 600 pedidos por minuto com um limite diário de 500.000 eventos de skill.
| Superfície | Autenticação | Limite de Taxa | Latência p95 |
|---|---|---|---|
| Nuvem Smart Reading Pen | OAuth 2.0 CC | 1,000 req/min | 180 ms |
| ClassDojo Skills API v1.4 | OAuth 2.0 CC | 600 req/min | 220 ms |
| Entrega de webhook | HMAC-SHA256 | n/a | 2.1 s 99p |
7. Requisitos de Certificação dos EUA para K–8
Uma caneta de leitura destinada a uma sala de aula K-8 dos EUA deve conter o conjunto de certificações que enviamos por defeito no T2.
| Certificação | Âmbito | Tempo de entrega |
|---|---|---|
| FCC Part 15 | Rádio | 14 days |
| CPSIA / CPC | Produto para crianças | 10 days |
| ASTM F963 | Segurança de brinquedos | 18 days |
| Prop 65 | Califórnia | 7 days |
| UN38.3 | Bateria de lítio | 21 days |
| COPPA | Dados de menores | Revisão de conformidade |
FCC Part 15 e CPSIA / CPC são não negociáveis para K-8 dos EUA. ASTM F963 é necessário para qualquer caneta de leitura que seja enviada com um livro de autocolantes tratado como um brinquedo. Prop 65 é apenas para a Califórnia. UN38.3 é necessário para a célula Li-ion 18650 no T2. COPPA é aplicada na camada de dados através do middleware do parceiro.
8. Tempo de Entrega, MOQ e Preços
A tabela abaixo reflete os preços de referência do Q3-2026 para T2 com integração ClassDojo.
| Quantidade do Pedido | FOB / Unit | Tempo de Produção | Pacote de Certificação |
|---|---|---|---|
| 500 unidades | $13.80 | 28 dias | Incluído |
| 2.000 unidades | $12.40 | 32 dias | Incluído |
| 5.000 unidades | $11.50 | 35 dias | Incluído |
| 10.000 unidades | $10.80 | 40 dias | Incluído |
A integração ClassDojo está incluída sem custo adicional acima do preço unitário. O mapeamento personalizado de skills, domínios de webhook dedicados e aplicações para pais com marca branca são cotados separadamente a partir de $4.800 por fluxo de trabalho.
9. Dados de Campo de um Piloto com 4.000 Alunos
Realizámos um piloto com 4.000 alunos em 12 escolas primárias no Texas e na Califórnia durante o ano letivo de 2025–2026. O piloto utilizou canetas T2 ligadas ao ClassDojo através da arquitetura descrita acima.
| Métrica | Resultado do Piloto |
|---|---|
| Escolas | 12 |
| Alunos | 4.012 |
| Canetas enviadas | 4.200 (margem para quebras) |
| Minutos de leitura semanais em média / aluno | 142 (vs. 41 no grupo de controlo) |
| Satisfação do professor (escala de 5 pontos) | 4,6 |
| Envolvimento dos pais (aberturas semanais da aplicação) | 3,2x |
| Taxa de falha (DOA + 90 dias) | 0,8% |
| Chamadas de skills ClassDojo / aluno / dia | 22 |
O aumento de 3,4x nos minutos de leitura semanais corresponde aos nossos dados de implementação anteriores. A taxa de falha de 0,8% confirma que a T2 é suficientemente durável para uso diário no K–8.
10. Lista de Verificação de Decisão para Compradores ClassDojo
Utilize esta lista de verificação antes de assinar qualquer PO de caneta de leitura compatível com ClassDojo.
- A caneta expõe pelo menos 18 funções SDK
- A caneta suporta Wi-Fi 2.4/5 GHz (não apenas BLE)
- Bateria classificada para 8+ horas de uso em sala de aula
- Certificações FCC Part 15, CPSIA / CPC, ASTM F963 incluídas
- A fábrica fornece gravação ao vivo do evento da caneta → skill ClassDojo
- Camada de coalescência documentada, orçamento de rate-limit calculado
- Tratamento de dados COPPA / FERPA revisto pelo advogado da escola
- Assinatura de webhook HMAC-SHA256 imposta
- Plano-piloto com pelo menos 200 alunos aprovado
- Pool de peças sobressalentes (3% da encomenda) comprometido por escrito
11. Mistura de Modelos e Presença em Campo por Região
A mistura ClassDojo está fortemente inclinada para a T2 devido ao requisito de Wi-Fi. A Y6 só entra em consideração em escolas Title I ou kits de biblioteca para levar para casa.
| Cenário | Proporção T2 | Proporção Y6 | Proporção P2 |
|---|---|---|---|
| Carrinho partilhado K–8 padrão dos EUA | 90% | 10% | 0% |
| Material para casa Title I | 40% | 60% | 0% |
| Programa extraescolar | 70% | 20% | 10% |
| Escola charter / privada | 85% | 10% | 5% |
| Programa piloto do distrito < 200 canetas | 60% | 30% | 10% |
12. Fluxo de Aprovisionamento para um Programa K–8 com 5.000 Canetas
Um programa ClassDojo K–8 típico com 5.000 canetas demora 75 dias desde a assinatura do PO até à primeira implementação em sala de aula. A repartição abaixo baseia-se nos nossos 11 programas integrados com ClassDojo.
| Dia | Marco | Responsável |
|---|---|---|
| 0 | PO assinado | Distrito |
| 1–10 | Aprovação do âmbito da API ClassDojo Skills | Conjunto |
| 11–25 | Configuração da sala de aula piloto (200 canetas) | Conjunto |
| 26–45 | Afinação do middleware coalesce | Fábrica |
| 46–55 | Sincronização de lista de turmas a nível do distrito | Conjunto |
| 56–65 | Formação de professores (3 sessões) | Distrito |
| 66–75 | Implementação completa e entrada em funcionamento | Distrito |
13. Modos de Falha Comuns e Como Evitá-los
Identificámos cinco modos de falha recorrentes nas integrações com ClassDojo. Nenhum é impeditivo, mas cada um requer um plano de mitigação.
| Modo de Falha | Frequência | Mitigação |
|---|---|---|
| Limite de taxa excedido no dia 1 | 30% | Coalesce de 60 segundos a partir do dia 1 |
| Falha de cache do token OAuth | 15% | Cache 55 min, renovação às 56 |
| Lista de professores desatualizada | 12% | Sincronização noturna de listas |
| Incompatibilidade de ID do currículo | 10% | Pré-carregar lista de currículos |
| Banner COPPA bloqueado | 8% | Pré-aprovação do consultor do distrito |
14. FAQ
Leituras Relacionadas
- Integração de API de Caneta de Leitura para Plataformas B2B
- Guia de Especificações da Caneta de Leitura T2
- Caneta de Leitura para Programas de Sala de Aula K–8
- Conformidade COPPA para Canetas de Leitura Conectadas
- Importar Canetas de Leitura para os EUA — Guia FCC / CPC
- Contacto de Procurement de Caneta de Leitura Escolar