Google Calendar

ACTIVEVersão 1.0.0Google

Crie, atualize, cancele eventos e consulte disponibilidade no Google Calendar.

Ver como JSON

Pré-requisitos

• uma conta Google com acesso à agenda;
• permissão no iBPMS para criar ou selecionar conexões;
• autorização concluída pelo fluxo OAuth.

google-calendar.json

{
  "schemaVersion": 1,
  "key": "google-calendar",
  "name": "Google Calendar",
  "description": "Crie, atualize, cancele eventos e consulte disponibilidade no Google Calendar.",
  "category": "google",
  "vendor": "Google",
  "version": "1.0.0",
  "status": "ACTIVE",
  "credentials": [
    {
      "type": "OAUTH2",
      "permissions": [
        "Criar, editar e cancelar eventos na sua agenda",
        "Ver seus calendários e horários livres/ocupados"
      ]
    }
  ],
  "actions": [
    {
      "key": "event.update",
      "name": "Atualizar evento",
      "description": "Atualiza os dados do evento no calendario selecionado. Participantes representam a lista final do evento.",
      "inputs": [
        {
          "key": "calendarId",
          "label": "Calendario",
          "type": "RESOURCE_SELECT",
          "required": true
        },
        {
          "key": "eventId",
          "label": "ID do evento",
          "type": "TEXT",
          "required": true
        },
        {
          "key": "summary",
          "label": "Titulo",
          "type": "TEXT",
          "required": true
        },
        {
          "key": "startDateTime",
          "label": "Data e hora de inicio",
          "type": "DATETIME",
          "required": true,
          "description": "Tipo aceito: data e hora. Nao use apenas data. Se o valor nao tiver offset, preencha Fuso horario. Ex.: 2026-07-22T14:00 ou 2026-07-22T14:00:00-03:00."
        },
        {
          "key": "endDateTime",
          "label": "Data e hora de fim",
          "type": "DATETIME",
          "required": true,
          "description": "Tipo aceito: data e hora. Nao use apenas data. Se o valor nao tiver offset, preencha Fuso horario. Ex.: 2026-07-22T15:00 ou 2026-07-22T15:00:00-03:00."
        },
        {
          "key": "timeZone",
          "label": "Fuso horario",
          "type": "TIMEZONE",
          "required": false,
          "description": "Opcional quando a data/hora ja tem offset (-03:00 ou Z). Obrigatorio se usar data/hora sem offset. Ex.: America/Sao_Paulo."
        },
        {
          "key": "description",
          "label": "Descricao",
          "type": "TEXT",
          "required": false
        },
        {
          "key": "location",
          "label": "Local",
          "type": "TEXT",
          "required": false
        },
        {
          "key": "attendees",
          "label": "Participantes",
          "type": "JSON",
          "required": true,
          "description": "Tipo aceito: array de objetos do Google Calendar. Ex.: {{ solicitacao.participantes }} resolvendo para [{\"email\":\"ana@empresa.com\"}]."
        },
        {
          "key": "sendUpdates",
          "label": "Notificacoes",
          "type": "SELECT",
          "required": false
        }
      ],
      "outputs": [
        {
          "key": "id",
          "label": "Id",
          "type": "OUTPUT",
          "required": false
        },
        {
          "key": "status",
          "label": "Status",
          "type": "OUTPUT",
          "required": false
        },
        {
          "key": "htmlLink",
          "label": "Html Link",
          "type": "OUTPUT",
          "required": false
        },
        {
          "key": "updated",
          "label": "Updated",
          "type": "OUTPUT",
          "required": false
        },
        {
          "key": "attendees",
          "label": "Attendees",
          "type": "OUTPUT",
          "required": false
        }
      ]
    },
    {
      "key": "event.cancel",
      "name": "Cancelar evento",
      "description": "Cancela/remove um evento do calendario selecionado.",
      "inputs": [
        {
          "key": "calendarId",
          "label": "Calendario",
          "type": "RESOURCE_SELECT",
          "required": true
        },
        {
          "key": "eventId",
          "label": "ID do evento",
          "type": "TEXT",
          "required": true
        },
        {
          "key": "sendUpdates",
          "label": "Notificacoes",
          "type": "SELECT",
          "required": false
        }
      ],
      "outputs": []
    },
    {
      "key": "availability.query",
      "name": "Consultar disponibilidade",
      "description": "Consulta periodos ocupados para calendarios ou participantes em uma janela de tempo.",
      "inputs": [
        {
          "key": "timeMin",
          "label": "Data e hora de inicio",
          "type": "DATETIME",
          "required": true,
          "description": "Tipo aceito: data e hora. Nao use apenas data. Ex.: 2026-07-22T14:00 ou 2026-07-22T14:00:00-03:00."
        },
        {
          "key": "timeMax",
          "label": "Data e hora de fim",
          "type": "DATETIME",
          "required": true,
          "description": "Tipo aceito: data e hora. Nao use apenas data. Ex.: 2026-07-22T15:00 ou 2026-07-22T15:00:00-03:00."
        },
        {
          "key": "timeZone",
          "label": "Fuso horario",
          "type": "TIMEZONE",
          "required": false,
          "description": "Opcional. Se omitido, o Google usa o padrao da API para a resposta. Ex.: America/Sao_Paulo."
        },
        {
          "key": "items",
          "label": "Calendarios ou participantes",
          "type": "JSON",
          "required": true,
          "description": "Tipo aceito: array de objetos FreeBusy. Ex.: {{ agenda.participantes }} resolvendo para [{\"id\":\"ana@empresa.com\"}]."
        }
      ],
      "outputs": [
        {
          "key": "groups",
          "label": "Groups",
          "type": "OUTPUT",
          "required": false
        },
        {
          "key": "calendars",
          "label": "Calendars",
          "type": "OUTPUT",
          "required": false
        }
      ]
    },
    {
      "key": "event.create",
      "name": "Criar evento",
      "description": "Cria um evento no calendario selecionado, incluindo os participantes informados dinamicamente.",
      "inputs": [
        {
          "key": "calendarId",
          "label": "Calendario",
          "type": "RESOURCE_SELECT",
          "required": true
        },
        {
          "key": "summary",
          "label": "Titulo",
          "type": "TEXT",
          "required": true,
          "description": "Aceita expressoes do processo, ex.: {{ process.protocol }}."
        },
        {
          "key": "startDateTime",
          "label": "Data e hora de inicio",
          "type": "DATETIME",
          "required": true,
          "description": "Tipo aceito: data e hora. Nao use apenas data. Se o valor nao tiver offset, preencha Fuso horario. Ex.: 2026-07-22T14:00 ou 2026-07-22T14:00:00-03:00."
        },
        {
          "key": "endDateTime",
          "label": "Data e hora de fim",
          "type": "DATETIME",
          "required": true,
          "description": "Tipo aceito: data e hora. Nao use apenas data. Se o valor nao tiver offset, preencha Fuso horario. Ex.: 2026-07-22T15:00 ou 2026-07-22T15:00:00-03:00."
        },
        {
          "key": "timeZone",
          "label": "Fuso horario",
          "type": "TIMEZONE",
          "required": false,
          "description": "Opcional quando a data/hora ja tem offset (-03:00 ou Z). Obrigatorio se usar data/hora sem offset. Ex.: America/Sao_Paulo."
        },
        {
          "key": "description",
          "label": "Descricao",
          "type": "TEXT",
          "required": false
        },
        {
          "key": "location",
          "label": "Local",
          "type": "TEXT",
          "required": false
        },
        {
          "key": "attendees",
          "label": "Participantes",
          "type": "JSON",
          "required": true,
          "description": "Tipo aceito: array de objetos do Google Calendar. Ex.: {{ solicitacao.participantes }} resolvendo para [{\"email\":\"ana@empresa.com\"}]."
        },
        {
          "key": "sendUpdates",
          "label": "Notificacoes",
          "type": "SELECT",
          "required": false
        }
      ],
      "outputs": [
        {
          "key": "id",
          "label": "Id",
          "type": "OUTPUT",
          "required": false
        },
        {
          "key": "status",
          "label": "Status",
          "type": "OUTPUT",
          "required": false
        },
        {
          "key": "htmlLink",
          "label": "Html Link",
          "type": "OUTPUT",
          "required": false
        },
        {
          "key": "iCalUID",
          "label": "I Cal UID",
          "type": "OUTPUT",
          "required": false
        },
        {
          "key": "attendees",
          "label": "Attendees",
          "type": "OUTPUT",
          "required": false
        }
      ]
    }
  ],
  "triggers": [
    {
      "key": "events.changed",
      "name": "Agenda alterada",
      "description": "Dispara quando algo muda no calendário (evento criado, alterado ou removido). O Google notifica sem corpo — os dados vêm nos cabeçalhos do canal; use uma ação do Calendar em seguida para buscar o que mudou.",
      "mode": "WATCH",
      "exclusiveByConnection": false,
      "inputs": [
        {
          "key": "calendarId",
          "label": "Calendário",
          "type": "RESOURCE_SELECT",
          "required": true
        }
      ],
      "events": [
        {
          "type": "GENERIC"
        }
      ]
    }
  ]
}

