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

# Руководства

> Практические руководства по интеграции с YCloud API.

Используйте эти руководства, чтобы пройти путь от первого запроса до готовой интеграции в продакшене.

## Выберите сценарий работы

Начните с руководства по конкретной задаче, если вы уже знаете, что хотите реализовать. Каждое руководство описывает возможности функции, предварительные требования, принцип работы, полный пример запроса, ответ, финальный статус и типичные ошибки.

<CardGroup cols={2}>
  <Card title="Отправка сообщения в WhatsApp" icon="whatsapp" href="/ru/api-reference/guides/whatsapp-platform/send-whatsapp-message">
    Выберите между отправкой через очередь и прямой отправкой.
  </Card>

  <Card title="Отправка SMS" icon="comment-sms" href="/ru/api-reference/guides/messaging/send-sms">
    Отправляйте текстовые сообщения и отслеживайте их доставку.
  </Card>

  <Card title="Отправка email" icon="envelope" href="/ru/api-reference/guides/messaging/send-email">
    Отправляйте электронные письма в формате HTML или обычного текста.
  </Card>

  <Card title="Обработка входящих сообщений" icon="inbox" href="/ru/api-reference/guides/whatsapp-platform/handle-whatsapp-inbound-messages">
    Получайте сообщения, отмечайте их как прочитанные и отображайте индикаторы набора текста.
  </Card>

  <Card title="Отправка голосового кода" icon="volume-high" href="/ru/api-reference/guides/messaging/send-voice-code">
    Доставляйте проверочный код с помощью автоматического звонка.
  </Card>
</CardGroup>

## Разработка для WhatsApp

<CardGroup cols={2}>
  <Card title="Бизнес-аккаунты" icon="building" href="/ru/api-reference/guides/whatsapp-platform/manage-whatsapp-business-accounts">
    Проверяйте подключенные WABA, верификацию, ограничения и лимиты на отправку сообщений.
  </Card>

  <Card title="Номера телефонов" icon="phone" href="/ru/api-reference/guides/whatsapp-platform/manage-whatsapp-phone-numbers">
    Регистрируйте отправителей и управляйте профилями, коммерцией и настройками звонков.
  </Card>

  <Card title="Тарифы на сообщения WhatsApp" icon="receipt" href="/ru/api-reference/guides/whatsapp-platform/whatsapp-message-pricing-integration-guide">
    Узнайте о полях тарификации, правилах списания и о том, когда стоимость сообщения становится окончательной.
  </Card>

  <Card title="Шаблоны" icon="rectangle-list" href="/ru/api-reference/guides/whatsapp-platform/manage-whatsapp-templates">
    Создавайте и администрируйте одобренные структуры сообщений.
  </Card>

  <Card title="Flows" icon="diagram-project" href="/ru/api-reference/guides/whatsapp-platform/manage-whatsapp-flows">
    Создавайте, предварительно просматривайте, публикуйте и выводите из эксплуатации структурированные сценарии взаимодействия.
  </Card>

  <Card title="Медиа" icon="image" href="/ru/api-reference/guides/whatsapp-platform/upload-whatsapp-media">
    Загружайте переиспользуемые медиафайлы для сообщений WhatsApp.
  </Card>

  <Card title="Звонки" icon="phone-volume" href="/ru/api-reference/guides/whatsapp-platform/manage-whatsapp-calls">
    Совершайте, принимайте, отклоняйте и завершайте звонки.
  </Card>

  <Card title="Идентификаторы пользователей в рамках бизнеса (BSUID)" icon="user-tag" href="/ru/api-reference/guides/whatsapp-platform/use-business-scoped-user-ids">
    Отправляйте сообщения и совершайте звонки, не используя номер телефона пользователя.
  </Card>
</CardGroup>

## Управление данными клиентов

<CardGroup cols={2}>
  <Card title="Контакты" icon="address-card" href="/ru/api-reference/guides/customer-data-and-operations/manage-contacts">
    Создавайте профили клиентов и поддерживайте их в актуальном состоянии.
  </Card>

  <Card title="Пользовательские события" icon="bolt" href="/ru/api-reference/guides/customer-data-and-operations/track-custom-events">
    Определяйте и отправляйте события активности клиентов.
  </Card>

  <Card title="Отписавшиеся" icon="user-slash" href="/ru/api-reference/guides/customer-data-and-operations/manage-unsubscribers">
    Фиксируйте и соблюдайте отписки клиентов по каналам связи.
  </Card>

  <Card title="Баланс" icon="wallet" href="/ru/api-reference/guides/customer-data-and-operations/check-account-balance">
    Контролируйте доступные средства на счете и валюту.
  </Card>
</CardGroup>

## Основы работы с API

<CardGroup cols={2}>
  <Card title="Аутентификация" icon="key" href="/ru/api-reference/guides/api-fundamentals/authentication">
    Безопасно проходите аутентификацию с помощью API-ключа.
  </Card>

  <Card title="Ошибки" icon="triangle-exclamation" href="/ru/api-reference/guides/api-fundamentals/handle-errors">
    Корректно обрабатывайте сбои и повторные попытки запросов.
  </Card>

  <Card title="Пагинация" icon="list" href="/ru/api-reference/guides/api-fundamentals/pagination">
    Итерируйте по эндпоинтам списков.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/ru/api-reference/guides/api-fundamentals/configure-webhooks">
    Получайте события от YCloud.
  </Card>
</CardGroup>

## Адаптация готового примера

<CardGroup cols={2}>
  <Card title="Примеры с пояснениями" icon="book-open" href="/ru/api-reference/guides/examples/overview">
    Изучайте наглядные пошаговые руководства с инструкциями, примерами запросов и ответов, а также примечаниями по реализации.
  </Card>

  <Card title="Создание шаблонов WhatsApp" icon="rectangle-list" href="/ru/api-reference/guides/examples/api-examples/whatsapp-template-creation-examples">
    Создавайте варианты шаблонов с помощью скриншотов и аннотированных примеров запросов.
  </Card>

  <Card title="Пошаговые руководства по Webhook" icon="webhook" href="/ru/api-reference/guides/examples/webhook-examples/overview">
    Ознакомьтесь с предварительными требованиями, логикой событий и полезными нагрузками (payloads) для конкретных сценариев.
  </Card>

  <Card title="Все полезные нагрузки вебхуков" icon="brackets-curly" href="/ru/api-reference/guides/examples/webhook-examples/webhook-payload-examples">
    Изучите каждый поддерживаемый тип событий и именованный пример полезной нагрузки.
  </Card>
</CardGroup>

## От руководств к справочнику API

Используйте руководства, чтобы понять поведение системы и варианты интеграции. Обращайтесь к справочнику API, чтобы детально изучить каждое поле запроса, поле ответа и значения enum. Используйте примеры вебхуков для тестирования обработчика событий до запуска в продакшен.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.