Telegram · COMO FUNCIONA
Envie códigos OTP através da Bot API do Telegram. A Novauth resolve o número de telefone para um utilizador do Telegram, entrega o código e permite que o seu servidor o verifique — com acompanhamento completo do estado, controlo de TTL e suporte de revogação.
code_valid · TTL 300s
request_id: 01JXTG…
phone resolved → user_id
Da introdução do número de telefone até à verificação — passo a passo.
Utilizador
O utilizador toca em 'Verificar com Telegram' na sua aplicação
O seu backend
POST /telegram com o número de telefone, o código OTP e o TTL
Novauth
Resolve telefone → ID de utilizador do Telegram · valida o OTP e o TTL
Bot API do Telegram
OTP entregue no chat de Telegram do utilizador via Bot API oficial
Telegram do utilizador
Chega a notificação do Telegram · o utilizador vê o código OTP no chat
Verificado
O servidor chama check-verification-status · devolve code_valid ou expired
O utilizador toca em 'Verificar com Telegram' na sua aplicação
POST /telegram com o número de telefone, o código OTP e o TTL
Resolve telefone → ID de utilizador do Telegram · valida o OTP e o TTL
OTP entregue no chat de Telegram do utilizador via Bot API oficial
Chega a notificação do Telegram · o utilizador vê o código OTP no chat
O servidor chama check-verification-status · devolve code_valid ou expired
Endpoint da API
POST /api/v1/connect-hub/telegramO seu servidor chama POST /telegram/check-verification-status com o request_id. O Telegram valida o código do lado do servidor — sem necessidade de o utilizador digitar nada em alguns fluxos, reduzindo a fricção.
Cada pedido tem um TTL (30–3600 s). Chame POST /telegram/revoke-verification a qualquer momento para invalidar um código pendente — essencial para fluxos de reenvio e para limitar abusos.
As respostas incluem request_cost, remaining_balance e delivery_status (enviado → entregue → lido → expirado). Os webhooks disparam em cada mudança de estado.
2 $ de crédito grátis, sem cartão de crédito. Documentação completa e ambiente de testes incluídos.