Skip to content
EVIRTelegram growth
RUOpen EVIR

EVIR for developers

Add EVIR to an existing Telegram bot

Request suitable sponsored cards from your bot server, send them through Telegram, and acknowledge successful delivery. Use signed webhooks for later events.

Open API quick startRead API reference
  • Server-side JSON API
  • Bearer key per connection
  • HMAC-signed webhooks

Core flow

Three steps in your bot server

  1. 1

    1. Request assignments

    Call POST /api/v1/integrations/{projectId}/next with recipientId and limit.

  2. 2

    2. Send the card

    Render the returned text and button in your Telegram bot without exposing the EVIR key to the client.

  3. 3

    3. Confirm delivery

    After Telegram accepts the message, call POST /api/v1/integrations/{projectId}/deliveries/{id}/served for the same delivery id.

Open the documentation you need

Integration guide

Start here for the full request, send, and acknowledgement sequence.

Open quick start

Webhooks

Receive signed result and unsubscribe events with retries and duplicate protection.

Open webhook guide

Help

Frequently asked questions

Can I call the EVIR API from a browser?

No. Keep the EVIR API key on the server that runs your Telegram bot.

What if the assignments array is empty?

Continue the normal bot flow. An empty assignment list is a valid response, not an integration failure.

How are webhook events verified?

Verify the timestamp and HMAC signature against the raw request body, then deduplicate by event id.

Related pages

Official EVIR Telegram platformMonetize your Telegram bot. Promote bots and channels.Telegram bot monetizationEarn from your Telegram bot with EVIRTelegram advertisingPromote a Telegram bot or channel

Next step

Ready to integrate EVIR?

Start with the integration flow or open the full API reference.
Open API quick start