Listar envíos de formulario en Webflow, con una API
Lista los envíos de un formulario, con las respuestas en formResponse y la fecha en dateSubmitted. La respuesta tiene pagination con limit, offset y total: la última página es cuando offset más limit alcanza total.
- Identificador
- webflow_list_form_submissions
La llamada
POST https://connect.reportei.com/api/tools/webflow_list_form_submissions/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"form_id": "<form_id>"
}
}Tu sistema envía el id de la conexión de tu cliente y los argumentos de la tool. Los headers son los mismos de toda la API de Connect: el token de tu producto y el token de tu cliente.
Parámetros
Las descripciones de los parámetros siguen la documentación oficial de la app, en inglés.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| form_id | string | Sí | Id of the form, from List forms. |
| limit | integer | No | Submissions per page, up to 100. |
| offset | integer | No | How many submissions to skip, for the next pages. |
Conexiones posibles
Tu cliente conecta su cuenta de Webflow una sola vez, con uno de los modos de abajo. La misma conexión sirve para todas las tools del toolkit.
Clave de API
Tu cliente pega la clave de la app en una pantalla de Connect, o tu sistema envía la clave con POST /api/customer-toolkits, sin pantalla.
OAuth con la app de tu producto
Registras la app OAuth de tu producto una sola vez, con POST /api/merchants/credentials/webflow, y tu cliente autoriza la cuenta en una pantalla de consentimiento. Connect renueva el token cuando está por vencer.
La respuesta
Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app. Los errores HTTP devueltos por la app usan el objeto {error, api_error}; la autenticación o validación pueden fallar antes de la ejecución. El header X-Toolkit-Execution-Id identifica la ejecución registrada, disponible en GET /api/tools/executions/{uuid}.
Lista para agentes de IA
El input de esta tool es un JSON Schema, disponible en GET /api/tools/webflow_list_form_submissions. Se convierte en la definición de tool de tu agente sin conversión.
Otras tools de Webflow
- Listar sitiosGETLista los sitios a los que llega la conexión, con el id que piden las demás herramientas como site_id y los customDomains de cada sitio con sus ids. Un token de sitio llega solo a su propio sitio.
- Publicar sitioPOSTPublica el sitio con todos los cambios pendientes en los dominios elegidos. Envía customDomains, publishToWebflowSubdomain o ambos. Webflow permite una publicación exitosa por minuto.
- Listar coleccionesGETLista las colecciones del CMS de un sitio, con el id que piden las herramientas de ítems como collection_id.
- Obtener colecciónGETDevuelve una colección con sus campos: el slug, type e isRequired de cada uno. Los slugs de los campos son las claves de fieldData en Crear ítem de la colección y Actualizar ítem de la colección.
- Listar ítems de la colecciónGETLista los ítems de una colección tal como están antes de publicar, borradores incluidos, con fieldData indexado por el slug del campo. La respuesta tiene pagination con limit, offset y total: la última página es cuando offset más limit alcanza total.
- Obtener ítem de la colecciónGETDevuelve un ítem de una colección tal como está antes de publicar, con su fieldData, isDraft e isArchived.
- Crear ítem de la colecciónPOSTCrea un ítem en una colección y lo devuelve. El ítem es un borrador salvo que isDraft sea false, lo que lo pone en cola para la próxima publicación del sitio. Para ponerlo en vivo de inmediato, usa Publicar ítems de la colección.
- Actualizar ítem de la colecciónPATCHActualiza un ítem de una colección y lo devuelve. Solo cambian los campos enviados en fieldData. Los cambios en un ítem que ya está en vivo llegan al sitio con Publicar ítems de la colección o Publicar sitio.
Toolkits de la misma categoría
Ver los 100 toolkitsMira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
