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.
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:
Tipo de dato corresponde con el tipo de campo
Validación del valor por campo (built-in y/o personalizado)
Verificación de restricciones (máximo, mínimo, longitud, etc)
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
segmentId*
String
ID del segmento
Query Parameters
version*
String
Tipo de formulario "base" o "contact"
Headers
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
Authorization*
String
Bearer {token}
Content-Type*
String
application/json
Request Body
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
¿Te fue útil?