YCloud Developer Kit

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 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.

Codex
Claude Code
WorkBuddy

npx skills add YCloud-Developers/YCloud-Developer-Kit --skill '*' -a codex --copy -y

npx skills add YCloud-Developers/YCloud-Developer-Kit --skill '*' -a claude-code --copy -y

WorkBuddy utiliza el directorio de habilidades compatible con CodeBuddy, .codebuddy/skills/.

npx skills add YCloud-Developers/YCloud-Developer-Kit --skill '*' -a codebuddy --copy -y

Para elegir su agente de programación de forma interactiva, ejecute:

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.

Comprobar la instalación

Inicie una nueva sesión en su agente de programación y envíe:

Use ycloud-developer-kit-smoke-test to check that YCloud Developer Kit is ready.

La respuesta esperada es:

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:

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.

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

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

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

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

Enviar un mensaje de WhatsApp

Prepara las plantillas de mensaje, las cargas útiles (payloads) y la gestión de entrega.

Configurar webhooks

Conecta tu aplicación a los mensajes entrantes y a las actualizaciones de estado.

Primeros pasos

Guías

Endpoints

Webhook reference

Antes de comenzar

Instalar las habilidades

Comprobar la instalación

Crear su primera integración

Qué cubre el kit

Más prompts de ejemplo

Agregar mensajes entrantes y webhooks

Revisar una integración existente

Solicitar una lectura en vivo

Pruebas locales y operaciones en vivo

Pasos siguientes

Enviar un mensaje de WhatsApp

Configurar webhooks

​Antes de comenzar

​Instalar las habilidades

​Comprobar la instalación

​Crear su primera integración

​Qué cubre el kit

​Más prompts de ejemplo

​Agregar mensajes entrantes y webhooks

​Revisar una integración existente

​Solicitar una lectura en vivo

​Pruebas locales y operaciones en vivo

​Pasos siguientes

Enviar un mensaje de WhatsApp

Configurar webhooks

Antes de comenzar

Instalar las habilidades

Comprobar la instalación

Crear su primera integración

Qué cubre el kit

Más prompts de ejemplo

Agregar mensajes entrantes y webhooks

Revisar una integración existente

Solicitar una lectura en vivo

Pruebas locales y operaciones en vivo

Pasos siguientes