EVIR for developers

Add EVIR to your Telegram bot

Request ad cards from your server and send them at the right point in your bot flow. Examples are available in Python and Node.js.

Connect in three steps

1
Create the key
Open the bot card → Connection. Store the EVIR API key on your server only.
2
Choose formats
Use any nonempty combination of op, transition, and impression in productTypes. Call POST /api/v1/integrations/next with Telegram from.id as recipientId. An empty card list is valid.
3
Send and check
After Telegram confirms delivery, call served when requiresServedAck is true. One Check button calls deliveries/check for the returned cards; it does not replace served.

If the send outcome is unknown, do not send the card again. The integration guide covers safe retries.

Choose formats and get code for requests, delivery and one shared Check action.

Methods, request fields, responses and errors.

Signed result and unsubscribe events, retries and deduplication.

Help

Will my existing webhook stay in place?

Yes. In API mode, your server continues to handle Telegram updates. No-code mode uses a separate connection flow.