Volty.

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

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:

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

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