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

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

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

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

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

Отправка SMS

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

Отправка email

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

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

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

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

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

Интеграция с WhatsApp

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

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

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

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

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

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

Шаблоны

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

Flows

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

Медиа

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

Звонки

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

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

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

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

Контакты

Создавайте и ведите профили клиентов.

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

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

Отписавшиеся пользователи

Фиксируйте и применяйте отписки от каналов коммуникации.

Баланс

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

Принципы работы API

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

Выполняйте безопасную аутентификацию с помощью API-ключа.

Ошибки

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

Пагинация

Выполняйте постраничную навигацию по эндпоинтам списков.

Webhook

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

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

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

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

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

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

Разбор работы Webhook

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

Все варианты полезной нагрузки Webhook

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

Переход от руководств к справочнику

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