Autorizando o acesso

1. No iBPMS, crie uma conexão do Google Calendar.
2. Revise as permissões no diálogo de consentimento.
3. Conclua a autorização na tela do Google e volte ao iBPMS.

Credenciais

Credencial

Credencial

OAUTH2

Campo	Formato esperado
Segredo

Permissões concedidas

• Criar, editar e cancelar eventos na sua agenda
• Ver seus calendários e horários livres/ocupados

Ações disponíveis

Ação

Atualizar evento

event.update

Atualiza os dados do evento no calendario selecionado. Participantes representam a lista final do evento.

Entradas

Campo	Tipo	Obrigatório	Descrição
calendarIdCalendario	RESOURCE_SELECT	Sim	—
eventIdID do evento	TEXT	Sim	—
summaryTitulo	TEXT	Sim	—
startDateTimeData e hora de inicio	DATETIME	Sim	Tipo aceito: data e hora. Nao use apenas data. Se o valor nao tiver offset, preencha Fuso horario. Ex.: 2026-07-22T14:00 ou 2026-07-22T14:00:00-03:00.
endDateTimeData e hora de fim	DATETIME	Sim	Tipo aceito: data e hora. Nao use apenas data. Se o valor nao tiver offset, preencha Fuso horario. Ex.: 2026-07-22T15:00 ou 2026-07-22T15:00:00-03:00.
timeZoneFuso horario	TIMEZONE	Não	Opcional quando a data/hora ja tem offset (-03:00 ou Z). Obrigatorio se usar data/hora sem offset. Ex.: America/Sao_Paulo.
descriptionDescricao	TEXT	Não	—
locationLocal	TEXT	Não	—
attendeesParticipantes	JSON	Sim	Tipo aceito: array de objetos do Google Calendar. Ex.: {{ solicitacao.participantes }} resolvendo para [{"email":"ana@empresa.com"}].
sendUpdatesNotificacoes	SELECT	Não	—

