formbasedocs
Ir a la appApp

Disponible en el plan Free

Esto funciona en todos los planes, incluido Free. Comparar planes →

Integraciones

Axiom

Consulta los eventos en bruto del formulario con APL, crea dashboards y monitores, y opcionalmente envía las respuestas completas.


Conectar Axiom

  1. 1

    Crea un dataset

    Crea o elige el dataset de Axiom que debe recibir los registros de formbase.

  2. 2

    Crea un token de ingestión

    Crea un token de API con permiso para ingerir datos en ese dataset.

  3. 3

    Conecta en formbase

    Abre Espacio de trabajo → Integraciones → Analíticas, pulsa Conectar en Axiom, introduce el Dataset y el API token, elige la Región, y pulsa Conectar.

  4. 4

    Envía un evento de prueba

    Abre cualquier formulario → Configuración → Integraciones → Streaming de analíticas y haz clic en Enviar evento de prueba.

Las dos regiones disponibles son US East 1 (AWS) y EU Central 1 (AWS). Elige aquella en la que vive tu organización de Axiom — formbase deriva de ahí el endpoint de ingestión, y ingerir en la región equivocada se rechaza.

Eventos de analíticas

Conectar Axiom activa el reenvío de eventos sin respuestas para cada formulario del espacio de trabajo. Los registros usan los nombres de evento form_view, form_engaged y form_submit, con los mismos parámetros documentados en Streaming de analíticas.

['your-dataset']
| where ['event'] in ('form_view', 'form_engaged', 'form_submit')
| summarize events=count() by ['event']

Cada registro aplana los parámetros del evento a nivel superior, de modo que form_id, source, device y el resto son columnas normales que puedes filtrar y resumir.

El reenvío de eventos es best-effort y no se reintenta. Desactívalo para un formulario en Configuración del formulario → Integraciones → Streaming de analíticas → Reenviar eventos de analíticas.

Respuestas de los encuestados

Axiom también puede recibir un registro completo por cada respuesta completada. Este flujo está desactivado por defecto y debe habilitarse por separado para cada formulario con Enviar respuestas del encuestado.

Un registro de respuesta es el mismo sobre de evento que recibe un webhook personalizado, más un campo _time de Axiom: el id del evento, el tipo, createdAt, apiVersion y test, y bajo data el formulario, la respuesta (id, correo del encuestado, hora de envío, enlace del PDF, idioma), un objeto answers indexado por clave de campo y un objeto display con las mismas claves como texto legible. Las respuestas que contestaron una solicitud también llevan un bloque request con tu id externo y metadatos. La forma completa está en la referencia de webhooks.

Las respuestas se transmiten cuando un envío se completa y de nuevo cuando un encuestado lo edita. Los borradores abandonados nunca llegan a Axiom por esta vía — el streaming de respuestas no tiene ventana de inactividad.

Entrega de respuestas y fallos

Los registros de respuestas usan la cola de entrega de envíos: hasta 5 intentos con retroceso exponencial. Tras 20 fallos consecutivos, el destino deja de encolarse, de modo que un token inválido o un dataset rechazado no genere una entrega fallida por cada respuesta nueva. Guardar un nuevo API token borra el error y reanuda la entrega.

El reenvío de eventos y el streaming de respuestas tienen interruptores independientes. Puedes enviar respuestas sin eventos, eventos sin respuestas, ambos, o ninguno para cada formulario.

Solución de problemas

ProblemaComprueba
Prueba rechazadaEl dataset existe, el token tiene permiso de ingestión, y la región elegida coincide con tu organización de Axiom.
Llegan eventos pero no respuestasHabilita Enviar respuestas del encuestado en ese formulario específico.
Las respuestas se detuvieron20 entregas seguidas fallaron. Restaura el acceso al dataset y guarda un nuevo API token.
Aparecen formularios equivocadosFiltra por form_id o desactiva el reenvío de eventos en los formularios que deban quedar fuera.

Próximos pasos