Google Forms é a ferramenta online de pesquisas e formulários do Google que permite aos usuários criar formulários, coletar respostas e analisar resultados. Como parte do suite de produtividade do Google, o Google Forms facilita reunir informações, feedback e dados dos usuários.
Saiba como integrar a ferramenta Google Forms no Zoen para ler e processar automaticamente respostas de formulários nos seus fluxos de trabalho. Este tutorial mostra como conectar o Google Forms, recuperar respostas e usar os dados coletados para alimentar automações. Perfeito para sincronizar resultados de pesquisas, registros ou feedback com seus agentes em tempo real.
Com o Google Forms, você pode:
- Criar pesquisas e formulários: Projetar formulários personalizados para feedback, registro, quizzes e muito mais
- Coletar respostas automaticamente: Reunir dados dos usuários em tempo real
- Analisar resultados: Ver respostas no Google Forms ou exportar para o Google Sheets para análise adicional
- Colaborar facilmente: Compartilhar formulários e trabalhar com outras pessoas para criar e revisar perguntas
- Integrar com outros serviços Google: Conectar-se ao Google Sheets, Drive e mais
No Zoen, a integração Google Forms permite que seus agentes acessem respostas de formulários de forma programática. Isso viabiliza cenários poderosos de automação, como processar dados de pesquisas, disparar fluxos de trabalho com base em novos envios e sincronizar resultados de formulários com outras ferramentas. Seus agentes podem buscar todas as respostas de um formulário, recuperar uma resposta específica e usar os dados para impulsionar automação inteligente. Ao conectar o Zoen ao Google Forms, você pode automatizar a coleta de dados, agilizar o processamento de feedback e incorporar respostas de formulários às capacidades do seu agente.
Integrate Google Forms into your workflow. Read form structure, get responses, create forms, update content, and manage notification watches.
Retrieve a single response or list responses from a Google Form
| Parameter | Type | Required | Description |
|---|
formId | string | Yes | Google Forms form ID |
responseId | string | No | Response ID - if provided, returns this specific response |
pageSize | number | No | Maximum number of responses to return (service may return fewer). Defaults to 5000. |
pageToken | string | No | Page token from a previous list response to fetch the next page of responses |
filter | string | No | Filter responses, e.g. "timestamp > 2024-01-01T00:00:00Z" (RFC3339 UTC). Only timestamp filters are supported. |
| Parameter | Type | Description |
|---|
responses | array | Array of form responses (when no responseId provided) |
↳ responseId | string | Unique response ID |
↳ createTime | string | When the response was created |
↳ lastSubmittedTime | string | When the response was last submitted |
↳ answers | json | Map of question IDs to answer values |
nextPageToken | string | Token to fetch the next page of responses (null when no more pages) |
response | object | Single form response (when responseId is provided) |
↳ responseId | string | Unique response ID |
↳ createTime | string | When the response was created |
↳ lastSubmittedTime | string | When the response was last submitted |
↳ answers | json | Map of question IDs to answer values |
raw | json | Raw API response data |
Retrieve a form structure including its items, settings, and metadata
| Parameter | Type | Required | Description |
|---|
formId | string | Yes | Google Forms form ID to retrieve |
| Parameter | Type | Description |
|---|
formId | string | The form ID |
title | string | The form title visible to responders |
description | string | The form description |
documentTitle | string | The document title visible in Drive |
responderUri | string | The URI to share with responders |
linkedSheetId | string | The ID of the linked Google Sheet |
revisionId | string | The revision ID of the form |
items | array | The form items (questions, sections, etc.) |
↳ itemId | string | Item ID |
↳ title | string | Item title |
↳ description | string | Item description |
settings | json | Form settings |
publishSettings | json | Form publish settings |
Create a new Google Form with a title
| Parameter | Type | Required | Description |
|---|
title | string | Yes | The title of the form visible to responders |
documentTitle | string | No | The document title visible in Drive (defaults to form title) |
unpublished | boolean | No | If true, create an unpublished form that does not accept responses |
| Parameter | Type | Description |
|---|
formId | string | The ID of the created form |
title | string | The form title |
documentTitle | string | The document title in Drive |
responderUri | string | The URI to share with responders |
revisionId | string | The revision ID of the form |
Apply multiple updates to a form (add items, update info, change settings, etc.)
| Parameter | Type | Required | Description |
|---|
formId | string | Yes | Google Forms form ID |
requests | json | Yes | Array of update requests (updateFormInfo, updateSettings, createItem, updateItem, moveItem, deleteItem) |
includeFormInResponse | boolean | No | Whether to return the updated form in the response |
| Parameter | Type | Description |
|---|
replies | array | The replies from each update request |
writeControl | object | Write control information with revision IDs |
↳ requiredRevisionId | string | Required revision ID for conflict detection |
↳ targetRevisionId | string | Target revision ID |
form | object | The updated form (if includeFormInResponse was true) |
↳ formId | string | The form ID |
↳ info | object | Form info containing title and description |
↳ title | string | The form title visible to responders |
↳ description | string | The form description |
↳ documentTitle | string | The document title visible in Drive |
↳ settings | object | Form settings |
↳ quizSettings | object | Quiz settings |
↳ isQuiz | boolean | Whether the form is a quiz |
↳ emailCollectionType | string | Email collection type |
↳ revisionId | string | The revision ID of the form |
↳ responderUri | string | The URI to share with responders |
↳ linkedSheetId | string | The ID of the linked Google Sheet |
↳ publishSettings | object | Form publish settings |
↳ publishState | object | Current publish state |
↳ isPublished | boolean | Whether the form is published |
↳ isAcceptingResponses | boolean | Whether the form is accepting responses |
Update the publish settings of a form (publish/unpublish, accept responses)
| Parameter | Type | Required | Description |
|---|
formId | string | Yes | Google Forms form ID |
isPublished | boolean | Yes | Whether the form is published and visible to others |
isAcceptingResponses | boolean | No | Whether the form accepts responses (forced to false if isPublished is false) |
| Parameter | Type | Description |
|---|
formId | string | The form ID |
publishSettings | json | The updated publish settings |
↳ publishState | object | The publish state |
↳ isPublished | boolean | Whether the form is published |
↳ isAcceptingResponses | boolean | Whether the form accepts responses |
Create a notification watch for form changes (schema changes or new responses)
| Parameter | Type | Required | Description |
|---|
formId | string | Yes | Google Forms form ID to watch |
eventType | string | Yes | Event type to watch: SCHEMA (form changes) or RESPONSES (new submissions) |
topicName | string | Yes | The Cloud Pub/Sub topic name (format: projects/{project}/topics/{topic}) |
watchId | string | No | Custom watch ID (4-63 chars, lowercase letters, numbers, hyphens) |
| Parameter | Type | Description |
|---|
id | string | The watch ID |
eventType | string | The event type being watched |
topicName | string | The Cloud Pub/Sub topic |
createTime | string | When the watch was created |
expireTime | string | When the watch expires (7 days after creation) |
state | string | The watch state (ACTIVE, SUSPENDED) |
List all notification watches for a form
| Parameter | Type | Required | Description |
|---|
formId | string | Yes | Google Forms form ID |
| Parameter | Type | Description |
|---|
watches | array | List of watches for the form |
↳ id | string | Watch ID |
↳ eventType | string | Event type (SCHEMA or RESPONSES) |
↳ createTime | string | When the watch was created |
↳ expireTime | string | When the watch expires |
↳ state | string | Watch state |
Delete a notification watch from a form
| Parameter | Type | Required | Description |
|---|
formId | string | Yes | Google Forms form ID |
watchId | string | Yes | Watch ID to delete |
| Parameter | Type | Description |
|---|
deleted | boolean | Whether the watch was successfully deleted |
Renew a notification watch for another 7 days
| Parameter | Type | Required | Description |
|---|
formId | string | Yes | Google Forms form ID |
watchId | string | Yes | Watch ID to renew |
| Parameter | Type | Description |
|---|
id | string | The watch ID |
eventType | string | The event type being watched |
expireTime | string | The new expiration time |
state | string | The watch state |
A Trigger is a block that starts a workflow when an event happens in this service.
Trigger workflow from Google Form submissions (via Apps Script forwarder)
| Parameter | Type | Required | Description |
|---|
token | string | Yes | We validate requests using this secret. Send it as Authorization: Bearer <token> or a custom header. |
secretHeaderName | string | No | If set, the webhook will validate this header equals your Shared Secret instead of Authorization. |
triggerFormId | string | No | Optional, for clarity and matching in workflows. Not required for webhook to work. |
includeRawPayload | boolean | No | Include the original payload from Apps Script in the workflow input. |
setupScript | string | No | Copy this code and paste it into your Google Forms Apps Script editor |
| Parameter | Type | Description |
|---|
responseId | string | Unique response identifier (if available) |
createTime | string | Response creation timestamp |
lastSubmittedTime | string | Last submitted timestamp |
formId | string | Google Form ID |
answers | object | Normalized map of question -> answer |
raw | object | Original payload (when enabled) |