Notice: Undefined index: id_articulo in /PageGearCloud/www/html/es/modulos/soporte/soporte.api.php on line 63

Notice: Undefined index: id_tema in /PageGearCloud/www/html/es/modulos/soporte/soporte.api.php on line 63

Notice: Undefined index: id_tema in /PageGearCloud/www/html/es/modulos/soporte/soporte.api.php on line 64

Notice: Undefined index: id_articulo in /PageGearCloud/www/html/es/modulos/soporte/soporte.api.php on line 65

Notice: Undefined index: id_consejo in /PageGearCloud/www/html/es/modulos/soporte/soporte.api.php on line 68

Personalizar archivos JSON para los bot

¿Que es un archivo JSON?

JSON es un formato de texto que forma parte del sistema de JavaScript y que se deriva de su sintaxis, pero no tiene como objetivo la creación de programas, sino el acceso, almacenamiento e intercambio de datos. Usualmente es conocido como una alternativa al lenguaje XML.

La sintaxis de JSON funciona de modo similar a JavaScript. Por ejemplo:

  • El arreglo de información se hace mediante claves (keys).
  • La información se separa por comas.
  • Las llaves agrupan objetos.
  • Los corchetes agrupan arreglos de datos.

Sin embargo, JSON se distingue de JavaScript porque sus claves tienen que ser strings (o secuencias de caracteres), mientras que sus valores deben ser strings, números, objetos, arreglos, boleados o null.


Ejemplo:

{
"clave" : "Valor",
"clave" : "Valor",
"clave" : "Valor",
}

¿Para qué sirve un archivo JSON?

Un archivo JSON es un documento digital creado en este lenguaje que almacena información organizada, con el fin de hacer más simple su búsqueda y acceso. La ventaja de este formato es que permite obtener código legible para las personas con nombres y valores que funcionan como indicadores de la información que contienen.

Estructura JSON para los bots

El archivo para importar un bot tiene la siguiente estructura: 

[
    {
     "id": 1,
     "id_parent": 0,
     "label": "Nombre rama",
     "header": "",
     "footer": ",
   }
]
  • "id":   Es un identificador numérico para asociarlo  con otras ramas.
  • "id_parent":  Es el identificador con el que se le asocia una rama padre, es decir que esta rama pertenece a otra, si se envía en 0 significa que es una rama principal.
  • "label":  Es el nombre de la rama.
  • "footer": Es el mensaje final que se envía apenas se terminen las acciones.
  • "header":  Es un JSON parseado como string con las acciones a realizar en esta rama, ejemplo:
