Uso del panel

Elige primero la organización y luego la aplicación que posee la API key y las conexiones de proveedor. Cada request API y acción del panel debe interpretarse dentro de ese alcance de aplicación.

• Usa una aplicación por entorno de producto cuando staging y producción tengan proveedores distintos.
• Rota API keys desde la misma aplicación que atiende tráfico de producción.
• Mantén estable la metadata de cuentas para que billing y gráficas de uso sigan siendo coherentes.

Usa el panel de conexiones antes de depurar errores de sync o envío. Una conexión puede estar activa, degradada, revocada o incompleta según el estado del token de proveedor y la cobertura de capacidades.

• Revisa proveedor, cuenta, estado, último sync y banderas de capacidad.
• Usa refresh solo cuando existan credenciales y el proveedor soporte la capacidad solicitada.
• Cuando un proveedor no soporte una conducta, espera `provider_capability_not_supported` en lugar de un fallback silencioso.

Crea keys de privilegio mínimo para workers de producción y keys separadas para desarrollo local. Revisa límites de uso antes de activar sync de alto volumen o jobs de replay de webhooks.

Usa las vistas de entregas webhook para inspeccionar estado, intentos, latencia, código de respuesta y dead-letter. Reproduce entregas solo después de arreglar el endpoint receptor.

Las herramientas de solo lectura pueden ejecutarse directamente. Las escrituras externas, envío de email, cambios de reserva y operaciones destructivas deben crear aprobaciones visibles en el panel y vinculadas al historial de ejecución.