Antes de empezar
Asegúrate de que:- Tu cuenta utilice un plan de pago de YCloud. Las apps personalizadas no están disponibles en el plan Free.
- Tu rol pueda acceder a Developers > Custom apps en el panel de YCloud.
- Los números de teléfono de WhatsApp Business que la app necesita ya estén disponibles en tu cuenta de YCloud.
- Sepas qué permisos de API necesita la integración.
- Tengas un endpoint HTTPS accesible públicamente si la app necesita eventos de webhook.
Crear una app
- Inicia sesión en el panel de YCloud.
- Ve a Developers > Custom apps.
- Haz clic en Create app.

- Introduce un App name. El nombre puede tener hasta 64 caracteres.
- Opcional: Introduce una Description de hasta 512 caracteres para que tu equipo sepa para qué se utiliza la app.
- Haz clic en Create.

Enter an app name and, optionally, a description before selecting Create.
Asignar números de teléfono de WhatsApp
Asigna únicamente los números de teléfono a los que la integración deba acceder.- Abre la app y selecciona Assets.
- Haz clic en Add phone numbers.

- Busca un número por su nombre en Business Manager, WABA ID, nombre de WABA o número de teléfono.
- Selecciona uno o más números de teléfono de WhatsApp Business.
- Haz clic en Confirm.

Configurar la clave de API y los permisos
YCloud muestra la clave de API de la app en API key & permissions. Las claves de las apps personalizadas comienzan conyc_ak_. Usa la acción de copiar para guardar la clave de forma segura y luego añade únicamente los permisos que requiera la integración.

- Selecciona API key & permissions.
- En API permissions, haz clic en Add permissions.
- Filtra por categoría o busca por nombre de permiso o ámbito.
- Selecciona cada permiso requerido. Por ejemplo, los permisos de contactos se dividen en ámbitos de lectura, creación o actualización, y eliminación.
- Haz clic en Confirm.

X-API-Key y úsala solo desde código de servidor de confianza. YCloud comprueba que la app esté activa y que la solicitud coincida con uno de sus permisos de API seleccionados. Cuando una API opera sobre un recurso de WhatsApp, YCloud también verifica que la app pueda acceder al número de teléfono o a la WABA correspondiente.
No todas las API de YCloud están disponibles para las apps personalizadas. Toda API que no aparezca en el selector de permisos quedará denegada para la clave de una app personalizada. Las claves de apps personalizadas tampoco pueden combinarse con el encabezado X-Managed-Account-ID.
Consulta Authentication para ver las pautas sobre encabezados de solicitud y gestión de credenciales.
Configurar webhooks
Configura un destino dedicado para los eventos que necesita esta app. Los webhooks de la app son independientes de los endpoints de webhook configurados en Developers > Webhooks.- Selecciona Webhook.
- Introduce tu endpoint HTTPS público en Endpoint URL y guárdalo.
- Guarda de forma segura el Signing secret generado.
- En Added events, haz clic en Add events.

- Filtra por categoría o busca por nombre de evento o tipo de evento.
- Selecciona los eventos que debe recibir tu endpoint.
- Si un evento ofrece opciones de ámbito de datos, elige el ámbito que se ajuste a tu integración.
- Haz clic en Confirm.

2xx correcta con rapidez. Consulta Configurar webhooks para ver instrucciones sobre la validación de firmas, el control de entregas y la seguridad. Consulta Cargas útiles de eventos de webhook para conocer los esquemas de eventos.
Habilitar y verificar la app
Antes de usar la app en producción:- Confirma que la app contenga los números de teléfono de WhatsApp Business esperados.
- Revisa todos los permisos de la API y elimina los accesos que la integración no necesite.
- Vuelve a Developers > Custom apps y habilita la app desde su menú de acciones.

- Confirma que el estado de la app sea Active.
- Envía una solicitud de prueba con la clave de API de la app desde un entorno seguro del lado del servidor.
- Activa un evento seleccionado y confirma que tu endpoint lo valide y procese.

