> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ethioreview.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Integrate EthioReview reviews into your website and Telegram with API keys, widgets, and webhooks.

EthioReview provides **developer tools** for businesses and government organizations to:

* **Embed top-rated testimonials** on any website via the Review Widget
* **Connect a Telegram group** to collect reviews and receive new-review notifications
* **Fetch review data server-side** with API client credentials

<Note>
  This site is the **developer documentation portal**. Day-to-day setup (creating keys, linking Telegram) happens in the [EthioReview dashboard](https://app.ethioreview.com) under **Integrations**. Use this portal for step-by-step guides and API reference.
</Note>

## What you will build

<CardGroup cols={2}>
  <Card title="Review widget" icon="code" href="/integrations/widget/overview">
    Show top-rated reviews with reviewer names on your site. Uses a publishable key in the browser.
  </Card>

  <Card title="Telegram bot" icon="message" href="/integrations/telegram/overview">
    Link a Telegram group, collect reviews via `/collect`, and get notified when reviews publish.
  </Card>
</CardGroup>

## Architecture at a glance

```mermaid theme={null}
flowchart LR
  subgraph YourSystems [Your systems]
    Website["Website widget\npk_live_*"]
    Server["Your server\nsk_live_*"]
    Telegram["Telegram group"]
  end
  subgraph EthioReview [EthioReview platform]
    API["Public API"]
    Bot["Telegram bot"]
  end
  Website -->|Publishable key| API
  Server -->|Secret key| API
  Telegram -->|/connect /collect| Bot
  Bot --> API
```

<Note>
  Use **publishable keys** (`pk_*`) only in browser embeds. Keep **secret keys** (`sk_*`) on your server — never in client-side code or public repositories.
</Note>

## Next steps

<Steps>
  <Step title="Quickstart">
    Create sandbox credentials and embed a test widget in 10 minutes.
    [Go to Quickstart →](/quickstart)
  </Step>

  <Step title="Widget integration">
    Production embed patterns for Web Component, React, and iframe.
    [Widget overview →](/integrations/widget/overview)
  </Step>

  <Step title="Telegram">
    Link your group from the dashboard and run `/collect`.
    [Telegram overview →](/integrations/telegram/overview)
  </Step>
</Steps>