Saídas

Campo	Tipo	Obrigatório	Descrição
idId	OUTPUT	Não	—
statusStatus	OUTPUT	Não	—
htmlLinkHtml Link	OUTPUT	Não	—
updatedUpdated	OUTPUT	Não	—
attendeesAttendees	OUTPUT	Não	—

Chamada

{
  "connection": "google-calendar-producao",
  "operation": "event.update",
  "inputs": {
    "calendarId": "{{ context.calendarId }}",
    "eventId": "{{ context.eventId }}",
    "summary": "{{ context.summary }}",
    "startDateTime": "2026-08-13T09:00:00Z",
    "endDateTime": "2026-08-13T09:00:00Z",
    "timeZone": "2026-08-13T09:00:00Z",
    "description": "{{ context.description }}",
    "location": "{{ context.location }}",
    "attendees": {
      "chave": "valor"
    },
    "sendUpdates": "{{ context.sendUpdates }}"
  }
}

Resposta

{
  "id": 123,
  "status": "…",
  "htmlLink": "…",
  "updated": "…",
  "attendees": "…"
}

Ação

Cancelar evento

event.cancel

Cancela/remove um evento do calendario selecionado.

Entradas

Campo	Tipo	Obrigatório	Descrição
calendarIdCalendario	RESOURCE_SELECT	Sim	—
eventIdID do evento	TEXT	Sim	—
sendUpdatesNotificacoes	SELECT	Não	—

Saídas

Esta ação não declara saídas públicas.

Chamada

{
  "connection": "google-calendar-producao",
  "operation": "event.cancel",
  "inputs": {
    "calendarId": "{{ context.calendarId }}",
    "eventId": "{{ context.eventId }}",
    "sendUpdates": "{{ context.sendUpdates }}"
  }
}

Ação

Consultar disponibilidade

availability.query

Consulta periodos ocupados para calendarios ou participantes em uma janela de tempo.

Entradas

Campo	Tipo	Obrigatório	Descrição
timeMinData e hora de inicio	DATETIME	Sim	Tipo aceito: data e hora. Nao use apenas data. Ex.: 2026-07-22T14:00 ou 2026-07-22T14:00:00-03:00.
timeMaxData e hora de fim	DATETIME	Sim	Tipo aceito: data e hora. Nao use apenas data. Ex.: 2026-07-22T15:00 ou 2026-07-22T15:00:00-03:00.
timeZoneFuso horario	TIMEZONE	Não	Opcional. Se omitido, o Google usa o padrao da API para a resposta. Ex.: America/Sao_Paulo.
itemsCalendarios ou participantes	JSON	Sim	Tipo aceito: array de objetos FreeBusy. Ex.: {{ agenda.participantes }} resolvendo para [{"id":"ana@empresa.com"}].

