Quickstart

1. Create a developer account in Telegram

Run:

/dev_start

Then create a key:

/dev_key_new My Product API

Save the returned raw key.

2. Request a link token

curl -X POST "$GATEWAY_BASE_URL/v1/link-token" \
  -H "Authorization: Bearer $ETN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"user_id":"user_123"}'

Open the returned deep_link with the end-user. They should complete /start in Telegram.

3. Start phone verification

curl -X POST "$GATEWAY_BASE_URL/v1/phone-verification/start" \
  -H "Authorization: Bearer $ETN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"user_id":"user_123"}'

User shares their contact in Telegram.

4. Send notification

curl -X POST "$GATEWAY_BASE_URL/v1/send" \
  -H "Authorization: Bearer $ETN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"user_id":"user_123","message":"Your OTP is 194881","priority":8}'

Response returns a tracking_id.

5. Poll status

curl -H "Authorization: Bearer $ETN_API_KEY" \
  "$GATEWAY_BASE_URL/v1/status/<tracking_id>"