Volty — Soporte
Cómo contactarnos, reportar bugs y proponer mejoras.
📡 Canales de comunicación
| Canal | Para qué | SLA típico |
|---|---|---|
| 📧 Email (danna@volty.mx) | Bugs, dudas técnicas, integración, soporte general | <24h horario laboral |
| 📧 Email urgente (incidentes@volty.mx) | Incidentes producción, security, data leak | <2h cualquier hora |
Horario laboral: Lun-Vie 9:00-19:00 GMT-6 (CDMX).
🐛 Cómo reportar un bug efectivamente
Un buen bug report ahorra horas de ida y vuelta. Para que podamos resolver rápido, incluye:
Información esencial
**Qué hiciste:**
1. Llamé a POST /v1/clientes con este payload:
{ "nombre": "Cliente X" }
2. Recibí respuesta 500
**Qué esperabas:**
Un cliente nuevo creado con status 201
**Qué pasó realmente:**
Status 500 con body:
{ "detail": "Internal server error" }
**Timestamp aproximado:**
2026-05-31 14:32 CDMX
**Request ID (si lo tienes):**
volty-req-abc123 (lo ves en el header X-Request-Id de la respuesta)
**API key prefix usado:**
volty_test_a4kZ (los primeros 16 chars, NO la key completa)
**Cosa que ya intentaste:**
- Repetir el request 3 veces (sigue fallando)
- Validé que mi API key sirve con GET /v1/auth/info → 200 ok
Plantilla copy-pasteable
🐛 **Bug report — {fecha corta}**
**Endpoint:**
**Método HTTP:**
**Request body:**
```json
{ ... }
```
**Response status:**
**Response body:**
```json
{ ... }
```
**Esperaba:**
**Pasó:**
**Timestamp:**
**Request ID (header X-Request-Id):**
**API key prefix:**
**Ya intenté:** [lista de cosas]
Lo que NO incluir nunca
- ❌ Tu API key completa (solo el prefijo de 16 chars)
- ❌ Passwords de tus clientes finales
- ❌ Cualquier credencial sensible
Si necesitas compartir algo sensible (ej. para reproducir un bug específico), avísanos por email y coordinamos un share seguro con expiración.
💡 Cómo proponer features
Tu opinión nos ayuda a priorizar el roadmap. Para que sea accionable, estructura tu propuesta:
**Problema:**
Cuando intento [X], pasa [Y], lo que me obliga a [workaround feo].
**Por qué importa:**
Esto afecta a [porcentaje/cantidad] de mis clientes finales.
Sin esto, tengo que [costo en tiempo/dinero].
**Solución que se me ocurre:**
[Lo que crees que debería pasar — no te preocupes si no es la mejor solución,
nos dices el problema y entre ambos diseñamos la respuesta]
**Workaround actual:**
[Cómo lo estás resolviendo hoy]
Tip: entre mejor identificado el problema, mejor podemos diseñar la solución. Soluciones específicas a veces atan las manos del diseño.
🚨 Incidentes — qué cuenta como urgente
Manda a incidentes@volty.mx si:
- 🔴 La API responde 5xx en >50% de los requests en los últimos 5 min
- 🔴 Algún recibo aparece con datos manipulados o de otro cliente (data leak — máxima prioridad)
- 🔴 Recibiste un error de seguridad (CORS bloqueado cuando no debería, IP bloqueada, etc.)
- 🔴 Webhooks dejaron de llegar por >30 min cuando hay eventos esperados
- 🔴 Cualquier sospecha de compromiso de seguridad (API key leaked, etc.)
Para todo lo demás (bug que no impide trabajar, lentitud puntual, feature requests, etc.) → email regular.
📊 Status
Si dudas si la API está funcionando, primero verifica directamente:
curl https://staging-api.volty.mx/salud
- Responde 200 verde → Volty operativo. Si algo específico no funciona → bug puntual, repórtalo por email.
- Responde 5xx o no responde → posible incidente nuestro. Avisa por incidentes si es urgente.
🤐 NDA
¿Necesitas NDA firmado antes de mandar credenciales reales de tus clientes? Avísanos por email y te enviamos un template estándar para revisión.
Resumen: estamos disponibles. No dudes en escribir a danna@volty.mx.