> For the complete documentation index, see [llms.txt](https://taddy.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://taddy.gitbook.io/docs/getting-started/integration.md).

# Интеграция

Для начала необходимо установить SDK (доступно на нескольких языках) или использовать [API](/docs/api/about.md).

В настоящий момент для TMA[^1] используйте [Web SDK](/docs/sdk/web.md). Для ботов — [Rest API](/docs/api/about.md) (SDK для различных языков будут доступны позже).

## Базовая интеграция

Для подтверждения базовой интеграции TMA необходимо выполнить инициализацию SDK и отправить событие `ready`. Это событие **необходимо** отправлять при каждом открытии TMA сразу по готовности приложения для регистрации аудитории и событий, связанных с Taddy (запуски, обмен трафиком и проч.)

Для ботов используется аналогичный метод `start` в SDK или [Rest API](/docs/api/about.md) ([Start Event](/docs/api/start-event.md)) для регистрации всех  запусков ботов и команд `/start xxxx`

Для начала работы с Taddy ваш ресурс (TMA или бот) должен иметь базовую интеграцию, а именно — сообщать Taddy о запусках и новых пользователях.

Далее, в зависимости от сценария использования нашего сервиса, можно настроить [обмен трафиком](/docs/getting-started/exchange.md) и [показ рекламы](/docs/getting-started/ads.md).

[^1]: Telegram Mini Apps