Formularios

Te explicamos como utilizar os formularios mediante Rest API.

Con nuestra Rest API de formularios podrás obtener los formularios diseñados en tu cuenta.

Los endpoints a continuación son públicos, es decir, se antepone /public/ como medio diferenciador de endpoints privados.

Para renderizar los formularios te sugerimos utilizar nuestro SDK de formulario.

Formato

Nuestros formularios están cuidadosamente diseñados para presentar un formato amigable y flexible al mismo tiempo.

Todos los formularios que se envíen deben tener el siguiente esquema:

[
    { "_id": String, "value": String || Array || Number }
]

Dentro de este Array debes añadir el listado de campos con su _id y value, siendo este último capaz de recibir tres tipos de datos: String, Number y Array.

El ID debe coincidir con los valores que se entregan al obtener un formulario, es decir, con el campo _id.

Debes considerar que los valores deben coincidir con los configurados en tu cuenta, sobre todo para los casos de selección única o múltiple.

Contamos con 3 niveles de validación:

  1. Tipo de dato corresponde con el tipo de campo

  2. Validación del valor por campo (built-in y/o personalizado)

  3. Verificación de restricciones (máximo, mínimo, longitud, etc)

📄Formularios

Obtener formulario de un segmento

GET https://api.videsk.io/public/video-contact-center/forms/:segmentId

Podrás obtener el formulario de un segmento mediante su ID

Path Parameters

NameTypeDescription

segmentId*

String

ID del segmento

Query Parameters

NameTypeDescription

version*

String

Tipo de formulario "base" o "contact"

Headers

NameTypeDescription

Authorization*

String

Bearer {token}

Content-Type*

String

application/json

{
   "form":[
      {
         "_id":"60f652f1cfa34fc3157ef5c6",
         "type":"text",
         "name":"firstname",
         "label":"Nombre",
         "properties":{
            "required":true,
            "placeholder":"Ingrese su nombre..."
         },
         "options":[],
         "hint":""
      },
      {
         "_id":"61d25bc9294d18677ce6ef6f",
         "type":"text",
         "label":"Apellido",
         "properties":{
            "placeholder":"Ingrese su apellido",
            "maxlength":"50"
         },
         "name":"lastname",
         "hint":"",
         "options":[]
      },
      {
         "_id":"60f652f1cfa34fc3157ef5c7",
         "type":"email",
         "name":"email",
         "label":"Correo electrónico",
         "properties":{
            "required":true,
            "placeholder":"Ingrese su email..."
         },
         "options":[],
         "hint":""
      },
      {
         "_id":"60f654b4cfa34fc3157ef5cc",
         "type":"text",
         "label":"Nombre de la empresa",
         "properties":{
            "placeholder":"Ingrese nombre de la empresa...",
            "maxlength":"50",
            "required":true
         },
         "name":"company",
         "hint":"",
         "options":[]
      },
      {
         "_id":"60f654b4cfa34fc3157ef5cd",
         "type":"url",
         "label":"Sitio web",
         "properties":{
            "placeholder":"Ingrese un enlace con http://",
            "required":true
         },
         "name":"website",
         "hint":"Debe anteponer http:// o https://",
         "options":[
            
         ]
      },
      {
         "_id":"61d25bc9294d18677ce6ef73",
         "type":"text",
         "label":"Industria",
         "properties":{
            "placeholder":"Ingrese la industria del negocio",
            "maxlength":"100"
         },
         "name":"industry",
         "hint":"",
         "options":[]
      },
      {
         "_id":"60f654b4cfa34fc3157ef5ce",
         "type":"textarea",
         "label":"Mensaje",
         "properties":{
            "placeholder":"Déjanos tu mensaje y te contactaremos.",
            "maxlength":"250"
         },
         "name":"message",
         "hint":"",
         "options":[]
      }
   ],
   "siteKey":"XXXXXXXXXXXXXXX",
   "resource":"https://challenges.cloudflare.com/turnstile/v0/api.js",
   "provider":"turnstile"
}

Enviar encuesta

POST https://api.videsk.io/public/video-contact-center/forms

Podrás enviar un formulario el cuál se podrá adjuntar a una llamada o no.

Headers

NameTypeDescription

Authorization*

String

Bearer {token}

Content-Type*

String

application/json

Request Body

NameTypeDescription

segment*

String

ID del segmento

type*

String

Tipo de formulario "contact" o "pre-call"

values*

Array

Listado de campos

values._id*

String

ID del campo

values.value*

String

Valor del campo

token

String

Token captcha (no backend)

{
   "message":"The form was saved successfully.",
   "success":true,
   "submission":"64a35822da9f12295c1d98dc"
}

Última actualización