Formulario Creado

Existen tres formas de crear un nuevo formulario en Persat

• Desde la web

• Desde la app de Android

• Desde la API - No dispara el evento

De estar configurado el webhook, tanto los formularios creados desde la web como desde la app de Android, disparan el evento digitalform.created.

Si desea configurar los webhooks siga los pasos en Configurar webhooks

Datos enviados en el evento

Los datos son enviados mediante una consulta HTTP POST, en donde el body contiene el siguiente texto en formato JSON. En el ejemplo se muestra un formulario con 3 widgets en su plantilla (schema_id: 129)

{
   "eventType":"digitalform.created",
   "payload":{
      "_id":"23391",
      "created":"2021-07-28T18:15:07.000Z",
      "created_by_user_name":"[e-mail]",
      "created_by_user_id":24,
      "client":{
         "id":24766,
         "name":"Persat",
         "uid_client":"CL-Test_001"
      },
      "df_data":{
         "schema_id":129,
         "results":{
            "last_updated":"2021-07-28T18:15:07.000Z",
            "formvalues":{
               "FWqNcCBuS":"Camisa a cuadros",
               "FWNd3DqkM":"Primer linea\nCon otro color",
               "FWyletnTs": 23.33
         }
      },
      "state": {
         "color": "BLUE",
         "deleted": false,
         "id": 26,
         "name": "Listo"
      },
      "user": {
         "id": 24,
         "name": "[e-mail]"
      }
   }
}

Analizando el evento recibido

eventType: Tipo de evento. Para el caso de nuevo formulario, siempre será "digitalform.created".

payload: Son los datos completos del formulario, ver la sección Obtener Formulario.

user.id: Id del usuario que generó el evento. Se puede obtener el real_name u otros campos de interés de Listar Usuarios.

user.name: Email del usuario que generó el evento.

En este evento "digitalform.created", el created_by_user_id del formulario coincide con el user.id que generó el evento.