¿Qué es un webhook?
En términos generales, un webhook es simplemente una notificación automática que se envía a través de la web cuando sucede un evento determinado.
En este caso, el evento es un nueva respuesta desde la aplicación. Cuando tus usuarios finalizan el formulario, sus respuestas se envían a través de una notificación automática al destino que hayas escogido — el Webhook URL que hayas determinado.
Las notificaciones webhook de DataScope se envían en una petición HTTP POST, y su contenido (que contiene los datos de la respuesta) está en formato JSON.
Formato JSON respuesta
[{
"form_name": "[Nombre formulario] (String)",
"form_state": "[Estado del formulario]",
"code": "[Código del formulario] (String)",
"created_at": "[Fecha sincronización] (DateTime) YYY-MM-DD HH:MM",
"started_at": "[Fecha inicio] (DateTime)",
"latitude": "[latitude] (Float)",
"longitude": "[longitude] (Float)",
"user_info": {
"user_name": "[Nombre usuario] (String)",
"username": "[Email Usuario] (String)"
},
"[question_name][question_id]": {
"name": "[Nombre Pregunta] (String)",
"question_name": "[Nombre del grupo de preguntas] (String)",
"label": "[Nombre grupo pregunta] (String)",
"row" "[Nº sub-formulario] (Integer) Defecto: null",
"value": "[Valor Respuesta] (String)",
"type": "[Tipo pregunta]*",
"id": "[ID interno pregunta] (Integer)",
"metadata": "[Código Lista] (String)",
"metadata_id": "[Identificador elemento Lista] (Integer)",
"metadata_description": "[Descripción elemento lista] (String)",
"metadata_att1": "[Atributo elemento lista] (String)",
"metadata_att2": "[Atributo elemento lista] (String)"
}
}]
🔧 ¿Cómo configurar un Webhook en DataScope?
Ir a Integraciones
Accede al menú lateral y selecciona la opción Integraciones > Webhooks.Crear nuevo Webhook
📌 Importante: Solo se enviarán datos de formularios completados después de crear y activar el webhook.
Consideraciones técnicas
DataScope envía los datos usando una solicitud HTTP POST.
El servidor que recibe el Webhook debe responder con un código 200 OK para confirmar que recibió los datos correctamente.
Si no se recibe esta confirmación, el sistema reintentará el envío (timeout máximo: 10 segundos).
🔐 Autenticación avanzada (opcional): OAuth 2.0
OAuth 2.0 es un estándar de autorización que permite a tu sistema validar y procesar los datos de forma segura, sin necesidad de compartir contraseñas. Es útil cuando tu endpoint requiere autenticación para recibir y procesar la información.
¿Cuándo se recomienda usar OAuth 2.0?
Aunque un Webhook no suele necesitar autenticación (porque el emisor es de confianza), puedes habilitar OAuth 2.0 si tu servidor receptor necesita interactuar con APIs seguras, validar tokens o registrar acciones autenticadas.
Cómo configurar OAuth 2.0 en DataScope:
Completa los siguientes campos:
URL del Token de Acceso: Endpoint del servicio receptor donde se solicita el token.
ID del Cliente y Llave Secreta del Cliente: Proporcionados por el servicio receptor.
Scope: Define los permisos que el token debe tener.
Haz clic en Guardar Configuración OAuth.
¿No puedes ver esta opción? Comunícate con el equipo de soporte a traves del chat
---------------------------------------------------------------------------------------
Artículos Relacionados
---------------------------------------------------------------------------------------