[
    {
     "tipo": "",
     "contenido": "",
     "name": "",
     "action": "",
     "id_etiqueta": "",
     "url": "",
     "secret": "",
     "input": "",
     "inputResponse": "",
     "fallbackResponse": "",
     "inputRequired": "",
     "id_usuario": "",
     "nombre": "",
     "id_flowintent": "",
     "varname": "",
     "varvalue": "",
     "gptKey": "",
     "temas": "",
     "profession": "",
     "tone": "",
     "style": "",
     "emojis": "",
   }
]
  • "tipo": Tipo de acción a realizar pueden ser  ´imagen´, ´archivo´,´texto´,´callback´
  • "contenido": Es el mensaje a enviar al chat, si es tipo archivo o imagen se debe enviar aca la url del archivo
  •  "name": Nombre para identificar la acción
  • "action": Si es una Acción Automatizada se envía este campo con el tipo de acción que pueden ser las siguientes: 
  1. ´addTag´: Agregar etiqueta a la conversación.
  2. ´input´:  Captura de datos de usuario.
  3. ´userDelegate´ : Transferir conversación a un usuario.
  4. ´teamDelegate´ : Transferir conversación a un equipo.
  5. ´intentRedirect´ : Redirigir a una opción del bot.
  6. ´webhook´: Enviar notificación HTTP (Webhook).
  7. ´callback´: Callback HTTP (Webhook + Response) .
  8. ´addVar´:  Establecer variable.
  9. ´exit´:  Terminar ejecución del menú.
  10. ´dialogflow´: Responder con Dialogflow.
  11. ´chatgpt´: Responder con ChatGPT.
  12. ´endChat´ Finalizar chat.
  • "id_etiqueta": Si la acción es ´addTag´ enviar el id de la etiqueta a agregar.
  • "url":  La url donde se enviará el callback o webhook.
  • "secret":  Token para conectarse al callback o webhook.
  • "input": Tipo de input a mostrar puede ser alguno de estos: 
  1. ´nombre´: Nombres y Apellidos.
  2. ´email´: Correo Electrónico.
  3. ´celular´: Número Telefónico / Celular.
  4. ´ciudad´: Ciudad o Dirección.
  5. ´fechacumple´: Fecha de Cumpleaños.
  6. ´texto´: Capturar Texto.
  7. ´numero´: Capturar Número.
  8. ´fecha´: Capturar Fecha/Hora.
  • "inputResponse": Pregunta de captura de datos.
  • "fallbackResponse": Respuesta en caso de error.
  • "inputRequired": En este caso se pedirá al usuario que ingrese la información solicitada sin importar si la ha ingresado previamente o si esta guardada en el sistema.
  • "id_usuario": Id del usuario al que se quiera delegar la conversación.
  • "nombre":  Nombre del usuario al que se le va a delegar la conversación.
  • "id_flowintent":  Id de la rama del bot a la que quieres enviar.
  • "varname": Nombre de la variable al establecer una variable.
  • "varvalue": Valor de la variable a establecer.
  • "gptKey":  Llave de chatGPT para enlazar al bot.
  • "temas":  Base de conocimiento de chatGPT en un array de objetos, ejemplo: 
[
    {
     "titulo": "",
     "detalles": "",
   }
]
  • "profession": Opción de ChatGPT puede ser alguna de las siguientes: 
  1. ´asesor´: Asesor de Servicio al Cliente.
  2. ´vendedor´: Vendedor Estrella.
  3. ´gerente´: Gerente de Empresa.
  4. ´financiero´: Especialista en Finanzas.
  5. ´secretaria´: Secretaria / Asistente.
  6. ´creativo´: Creativo / Innovador.
  • "tone": Opción de ChatGPT puede ser alguna de las siguientes: 
    1. ´Formal´: Formal.
    2. ´Authoritative´: Autoritario
    3. ´Clinical´: Clínico.
    4. ´Cold´: Frío.
    5. ´Confident´: Confidente.
    6. ´Cynical´: Cínico.
    7. ´Emotional´: Emocional.
    8. ´Empathetic´: Empático.
    9. ´Friendly´: Amigable.
    10. ´Humorous´: Jocoso.
    11. ´Informal´: Informal.
    12. ´Ironic´: Irónico.
    13. ´Optimistic´: Optimista.
    14. ´Pessimistic´: Pesimista.
    15. ´Playful´: Juguetón.
    16. ´Sarcastic´: Sarcástico.
    17. ´Serious´: Serio.
    18. ´Sympathetic´: Compasivo.
    19. ´Tentative´: Tentativo.
    20. ´Warm´: Cálido.
  • "style": Opción de ChatGPT puede ser alguna de las siguientes: 
  1. ´Formal´: Formal.
  2. ´Academic´: Académico.
  3. ´Analytical´: Analítico.
  4. ´Argumentative´: Argumentativo.
  5. ´Conversational´: Conversacional.
  6. ´Creative´: Creativo.
  7. ´Critical´: Crítico.
  8. ´Descriptive´: Descriptivo.
  9. ´Epigrammatic´: Epigramático.
  10. ´Epistolary´: Epistolar.
  11. ´Expository´: Expositivo.
  12. ´Informative´: Informativo.
  13. ´Instructive´: Instructivo.
  14. ´Journalistic´: Periodístico.
  15. ´Metaphorical´: Metafórico.
  16. ´Narrative´: Narrativo.
  17. ´Persuasive´: Persuasivo.
  18. ´Poetic´: Poético.
  19. ´Satirical´: Satírico.
  20. ´Technical´: Técnico.
  • "emojis": Incluir emojis en las respuestas.