ventiapp/Documentación

Guía operativa para crear y gestionar tickets de desarrollo en Ventiapp

Si usas el API de Ventiapp y tienes una duda o encontraste un error, los Tickets de Desarrollo te conectan directamente con el equipo de desarrolladores. Aquí te explicamos cómo crearlos, darles seguimiento y responderlos.

¿Cuándo usar un Ticket de Desarrollo?

Usa un Ticket de Desarrollo cuando tu consulta tenga que ver con el API. Si tu duda es sobre el uso general de la plataforma (canales, ventas, reportes, tu plan, etc.), crea un Ticket de soporte general.


Tipo de ticket

Úsalo cuando

Consulta general

Tienes dudas sobre el uso del API, la autenticación o la documentación.

Problema técnico

Un endpoint falla o devuelve una respuesta inesperada.


Cómo crear un Ticket de Desarrollo

  1. Entra a Ayuda desde el menú de tu cuenta.
  2. En el Centro de Soporte, haz clic en Nuevo ticket.
  3. Selecciona la pestaña Ticket de Desarrollo (la pestaña Ticket es para soporte general).
  4. Elige el tipo de consulta y llena el formulario.


Ticket Consulta general

Completa los siguientes campos:

  • Asunto: resume tu duda en una línea. Por ejemplo: ¿Cómo renuevo el token de acceso?
  • Descripción: cuéntanos con detalle en qué podemos ayudarte.
  • Adjuntos (opcional): capturas de pantalla o PDFs que ayuden a entender tu consulta.
ticket-consulta-general-2.ticket-consulta-general



Ticket Problema técnico

Completa los siguientes campos:

  • Asunto: un título breve del error.
  • Método HTTP: por ejemplo, GET o POST.
  • URL: el endpoint que estás llamando.
  • JSON de la llamada: el cuerpo de la petición que enviaste (si no aplica, escribe N/A).
  • JSON de la respuesta: la respuesta que recibiste.
  • Descripción del problema: qué esperabas que pasara y qué pasó realmente.
  • cURL: el comando cURL que reproduce el error.
  • Adjuntos (opcional): capturas de pantalla o PDFs.


ticket-problema-tecnico-2.ticket-problema-tecnico
Mientras más completa sea la información del ticket, más rápido el equipo podrá reproducir y resolver el problema. El cURL, la respuesta del API y una descripción clara de lo esperado vs. lo obtenido son lo más útil.


Cómo ver el listado de tus tickets

  1. Entra a Ayuda.
  2. Haz clic en Tickets.

Verás todos tus tickets (de soporte general y de desarrollo) en un solo listado, del más reciente al más antiguo. Los tickets de desarrollo se distinguen por un badge morado que dice “Desarrollo”.

En la parte superior del listado encontrarás un resumen con el total de tickets, cuántos están abiertos y cuántos cerrados. Además, puedes:

  • Filtrar por estado: Abiertos o Cerrados.
  • Buscar por asunto o por número de ticket (por ejemplo, VENTIAPP-3).
tag-en-el-listado-de-tickets-generados



¿Te fue útil este artículo?