Telegram OTP

Telegram OTP brzi početak

Šaljite verifikacione kodove nativno kroz Telegram Gateway. Platforma validira kodove na serverskoj strani — vaš backend nikada ne mora da čuva niti poredi OTP.

Testirate bez pravog Telegram naloga? Koristite Sandbox režim — bez slanja poruka, bez potrebe za verifikovanim kanalom i bez naplate.

Preduslovi

Novauth API ključ — nabavite ga sa kontrolne table

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

Telefonski broj korisnika u E.164 formatu

Provjerite dostupnost opciono

Prije slanja možete provjeriti da li telefonski broj ima instaliran Telegram i može da prima 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-ujte svoj generisani OTP kod zajedno sa brojem primaoca. Novauth ga prosljeđuje Telegram Gateway-u, koji ga isporučuje kao zvaničnu 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
}

Sačuvajte 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 Gateway-a: ne morate sami da čuvate niti poredite OTP. Proslijedite kod koji je korisnik unio na check-verification-status i platforma vam kaže da li je važeći.

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

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 (tok ponovnog slanja)

Ako korisnik zatraži novi kod prije nego što trenutni istekne, prvo opozovite otvoreni zahtjev — to može aktivirati povraćaj sredstava za prvobitnu naplatu. Zatim ponovo pozovite POST /telegram sa novim kodom.

Zahtijeva pravi request_id — ovaj endpoint ne prihvata 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 Telegram-a

POST/telegram/check-send-abilityProvjerite da li je broj dostupan na Telegram-u

POST/telegram/check-verification-statusValidirajte poslati kod na serverskoj strani

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

GET/telegram/{uuid}/tdrPreuzmite izvještaj o isporuci Telegram-a

POST/telegram/tdrIzlistajte sve Telegram zapise (paginirano)

Tijelo zahtjeva — POST /telegram

tostringrequiredTelefon primaoca u E.164 formatu

codestringrequiredOTP kod za isporuku — 4 do 8 cifara

ttlnumberoptionalIstek u sekundama (30–3600). Podrazumijevano: podrazumijevana vrijednost platforme

sender_usernamestringoptionalKorisničko ime vašeg verifikovanog Telegram kanala

callback_urlstringoptionalWebhook URL za prijem ažuriranja statusa isporuke/verifikacije