Saídas

Campo	Tipo	Obrigatório	Descrição
groupsGroups	OUTPUT	Não	—
calendarsCalendars	OUTPUT	Não	—

Chamada

{
  "connection": "google-calendar-producao",
  "operation": "availability.query",
  "inputs": {
    "timeMin": "2026-08-13T09:00:00Z",
    "timeMax": "2026-08-13T09:00:00Z",
    "timeZone": "2026-08-13T09:00:00Z",
    "items": {
      "chave": "valor"
    }
  }
}

Resposta

{
  "groups": "…",
  "calendars": "…"
}

Ação

Criar evento

event.create

Cria um evento no calendario selecionado, incluindo os participantes informados dinamicamente.

Entradas

Campo	Tipo	Obrigatório	Descrição
calendarIdCalendario	RESOURCE_SELECT	Sim	—
summaryTitulo	TEXT	Sim	Aceita expressoes do processo, ex.: {{ process.protocol }}.
startDateTimeData e hora de inicio	DATETIME	Sim	Tipo aceito: data e hora. Nao use apenas data. Se o valor nao tiver offset, preencha Fuso horario. Ex.: 2026-07-22T14:00 ou 2026-07-22T14:00:00-03:00.
endDateTimeData e hora de fim	DATETIME	Sim	Tipo aceito: data e hora. Nao use apenas data. Se o valor nao tiver offset, preencha Fuso horario. Ex.: 2026-07-22T15:00 ou 2026-07-22T15:00:00-03:00.
timeZoneFuso horario	TIMEZONE	Não	Opcional quando a data/hora ja tem offset (-03:00 ou Z). Obrigatorio se usar data/hora sem offset. Ex.: America/Sao_Paulo.
descriptionDescricao	TEXT	Não	—
locationLocal	TEXT	Não	—
attendeesParticipantes	JSON	Sim	Tipo aceito: array de objetos do Google Calendar. Ex.: {{ solicitacao.participantes }} resolvendo para [{"email":"ana@empresa.com"}].
sendUpdatesNotificacoes	SELECT	Não	—

Saídas

Campo	Tipo	Obrigatório	Descrição
idId	OUTPUT	Não	—
statusStatus	OUTPUT	Não	—
htmlLinkHtml Link	OUTPUT	Não	—
iCalUIDI Cal UID	OUTPUT	Não	—
attendeesAttendees	OUTPUT	Não	—

Chamada

{
  "connection": "google-calendar-producao",
  "operation": "event.create",
  "inputs": {
    "calendarId": "{{ context.calendarId }}",
    "summary": "{{ context.summary }}",
    "startDateTime": "2026-08-13T09:00:00Z",
    "endDateTime": "2026-08-13T09:00:00Z",
    "timeZone": "2026-08-13T09:00:00Z",
    "description": "{{ context.description }}",
    "location": "{{ context.location }}",
    "attendees": {
      "chave": "valor"
    },
    "sendUpdates": "{{ context.sendUpdates }}"
  }
}

Resposta

{
  "id": 123,
  "status": "…",
  "htmlLink": "…",
  "iCalUID": 123,
  "attendees": "…"
}

Triggers disponíveis

Trigger

Agenda alterada

WATCH

Dispara quando algo muda no calendário (evento criado, alterado ou removido). O Google notifica sem corpo — os dados vêm nos cabeçalhos do canal; use uma ação do Calendar em seguida para buscar o que mudou.

Configuração

Campo	Tipo	Obrigatório	Descrição
calendarIdCalendário	RESOURCE_SELECT	Sim	—

Eventos normalizados

• GENERIC

Evento recebido

{
  "event": "GENERIC",
  "data": {
    "calendarId": "{{ context.calendarId }}"
  }
}

Limitações

• o trigger de agenda alterada opera em modo WATCH e exige renovação periódica do canal;
• a conexão enxerga apenas os calendários da conta autorizada;
• convites e notificações seguem as regras do próprio Google Calendar.

Erros comuns

Sintoma	Possível causa	Correção
Autorização expirada	Acesso revogado na conta Google	Refaça a conexão pelo fluxo OAuth.
Evento não aparece	Calendário errado selecionado	Confirme o identificador do calendário nos inputs da ação.
Conflito de horário	Disponibilidade não consultada antes de criar	Use a ação de consulta de disponibilidade antes de agendar.

Veja também

• Todos os conectores
• Integrações
• Solução de problemas