> ## 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 > Cree integraciones de YCloud con habilidades de codificación de IA para Codex, Claude Code y WorkBuddy. YCloud Developer Kit ayuda a su agente de programación con IA a planificar integraciones, generar código del lado del servidor y probar flujos de trabajo en su proyecto existente. Describa lo que desea crear, como notificaciones de pedidos por WhatsApp, recordatorios de citas o atención al cliente, y el agente utilizará los contratos de la API de YCloud para guiar el trabajo. También puede pedirle al agente que revise una integración existente o realice una operación específica de la API en vivo con sus credenciales del lado del servidor configuradas. ## Antes de comenzar Para la instalación y el desarrollo local, necesita: * Codex, Claude Code o WorkBuddy. * Node.js y `npx` disponibles en su terminal. * El proyecto donde desea crear su integración. No necesita una clave de API de YCloud para comprobar la instalación o realizar pruebas que usen mocks. Para solicitudes a la API en vivo, necesita una cuenta de YCloud, una clave de API del lado del servidor y los recursos requeridos por su flujo de trabajo. Consulte [Autenticación](https://docs.ycloud.com/es/api-reference/guides/api-fundamentals/authentication.md) para la configuración de credenciales. ## Instalar las habilidades Ejecute el comando correspondiente a su agente de programación desde el directorio de su proyecto. Cada comando instala el conjunto completo de 17 habilidades en ese proyecto. > [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 utiliza el directorio de habilidades compatible con 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 > ``` Para elegir su agente de programación de forma interactiva, ejecute: ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}} npx skills add YCloud-Developers/YCloud-Developer-Kit --skill '*' ``` Puede encontrar paquetes ZIP de complementos con versiones y sumas de verificación en la [página oficial de versiones](https://github.com/YCloud-Developers/YCloud-Developer-Kit/releases). ## Comprobar la instalación Inicie una nueva sesión en su agente de programación y envíe: ```text theme={"theme":{"light":"github-light","dark":"github-dark"}} Use ycloud-developer-kit-smoke-test to check that YCloud Developer Kit is ready. ``` La respuesta esperada es: ```text theme={"theme":{"light":"github-light","dark":"github-dark"}} YCloud Developer Kit is ready. No external API was called. ``` Esta comprobación confirma que el agente puede descubrir e invocar la habilidad de preparación. No lee credenciales, no llama a YCloud ni valida la configuración de su cuenta. Si el agente no puede encontrar la habilidad, confirme que ejecutó el comando de instalación en el proyecto correcto, seleccionó el agente correcto y abrió una nueva sesión para ese proyecto. ## Crear su primera integración Describa su objetivo empresarial, el stack del proyecto y el resultado que necesita. Comience con `ycloud-integration-architect` cuando el flujo de trabajo abarque varias funciones, como plantillas, envío de mensajes y webhooks. Por ejemplo, envíe este prompt desde el proyecto de su aplicación: ```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. ``` El agente utiliza las habilidades del dominio pertinentes para su flujo de trabajo seleccionado. Revise el código generado y los resultados de las pruebas, y luego configure los recursos requeridos de YCloud antes de solicitar una prueba en vivo. Proporcione al agente el siguiente contexto cuando sea relevante: | Contexto | Ejemplo | | - | - | | Objetivo empresarial | Enviar una confirmación de pedido a través de WhatsApp. | | Stack existente | Reutilizar el backend de Node.js y el ejecutor de pruebas de este proyecto. | | Alcance | Utilizar una plantilla existente; no crear ni editar plantillas. | | Entorno de prueba | Usar mocks con ID sintéticos de cliente y de mensaje. | | Operación en vivo | Recuperar el saldo de la cuenta especificada mediante su referencia de credencial configurada. | | Resultado esperado | Código del lado del servidor, pruebas locales y una lista de los pasos de configuración restantes. | Haga referencia a las credenciales a través de la configuración de su servidor o del gestor de secretos. No pegue claves de API ni secretos de firma de Webhook en los prompts. ## Qué cubre el kit La versión `0.7.13` incluye 17 habilidades que cubren 88 operaciones de la API, además de la autenticación de la API y la recepción de webhooks. La tabla agrupa las habilidades de dominio según el trabajo que puede solicitar. | Capacidad | Habilidad | Tareas habituales | | - | - | - | | Autenticación de la API | `ycloud-api-authentication` | Configurar claves de API del lado del servidor y planificar la rotación de claves. | | Mensajes de WhatsApp | `ycloud-whatsapp-messages` | Enviar mensajes directamente o a través de la cola, y recuperar mensajes. | | Archivos multimedia de WhatsApp | `ycloud-whatsapp-media` | Subir archivos multimedia para un flujo de trabajo de mensajes. | | Plantillas de WhatsApp | `ycloud-whatsapp-templates` | Crear, listar, recuperar, editar y eliminar plantillas; obtener analíticas. | | Webhooks | `ycloud-webhook-endpoints` | Administrar endpoints y crear receptores con verificación de firmas. | | Cuentas de WhatsApp Business | `ycloud-whatsapp-business-accounts` | Listar y recuperar cuentas; gestionar ajustes de optimización creativa automática. | | Números de teléfono de WhatsApp | `ycloud-whatsapp-phone-numbers` | Gestionar registros, perfiles, nombres visibles, nombres de usuario y ajustes. | | Grupos de WhatsApp | `ycloud-whatsapp-groups` | Gestionar grupos, membresías, solicitudes de unión y enlaces de invitación. | | WhatsApp Flows | `ycloud-whatsapp-flows` | Crear, actualizar, obtener vista previa, publicar, marcar como obsoletos y eliminar Flows. | | Confirmaciones de mensajes entrantes | `ycloud-whatsapp-inbound-messages` | Marca los mensajes recibidos como leídos o muestra un indicador de escritura. | | WhatsApp Calling | `ycloud-whatsapp-calling` | Administra sesiones de llamadas y descarga archivos multimedia de llamadas. | | Saldo de la cuenta | `ycloud-balance` | Consulta el saldo de la cuenta. | | Contactos | `ycloud-contacts` | Administra contactos y notas, y lista los atributos de contacto. | | Eventos personalizados | `ycloud-custom-events` | Administra definiciones y propiedades de eventos, y envía eventos asociados a contactos. | | Preferencias de cancelación de suscripción | `ycloud-unsubscribers` | Crea, consulta, lista y elimina registros de cancelación de suscripción. | Las dos habilidades restantes son `ycloud-integration-architect`, que coordina los flujos de trabajo entre dominios, y `ycloud-developer-kit-smoke-test`, que comprueba la disponibilidad de las habilidades instaladas. > [!NOTE] > > Esta versión no incluye integraciones de SMS, Verify, Voice ni Email. Esos productos siguen estando disponibles a través de las API de YCloud. Consulta sus guías de API y páginas de referencia para conocer los detalles de integración. ## Más prompts de ejemplo ### Agregar mensajes entrantes y webhooks ```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. ``` ### Revisar una integración existente ```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. ``` ### Solicitar una lectura en vivo ```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. ``` ## Pruebas locales y operaciones en vivo Las pruebas simuladas locales te permiten verificar el comportamiento de la aplicación con datos sintéticos. Una prueba simulada superada no confirma la autenticación en vivo, la entrega de mensajes ni el despliegue en producción. Para las operaciones en vivo, especifica la cuenta, el entorno, los recursos de destino y la acción. El agente utiliza las credenciales configuradas dentro de ese alcance. Solicitará los detalles faltantes cuando el destino o los efectos no estén claros. Una solicitud para desarrollar código localmente no autoriza cambios en vivo no relacionados. Para los envíos de mensajes y otras operaciones asíncronas, distingue una solicitud aceptada de su resultado final. Verifica la entrega o finalización a través de la API de consulta correspondiente o Webhook. Si un cambio en vivo agota el tiempo de espera, comprueba el estado de los recursos disponibles antes de reintentar. ## Pasos siguientes > [card] [Enviar un mensaje de WhatsApp](https://docs.ycloud.com/es/api-reference/guides/whatsapp-platform/send-whatsapp-message.md) > > Prepara las plantillas de mensaje, las cargas útiles (payloads) y la gestión de entrega. > [card] [Configurar webhooks](https://docs.ycloud.com/es/api-reference/guides/api-fundamentals/configure-webhooks.md) > > Conecta tu aplicación a los mensajes entrantes y a las actualizaciones de estado. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.