O que mudou no Torpedo.

Verificação de números por WhatsApp

O Verify envia um código de uso único por WhatsApp e confirma o código que o utilizador escreve. Se o WhatsApp falhar, o código pode seguir por SMS. O Torpedo gera o código, conta as tentativas erradas e faz expirar o código por si.

• › POST /v1/verify para enviar e POST /v1/verify/{id}/check para confirmar
• › torpedo.verify no SDK para TypeScript (0.3.0) e verify() no SDK para Java (0.2.0)
• › Webhooks verification.* para envio, entrega, fallback e aprovação
• › GET /v1/workspace/usage passa a funcionar com chave de API e mostra o saldo de WhatsApp
• › Se já usa o webhook verification.fallback, leia o canal em data.toChannel: data.to passa a ser sempre o número de telefone

curl -X POST https://api.torpedo.co.mz/v1/verify \
  -H "X-API-Key: $TORPEDO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "to": "+258841234567", "fallback": "sms" }'

Estado undelivered e prazo para a confirmação de entrega

Um SMS que a operadora aceitou mas não conseguiu entregar passa a ter o estado undelivered, separado de failed. Se a operadora não confirmar a entrega em 25 horas, o SMS fica marcado como não confirmado.

• › undelivered: a operadora não conseguiu entregar (número inválido, telemóvel inacessível, expirado)
• › failed: o SMS nunca chegou à operadora
• › Novo webhook sms.delivery_unknown quando não chega confirmação
• › Se a sua integração verifica status === "failed", passe a verificar também "undelivered"

Verificação em dois passos

Pode activar a verificação em dois passos na sua conta. Depois da palavra-passe, o painel pede um código de 6 dígitos enviado para o seu email.

Envio de teste a partir do painel

Envie um email ou SMS de teste sem escrever código. A mensagem segue o mesmo caminho de um envio pela API, com estado e histórico.

Registo unificado de mensagens

Emails e SMS aparecem na mesma lista, no painel e na API. Útil quando o cliente liga a dizer que não recebeu nada e não sabe por que canal.

curl https://api.torpedo.co.mz/v1/messages \
  -H "X-API-Key: $TORPEDO_API_KEY"

Repetições de webhooks com espera crescente

Se o seu endpoint falhar, o Torpedo volta a tentar com intervalos crescentes, de 5 segundos até 5 minutos entre tentativas.

Ciclo de entrega de cada SMS

Cada SMS mostra as etapas por que passou, do pedido ao recibo da operadora, e o motivo quando não é entregue.

• › sms.delivered quando a operadora confirma
• › sms.undelivered e sms.failed com o motivo

Protecção contra bots no registo e no login

Os formulários de conta passam a usar Cloudflare Turnstile. Menos contas falsas, sem puzzles para quem é humano.

SDK para Java e idempotência em lotes

Primeira versão do SDK para Java 17, com clientes síncrono e assíncrono. Os envios de email em lote aceitam Idempotency-Key, como os envios individuais.

<dependency>
  <groupId>mz.co.torpedo</groupId>
  <artifactId>torpedo-java</artifactId>
  <version>0.1.0</version>
</dependency>