Gestion de ticket

Aumentar la fidelidad, y la experiencia de usuario, de tu app aún es una tarea que tienes pendiente. ¿A qué no me equivoco?

El caso, es que un buen sistema de comunicación contigo, como desarrollador, por parte de tus usuarios, es una manera de profesionalizar la app, mejorar la experiencia de usuario y aumentar su fidelidad.

Bien,

Quizás esta no sea la mejor manera de hacerlo, eso va en los gustos.

O si es la manera de enfocarlo, eso es cuestión de prioridades.

Lo que no va de gustos, ni en las prioridades… es que, por Perro, te estás dejando pasta sobre la mesa al no haber implementado un buen sistema de comunicación cliente/desarrollador en tu app.

Presentación

Nuestro sistema de tickets, pone a tu disposición una API sencilla para que recibas las comunicaciones que el usuario quiera hacerte.

Las puedas gestionar desde el panel.

Y, en definitiva, dar un soporte premium a tus usuarios sin calentarte mucho la cabeza.

Parte del panel de IApplication

Una vez ya has registrado tu API Key, y tu app asociada a este API Key, se habrá desbloqueado la opción “Sistema de Tickets”.

Esta opción la podrás encontrar desde el menú lateral, dentro de la opción “Apis y herramientas”.

1) Como crear un flujo de tickets

Una vez dentro de esta opción, lo primero que debes hacer es, en la parte inferior derecha de la app, pulsar sobre el botón de las rayas.

Accederás a “tipos”.

En el modal, seleccionaremos la app que queremos asociar a nuestro flujo.

Una vez seleccionada, si es la primera vez que lo hacemos, solo nos aparecerán las opciones por defecto.

Nota: Hasta que ese paso no se realiza, no se crearán las opciones por defecto asociadas a la app. Por lo que la api que extrae los tipos de ticket que veremos a continuación, no devolverá nada.

Y ya desde aquí podemos crear o copiar el ID de los tipos que hemos creado.

Cerramos este modal.

Volvemos a pulsar el botón hamburguesa y seleccionamos “estados”.

Seleccionamos la app y se crearán y mostrarán las opciones por defecto.

Ahora puedes crear los estados adicionales que quieras.

Nota: Estos estados son de gestión interna, para ti, tu cliente no tendrá acceso a ellos. Es para que lleves un control de su estado.

Y listo, ya tenemos el flujo de tickets para la app seleccionada creado.

Si no se han realizado estos pasos, el flujo no funcionará.

Parte de la integración en el cliente

Tipos de tickets

URL:

https://ia-pplication.com/apps/v1/get-ticket-types

Método:

GET

Cabeceras:

Authorization: Bearer <tu api key>

app-package-name: <El identificador de tu app registrada en la plataforma>

Params:

No necesita.

Respuestas:

403: El API Key enviado no es válido, o no tienen ninguna app asociada.

{ "R0": 403,  "R1": "Prohibido",  "R2": ""}

404: No se ha enviado la cabecera app-package-name.

{"R0": 404, "R1": "No se ha podido completar, faltan datos", "R2": ""}

200: Todo ha ido bien y aquí están los datos.

{
    "R0": 200,
    "R1": [
        {
            "uuid": "N1oweWs4Z2YxSFRncWFWYzNtLTdtMTF0UEgxeEFud0RtU0V1UmVMSHg1QT0=",
            "name": "General"
        },
        {
            "uuid": "SGtVVXZZNGF5TkVVMy1fTHhBanl0ekRPNnJxSFpiRFphMGVXanhxZUN3ST0=",
            "name": "Palabra faltante o errónea"
        }
    ],
    "R2": ""
}

Como se aprecia, el endpoint devolverá un array con los tipos asociados. El uuid será el que luego haya que enviarse con la creación del ticket.

Subiendo un ticket a la plataforma

URL:

https://ia-pplication.com/apps/v1/register-ticket

Método:

POST

Cabeceras:

Authorization: Bearer <Tu api key>

app-package-name: <El identificador de tu app>

Parámetros:

uuid_type: El uuid que has obtenido al obtener los tipos con el endpoint anterior.

data: La información, en texto, que quieres incluir en el ticket.

contact_mail (opcional): Puedes pedir el mail a tu usuario para ponerte en contacto con él para informar o hablar temas de la incidencia, por ejemplo.

locale (opcional): Puedes extraer el locale del dispositivo y mandarlo por aquí por si quieres categorizar por este tipo de información.

Respuestas:

403: El API Key enviado no es válido, o no tienen ninguna app asociada. O, la app asociada no te pertenece como usuario.

{ "R0": 403,  "R1": "Prohibido",  "R2": ""}

404: No se ha enviado la cabecera app-package-name, el uuid_type o data.

{"R0": 404, "R1": "No se ha podido completar, faltan datos", "R2": ""}