Telegram OTP

Telegram OTP brzi početak

Šaljite verifikacijske kodove nativno kroz Telegram Gateway. Platforma validira kodove na poslužiteljskoj strani — vaš backend nikada ne mora čuvati niti uspoređivati OTP.

Testirate bez pravog Telegram računa? Koristite Sandbox način rada — bez slanja poruka, bez potrebe za verificiranim kanalom i bez naplate.

Preduvjeti

Novauth API ključ — nabavite ga s nadzorne ploče

Korisničko ime verificiranog Telegram kanala (sender_username) — opcionalno, ali preporučeno radi prepoznatljivosti brenda

Telefonski broj korisnika u E.164 formatu

Provjerite dostupnost opcionalno

Prije slanja možete provjeriti ima li telefonski broj instaliran Telegram i može li primati poruke. Time izbjegavate trošenje na zahtjeve koji se ne mogu isporučiti.

POST/api/v1/connect-hub/telegram/check-send-ability

bash

# Optional: check if this phone number is reachable on Telegram
curl -X POST https://api.novauth.com/api/v1/connect-hub/telegram/check-send-ability \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-account-id: YOUR_ACCOUNT_ID" \
  -H "Content-Type: application/json" \
  -d '{"to": "+14155552671"}'

1Pošaljite OTP kod

POST-ajte svoj generirani OTP kod zajedno s brojem primatelja. Novauth ga prosljeđuje Telegram Gatewayu, koji ga isporučuje kao službenu poruku u Telegram aplikaciji.

POST/api/v1/connect-hub/telegram

bash

curl -X POST https://api.novauth.com/api/v1/connect-hub/telegram \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-account-id: YOUR_ACCOUNT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "to":              "+14155552671",
    "code":            "482951",
    "ttl":             300,
    "sender_username": "your_verified_channel",
    "callback_url":    "https://your-server.com/telegram-webhook"
  }'

200 OK — Odgovor

json

{
  "uuid":              "01JQHM3P7KXNV8W2QF5DG6TYAB",  // internal Novauth ID
  "request_id":        "tg_req_4Kf8mNpQrS9xYz2A",      // Telegram Gateway ID — save this
  "to":                "+14155552671",
  "status":            "sent",
  "request_cost":      0.01,
  "remaining_balance": 99.99
}

Spremite request_id iz odgovora — potreban vam je za provjeru statusa verifikacije i za opoziv koda ako korisnik zatraži ponovno slanje.

2Provjerite status verifikacije

Ključna prednost Telegram Gatewaya: ne morate sami čuvati niti uspoređivati OTP. Proslijedite kod koji je korisnik unio na check-verification-status i platforma vam kaže je li važeći.

Ovaj endpoint zahtijeva request_id iz pravog POST /telegram poziva. Sandbox request_id-jevi se ovdje ne prihvaćaju — važeći su samo unutar sandbox tijeka.

POST/api/v1/connect-hub/telegram/check-verification-status

bash

# Verify user-entered code server-side
curl -X POST https://api.novauth.com/api/v1/connect-hub/telegram/check-verification-status \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-account-id: YOUR_ACCOUNT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "request_id": "tg_req_4Kf8mNpQrS9xYz2A",
    "code":       "482951"
  }'

200 OK — Odgovor

json

{
  "request_id":   "tg_req_4Kf8mNpQrS9xYz2A",
  "phone_number": "+14155552671",
  "request_cost": 0.01,
  "delivery_status": {
    "status":     "delivered",   // "sent" | "delivered" | "read" | "expired" | "revoked"
    "updated_at": 1713369600
  },
  "verification_status": {
    "status":       "code_valid",   // the submitted code matched
    "updated_at":   1713369612,
    "code_entered": "482951"
  }
}

3Opozovite verifikaciju (tijek ponovnog slanja)

Ako korisnik zatraži novi kod prije nego što trenutni istekne, prvo opozovite otvoreni zahtjev — to može aktivirati povrat sredstava za prvotnu naplatu. Zatim ponovno pozovite POST /telegram s novim kodom.

Zahtijeva pravi request_id — ovaj endpoint ne prihvaća sandbox ID-jeve.

POST/api/v1/connect-hub/telegram/revoke-verification

bash

# Invalidate an outstanding verification request (e.g. user requested a resend)
curl -X POST https://api.novauth.com/api/v1/connect-hub/telegram/revoke-verification \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-account-id: YOUR_ACCOUNT_ID" \
  -H "Content-Type: application/json" \
  -d '{"request_id": "tg_req_4Kf8mNpQrS9xYz2A"}'

API referenca

POST/telegramPošaljite OTP kod preko Telegrama

POST/telegram/check-send-abilityProvjerite je li broj dostupan na Telegramu

POST/telegram/check-verification-statusValidirajte poslani kod na poslužiteljskoj strani

POST/telegram/revoke-verificationOtkažite otvoreni zahtjev (tijek ponovnog slanja)

GET/telegram/{uuid}/tdrPreuzmite izvještaj o isporuci Telegrama

POST/telegram/tdrIzlistajte sve Telegram zapise (paginirano)

Tijelo zahtjeva — POST /telegram

tostringrequiredTelefon primatelja u E.164 formatu

codestringrequiredOTP kod za isporuku — 4 do 8 znamenki

ttlnumberoptionalIstek u sekundama (30–3600). Zadano: zadana vrijednost platforme

sender_usernamestringoptionalKorisničko ime vašeg verificiranog Telegram kanala

callback_urlstringoptionalWebhook URL za primanje ažuriranja statusa isporuke/verifikacije