> ## 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 Developer Kit > Создавайте интеграции с YCloud с помощью навыков написания кода ИИ для Codex, Claude Code и WorkBuddy. YCloud Developer Kit помогает вашему ИИ-агенту программирования планировать интеграции, генерировать серверный код и тестировать рабочие процессы в существующем проекте. Опишите задачу, которую хотите реализовать — например, уведомления о заказах в WhatsApp, напоминания о встречах или клиентскую поддержку, — и агент использует контракты YCloud API для руководства процессом разработки. Вы также можете попросить агента провести аудит существующей интеграции или выполнить конкретную операцию в live API с помощью настроенных серверных учетных данных. ## Перед началом работы Для установки и локальной разработки вам понадобятся: * Codex, Claude Code или WorkBuddy. * Node.js и `npx`, доступные в вашем терминале. * Проект, в котором вы планируете создавать интеграцию. Для проверки установки или тестов с использованием моков ключ YCloud API не требуется. Для выполнения реальных API-запросов вам понадобятся аккаунт YCloud, серверный API-ключ и ресурсы, необходимые для вашего сценария. Инструкции по настройке учетных данных см. в разделе [Аутентификация](https://docs.ycloud.com/ru/api-reference/guides/api-fundamentals/authentication.md). ## Установка навыков Запустите команду для вашего агента программирования из каталога вашего проекта. Каждая команда устанавливает полный набор из 17 навыков в этот проект. > [tab] Codex > > ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}} > npx skills add YCloud-Developers/YCloud-Developer-Kit --skill '*' -a codex --copy -y > ``` > [tab] Claude Code > > ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}} > npx skills add YCloud-Developers/YCloud-Developer-Kit --skill '*' -a claude-code --copy -y > ``` > [tab] WorkBuddy > > WorkBuddy использует совместимый с CodeBuddy каталог навыков, `.codebuddy/skills/`. > > ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}} > npx skills add YCloud-Developers/YCloud-Developer-Kit --skill '*' -a codebuddy --copy -y > ``` Чтобы выбрать агента программирования в интерактивном режиме, выполните: ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}} npx skills add YCloud-Developers/YCloud-Developer-Kit --skill '*' ``` Вы можете найти версии ZIP-пакетов плагинов и контрольные суммы на [официальной странице релизов](https://github.com/YCloud-Developers/YCloud-Developer-Kit/releases). ## Проверка установки Запустите новую сессию в вашем агенте программирования и отправьте: ```text theme={"theme":{"light":"github-light","dark":"github-dark"}} Use ycloud-developer-kit-smoke-test to check that YCloud Developer Kit is ready. ``` Ожидаемый ответ: ```text theme={"theme":{"light":"github-light","dark":"github-dark"}} YCloud Developer Kit is ready. No external API was called. ``` Эта проверка подтверждает, что агент может обнаружить и вызвать навык готовности. Она не считывает учетные данные, не обращается к YCloud и не валидирует конфигурацию вашей учетной записи. Если агент не может найти навык, убедитесь, что вы выполнили команду установки в правильном проекте, выбрали нужного агента и открыли новую сессию для этого проекта. ## Создание первой интеграции Опишите бизнес-цель, стек проекта и необходимый результат. Начните с `ycloud-integration-architect`, если рабочий процесс охватывает несколько возможностей, таких как шаблоны, отправка сообщений и webhook-события. Например, отправьте следующий промпт из проекта вашего приложения: ```text theme={"theme":{"light":"github-light","dark":"github-dark"}} Use ycloud-integration-architect to add WhatsApp order notifications to this project. Reuse the existing framework and configuration patterns. Send an existing approved template and handle delivery-status webhooks. Keep the API key on the server and verify webhook signatures. Add local tests with synthetic data and mocked YCloud responses. Report the files changed, test results, and remaining setup. ``` Агент использует соответствующие предметные навыки для выбранного сценария. Проверьте сгенерированный код и результаты тестов, затем настройте необходимые ресурсы YCloud перед запуском реального теста. Предоставьте агенту следующий контекст, когда это применимо: | Контекст | Пример | | - | - | | Бизнес-цель | Отправлять подтверждение заказа через WhatsApp. | | Текущий стек | Использовать Node.js-бэкенд и раннер тестов этого проекта. | | Объем задач | Использовать существующий шаблон; не создавать и не изменять шаблоны. | | Тестовое окружение | Использовать моки с синтетическими идентификаторами клиентов и сообщений. | | Live-операция | Получить баланс для указанного аккаунта, используя настроенную ссылку на учетные данные. | | Ожидаемый результат | Серверный код, локальные тесты и список оставшихся шагов по настройке. | Передавайте учетные данные через конфигурацию сервера или менеджер секретов. Не вставляйте API-ключи или секреты подписи webhook в промпты. ## Что входит в состав набора Версия `0.7.13` включает 17 навыков, охватывающих 88 операций API, а также аутентификацию API и получение webhook. В таблице сгруппированы предметные навыки по типам выполняемых задач. | Возможность | Навык | Типичные задачи | | - | - | - | | Аутентификация API | `ycloud-api-authentication` | Настройка серверных ключей API и планирование их ротации. | | Сообщения WhatsApp | `ycloud-whatsapp-messages` | Отправка сообщений напрямую или через очередь, а также получение сообщений. | | Медиафайлы WhatsApp | `ycloud-whatsapp-media` | Загрузка медиафайлов для сценария отправки сообщений. | | Шаблоны WhatsApp | `ycloud-whatsapp-templates` | Создание, просмотр списка, получение, редактирование и удаление шаблонов; получение аналитики. | | Webhook-события | `ycloud-webhook-endpoints` | Управление конечными точками и создание обработчиков с проверкой подписи. | | WhatsApp Business Accounts | `ycloud-whatsapp-business-accounts` | Просмотр списка и получение аккаунтов; управление настройками автоматической оптимизации креативов. | | Номера телефонов WhatsApp | `ycloud-whatsapp-phone-numbers` | Управление регистрацией, профилями, отображаемыми именами, именами пользователей и настройками. | | Группы WhatsApp | `ycloud-whatsapp-groups` | Управление группами, участниками, запросами на вступление и ссылками-приглашениями. | | WhatsApp Flows | `ycloud-whatsapp-flows` | Создание, обновление, предварительный просмотр, публикация, прекращение поддержки и удаление Flows. | | Подтверждения входящих сообщений | `ycloud-whatsapp-inbound-messages` | Пометка полученных сообщений как прочитанных или отображение индикатора набора текста. | | WhatsApp Calling | `ycloud-whatsapp-calling` | Управление сессиями звонков и загрузка медиафайлов звонков. | | Баланс аккаунта | `ycloud-balance` | Получение баланса аккаунта. | | Контакты | `ycloud-contacts` | Управление контактами и заметками, а также получение списка атрибутов контактов. | | Пользовательские события | `ycloud-custom-events` | Управление определениями и свойствами событий, а также отправка событий, связанных с контактами. | | Настройки отписки | `ycloud-unsubscribers` | Создание, получение, вывод списка и удаление записей об отписке. | Оставшиеся два навыка — `ycloud-integration-architect`, координирующий рабочие процессы между доменами, и `ycloud-developer-kit-smoke-test`, проверяющий готовность установленных навыков. > [!NOTE] > > Этот релиз не охватывает интеграции с SMS, Verify, Voice или Email. Эти продукты по-прежнему доступны через API YCloud. Информацию об их интеграции см. в соответствующих руководствах и справочных материалах по API. ## Другие примеры промптов ### Добавление входящих сообщений и вебхуков ```text theme={"theme":{"light":"github-light","dark":"github-dark"}} Use YCloud Developer Kit to add WhatsApp inbound-message handling to this backend. Verify webhook signatures and handle duplicate events. Add local tests for valid signatures, invalid signatures, and repeated delivery. Report the implementation changes and test results. ``` ### Проверка существующей интеграции ```text theme={"theme":{"light":"github-light","dark":"github-dark"}} Review this project's YCloud WhatsApp integration. Check server-side authentication, request and response handling, delivery-status webhooks, error handling, and retry behavior against the supported contracts. Report findings and suggested fixes without changing files or calling live APIs. ``` ### Запрос чтения данных в реальном времени ```text theme={"theme":{"light":"github-light","dark":"github-dark"}} Use ycloud-balance to retrieve the balance for the YCloud account identified in this project's server configuration. Use the configured credential reference without displaying the key. Report the returned amount and currency. ``` ## Локальные тесты и операции в реальном времени Локальные мок-тесты позволяют проверить поведение приложения с синтетическими данными. Успешный мок-тест не подтверждает аутентификацию в рабочей среде, доставку сообщений или развертывание в продакшене. Для выполнения операций в реальном времени укажите аккаунт, среду, целевые ресурсы и действие. Агент использует настроенные учетные данные в пределах этой области. Он запросит недостающие сведения, если цель или последствия неясны. Запрос на локальную разработку кода не дает разрешения на несвязанные изменения в реальной среде. При отправке сообщений и других асинхронных операциях отличайте принятый запрос от его окончательного результата. Проверяйте доставку или завершение через соответствующий API получения данных или Webhook. Если время ожидания операции в реальной среде истекло, проверьте текущее состояние ресурса перед повторной попыткой. ## Следующие шаги > [card] [Отправка сообщения WhatsApp](https://docs.ycloud.com/ru/api-reference/guides/whatsapp-platform/send-whatsapp-message.md) > > Подготовка шаблонов сообщений, полезных нагрузок и обработки доставки. > [card] [Настройка вебхуков](https://docs.ycloud.com/ru/api-reference/guides/api-fundamentals/configure-webhooks.md) > > Подключение вашего приложения к входящим сообщениям и обновлениям статуса. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.