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

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

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

Отправка сообщения в WhatsApp

Выберите между отправкой через очередь и прямой отправкой.

Отправка SMS

Отправляйте текстовые сообщения и отслеживайте их доставку.

Отправка email

Отправляйте электронные письма в формате HTML или обычного текста.

Обработка входящих сообщений

Получайте сообщения, отмечайте их как прочитанные и отображайте индикаторы набора текста.

Отправка голосового кода

Доставляйте проверочный код с помощью автоматического звонка.

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

Бизнес-аккаунты

Проверяйте подключенные WABA, верификацию, ограничения и лимиты на отправку сообщений.

Номера телефонов

Регистрируйте отправителей и управляйте профилями, коммерцией и настройками звонков.

Тарифы на сообщения WhatsApp

Узнайте о полях тарификации, правилах списания и о том, когда стоимость сообщения становится окончательной.

Шаблоны

Создавайте и администрируйте одобренные структуры сообщений.

Flows

Создавайте, предварительно просматривайте, публикуйте и выводите из эксплуатации структурированные сценарии взаимодействия.

Медиа

Загружайте переиспользуемые медиафайлы для сообщений WhatsApp.

Звонки

Совершайте, принимайте, отклоняйте и завершайте звонки.

Идентификаторы пользователей в рамках бизнеса (BSUID)

Отправляйте сообщения и совершайте звонки, не используя номер телефона пользователя.

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

Контакты

Создавайте профили клиентов и поддерживайте их в актуальном состоянии.

Пользовательские события

Определяйте и отправляйте события активности клиентов.

Отписавшиеся

Фиксируйте и соблюдайте отписки клиентов по каналам связи.

Баланс

Контролируйте доступные средства на счете и валюту.

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

Аутентификация

Безопасно проходите аутентификацию с помощью API-ключа.

Ошибки

Корректно обрабатывайте сбои и повторные попытки запросов.

Пагинация

Итерируйте по эндпоинтам списков.

Webhooks

Получайте события от YCloud.

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

Примеры с пояснениями

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

Создание шаблонов WhatsApp

Создавайте варианты шаблонов с помощью скриншотов и аннотированных примеров запросов.

Пошаговые руководства по Webhook

Ознакомьтесь с предварительными требованиями, логикой событий и полезными нагрузками (payloads) для конкретных сценариев.

Все полезные нагрузки вебхуков

Изучите каждый поддерживаемый тип событий и именованный пример полезной нагрузки.

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

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