Skip to main content

In Telegram (group admin)

After the group is connected, a group admin runs:
/collect
The bot fetches a review collection URL from the backend and posts inline buttons. Customers tap Leave a review and complete the flow on the EthioReview website.

Backend flow

GET /api/v1/integrations/telegram/collection-link?chatId={telegramChatId}
Authorization: (bot bridge secret — not for integrators)
For dashboard / org API access:
GET /api/v1/organizations/{organizationProfileId}/telegram/collection-link
Authorization: Bearer <session>

Response fields

FieldDescription
reviewUrlTouchpoint hub URL with via=telegram attribution
organicReviewUrlDirect organic review page
qrImageUrlQR code for the touchpoint
touchpointTokenToken for analytics

Self-hosting the bot bridge

If you operate your own Telegram bridge (advanced):
TELEGRAM_BOT_TOKEN=...
BACKEND_API_URL=https://api.ethioreview.com
BRIDGE_SECRET=<matches TELEGRAM_BRIDGE_SECRET on backend>
See telegram-bots README for deployment. Review notifications →