Google Forms

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.

Usage Instructions

Integrate Google Forms into your workflow. Read form structure, get responses, create forms, update content, and manage notification watches.

Actions

google_forms_get_responses

Retrieve a single response or list responses from a Google Form

Input

ParameterTypeRequiredDescription
formIdstringYesGoogle Forms form ID
responseIdstringNoResponse ID - if provided, returns this specific response
pageSizenumberNoMaximum number of responses to return (service may return fewer). Defaults to 5000.
pageTokenstringNoPage token from a previous list response to fetch the next page of responses
filterstringNoFilter responses, e.g. "timestamp > 2024-01-01T00:00:00Z" (RFC3339 UTC). Only timestamp filters are supported.

Output

ParameterTypeDescription
responsesarrayArray of form responses (when no responseId provided)
responseIdstringUnique response ID
createTimestringWhen the response was created
lastSubmittedTimestringWhen the response was last submitted
answersjsonMap of question IDs to answer values
nextPageTokenstringToken to fetch the next page of responses (null when no more pages)
responseobjectSingle form response (when responseId is provided)
responseIdstringUnique response ID
createTimestringWhen the response was created
lastSubmittedTimestringWhen the response was last submitted
answersjsonMap of question IDs to answer values
rawjsonRaw API response data

google_forms_get_form

Retrieve a form structure including its items, settings, and metadata

Input

ParameterTypeRequiredDescription
formIdstringYesGoogle Forms form ID to retrieve

Output

ParameterTypeDescription
formIdstringThe form ID
titlestringThe form title visible to responders
descriptionstringThe form description
documentTitlestringThe document title visible in Drive
responderUristringThe URI to share with responders
linkedSheetIdstringThe ID of the linked Google Sheet
revisionIdstringThe revision ID of the form
itemsarrayThe form items (questions, sections, etc.)
itemIdstringItem ID
titlestringItem title
descriptionstringItem description
settingsjsonForm settings
publishSettingsjsonForm publish settings

google_forms_create_form

Create a new Google Form with a title

Input

ParameterTypeRequiredDescription
titlestringYesThe title of the form visible to responders
documentTitlestringNoThe document title visible in Drive (defaults to form title)
unpublishedbooleanNoIf true, create an unpublished form that does not accept responses

Output

ParameterTypeDescription
formIdstringThe ID of the created form
titlestringThe form title
documentTitlestringThe document title in Drive
responderUristringThe URI to share with responders
revisionIdstringThe revision ID of the form

google_forms_batch_update

Apply multiple updates to a form (add items, update info, change settings, etc.)

Input

ParameterTypeRequiredDescription
formIdstringYesGoogle Forms form ID
requestsjsonYesArray of update requests (updateFormInfo, updateSettings, createItem, updateItem, moveItem, deleteItem)
includeFormInResponsebooleanNoWhether to return the updated form in the response

Output

ParameterTypeDescription
repliesarrayThe replies from each update request
writeControlobjectWrite control information with revision IDs
requiredRevisionIdstringRequired revision ID for conflict detection
targetRevisionIdstringTarget revision ID
formobjectThe updated form (if includeFormInResponse was true)
formIdstringThe form ID
infoobjectForm info containing title and description
titlestringThe form title visible to responders
descriptionstringThe form description
documentTitlestringThe document title visible in Drive
settingsobjectForm settings
quizSettingsobjectQuiz settings
isQuizbooleanWhether the form is a quiz
emailCollectionTypestringEmail collection type
revisionIdstringThe revision ID of the form
responderUristringThe URI to share with responders
linkedSheetIdstringThe ID of the linked Google Sheet
publishSettingsobjectForm publish settings
publishStateobjectCurrent publish state
isPublishedbooleanWhether the form is published
isAcceptingResponsesbooleanWhether the form is accepting responses

google_forms_set_publish_settings

Update the publish settings of a form (publish/unpublish, accept responses)

Input

ParameterTypeRequiredDescription
formIdstringYesGoogle Forms form ID
isPublishedbooleanYesWhether the form is published and visible to others
isAcceptingResponsesbooleanNoWhether the form accepts responses (forced to false if isPublished is false)

Output

ParameterTypeDescription
formIdstringThe form ID
publishSettingsjsonThe updated publish settings
publishStateobjectThe publish state
isPublishedbooleanWhether the form is published
isAcceptingResponsesbooleanWhether the form accepts responses

google_forms_create_watch

Create a notification watch for form changes (schema changes or new responses)

Input

ParameterTypeRequiredDescription
formIdstringYesGoogle Forms form ID to watch
eventTypestringYesEvent type to watch: SCHEMA (form changes) or RESPONSES (new submissions)
topicNamestringYesThe Cloud Pub/Sub topic name (format: projects/{project}/topics/{topic})
watchIdstringNoCustom watch ID (4-63 chars, lowercase letters, numbers, hyphens)

Output

ParameterTypeDescription
idstringThe watch ID
eventTypestringThe event type being watched
topicNamestringThe Cloud Pub/Sub topic
createTimestringWhen the watch was created
expireTimestringWhen the watch expires (7 days after creation)
statestringThe watch state (ACTIVE, SUSPENDED)

google_forms_list_watches

List all notification watches for a form

Input

ParameterTypeRequiredDescription
formIdstringYesGoogle Forms form ID

Output

ParameterTypeDescription
watchesarrayList of watches for the form
idstringWatch ID
eventTypestringEvent type (SCHEMA or RESPONSES)
createTimestringWhen the watch was created
expireTimestringWhen the watch expires
statestringWatch state

google_forms_delete_watch

Delete a notification watch from a form

Input

ParameterTypeRequiredDescription
formIdstringYesGoogle Forms form ID
watchIdstringYesWatch ID to delete

Output

ParameterTypeDescription
deletedbooleanWhether the watch was successfully deleted

google_forms_renew_watch

Renew a notification watch for another 7 days

Input

ParameterTypeRequiredDescription
formIdstringYesGoogle Forms form ID
watchIdstringYesWatch ID to renew

Output

ParameterTypeDescription
idstringThe watch ID
eventTypestringThe event type being watched
expireTimestringThe new expiration time
statestringThe watch state

Triggers

A Trigger is a block that starts a workflow when an event happens in this service.

Google Forms Webhook

Trigger workflow from Google Form submissions (via Apps Script forwarder)

Configuration

ParameterTypeRequiredDescription
tokenstringYesWe validate requests using this secret. Send it as Authorization: Bearer <token> or a custom header.
secretHeaderNamestringNoIf set, the webhook will validate this header equals your Shared Secret instead of Authorization.
triggerFormIdstringNoOptional, for clarity and matching in workflows. Not required for webhook to work.
includeRawPayloadbooleanNoInclude the original payload from Apps Script in the workflow input.
setupScriptstringNoCopy this code and paste it into your Google Forms Apps Script editor

Output

ParameterTypeDescription
responseIdstringUnique response identifier (if available)
createTimestringResponse creation timestamp
lastSubmittedTimestringLast submitted timestamp
formIdstringGoogle Form ID
answersobjectNormalized map of question -> answer
rawobjectOriginal payload (when enabled)

On this page