¿Cómo podemos ayudarte?

Al informar un problema de integración, proporcionar información clara y relevante ayuda al equipo de soporte a comprender el servicio afectado, reproducir el problema cuando sea posible e identificar la causa probable. Una solicitud de soporte útil debe describir lo que intentaste, lo que esperabas y lo que realmente sucedió. Información a incluir 1. Nombre de la integración Identifica la aplicación o servicio externo involucrado. 2. Descripción del problema Explica la operación que falló o produjo un resultado inesperado. 3. Comportamiento esperado Describe lo que debería haber sucedido. 4. Comportamiento real Describe lo que sucedió en su lugar. 5. Mensaje de error Incluye el texto exacto del error o el código de estado si está disponible. 6. Marca de tiempo aproximada Proporciona la fecha, hora y zona horaria cuando ocurrió el problema. 7. Operación afectada Identifica la acción de integración, flujo de trabajo, automatización o proceso de negocio relevante. 8. Frecuencia Explica si el problema ocurre de manera constante o intermitente. 9. Cambios recientes Menciona cambios recientes en la cuenta, permisos, configuración o autorización. 10. Solución de problemas ya intentada Describe los pasos que tomaste antes de contactar al soporte. 11. Impacto en el negocio Explica si el problema impide una operación crítica, afecta a los clientes o causa retrasos. 12. Evidencia de apoyo Incluye capturas de pantalla relevantes o detalles de diagnóstico no sensibles cuando estén disponibles. Ejemplo de solicitud de soporte Asunto: Problema de conexión de integración Integración: [Nombre del servicio externo] Operación afectada: [Descripción de la operación] El problema comenzó: [Fecha y hora con zona horaria] Resultado esperado: [Lo que debería suceder] Resultado real: [Lo que sucedió] Mensaje de error: [Mensaje de error exacto] Cambios recientes: [Cambios relevantes, si los hay] Solución de problemas completada: [Pasos ya intentados] Impacto en el negocio: [Descripción de las operaciones afectadas] ¿Qué información nunca debe compartirse? No incluyas: 1. Contraseñas. 2. Claves API. 3. Tokens de acceso OAuth. 4. Tokens de actualización OAuth. 5. Secretos de cliente. 6. Secretos de firma de Webhook. 7. Credenciales de autenticación privadas. 8. Información personal innecesaria del cliente. 9. Registros comerciales sensibles no relacionados con el problema. Si una captura de pantalla contiene información confidencial, redáctala antes de compartirla. ¿Debo desconectar la integración antes de contactar al soporte? No automáticamente. Desconectar o reautorizar una integración puede cambiar su estado y dificultar la investigación del problema original. Si se sospecha que la integración tiene actividad no autorizada, prioriza la contención de seguridad adecuada. ¿Qué pasa si el problema afecta una operación comercial importante? Describe claramente el impacto en el negocio y si la operación está completamente bloqueada o solo parcialmente afectada. ¿Qué pasa si el proveedor externo está experimentando una interrupción? Incluye cualquier información relevante sobre el estado del proveedor y el tiempo aproximado en que comenzó el problema. ¿Puede el soporte garantizar la recuperación de operaciones externas fallidas? La recuperación depende de la operación, el comportamiento del proveedor externo y los mecanismos de reintento o recuperación disponibles. No asumas que cada operación fallida puede ser reproducida automáticamente. Enfoque recomendado Envía un informe conciso pero completo con el error exacto, la integración afectada, las marcas de tiempo relevantes y el impacto en el negocio. Esto ayuda a reducir el ir y venir innecesario y apoya una investigación más efectiva.