Zapier

O Zapier é o jeito mais fácil de enviar eventos do GCM para o restante do seu stack. Novo membro adicionado? Mande para sua planilha do Google de visitas pastorais. Doação registrada? Poste um agradecimento no canal Slack da sua igreja. Membro completou um workflow? Marque-o no seu CRM.

O GCM entrega um app Zapier nativo construído em REST Hooks — o que significa que o Zapier assina um webhook do nosso lado, e enviamos eventos no momento em que acontecem. Sem polling, sem atraso, sem tarefas Zap desperdiçadas.

Como a integração funciona

1. Você cria uma chave de API no GCM (Integrations → Zapier → API Keys).
2. No Zapier, você cria um novo Zap e escolhe GCM como app disparador.
3. O Zapier pede sua chave de API e valida contra nosso endpoint /v1/me.
4. Você escolhe um evento disparador (ex.: Member created).
5. O Zapier registra uma assinatura no nosso endpoint /v1/subscriptions — este é o REST Hook.
6. Desse ponto em diante, toda vez que o evento dispara, o GCM faz POST do payload na target_url da assinatura (uma URL de webhook opaca hospedada pelo Zapier).

Você pode ter quantas assinaturas quiser, em quantos Zaps quiser. Todas vivem sob uma única chave de API.

Etapa 1 — Gerar uma chave de API

No GCM, vá em Integrations → Zapier. Na aba API Keys, clique em New key.

Dê um rótulo que você reconhecerá depois — Zapier — Production é um bom padrão. Quando você clica em criar, o GCM mostra a chave bruta uma única vez. Copie-a imediatamente e cole em um lugar seguro (um gerenciador de senhas, a tela de conexão do Zapier).

WARNING

Não mostramos a chave bruta novamente — por segurança, só armazenamos um hash. Se você perder, revogue a chave e crie uma nova.

A chave começa com um prefixo reconhecível (gcm_live_…) para você poder dizer rapidamente a qual ambiente ela pertence. A porção visível na lista de chaves é o prefixo mais reticências — útil para "qual chave este Zap está usando" sem vazar o segredo.

Etapa 2 — Conectar no Zapier

No Zapier, busque o app Genius Church Manager, clique em + Create Zap, e escolha um disparador. Quando o Zapier pedir autenticação:

• API Key: cole a chave gcm_live_… da Etapa 1.
• Organization: detectada automaticamente da chave. Você não precisa informar o slug da sua organização.

O Zapier chama nosso endpoint /v1/me, confirma que a chave é válida, e armazena a conexão.

Etapa 3 — Escolha um evento disparador

O app Zapier expõe estes disparadores:

Evento	Dispara quando
member.created	Um novo membro é adicionado (qualquer fonte — manual, formulário de visitante, importação)
member.updated	Qualquer campo rastreado em um membro muda
donation.created	Uma doação é registrada (online, manual ou cobrança recorrente)
attendance.recorded	Um check-in ou linha de presença é salvo
workflow.completed	Um membro termina uma execução de workflow
form.submitted	Um formulário público é enviado
group.member_added	Alguém é adicionado a um pequeno grupo ou ministério

Cada evento envia um payload JSON que espelha o recurso GCM correspondente. Consulte a referência da API de webhooks para os formatos exatos dos campos.

Assinaturas ativas

Uma vez que seu Zap está ligado, ele aparece na aba Subscriptions.

Cada linha mostra o tipo de evento, a URL do webhook do Zapier (para você confirmar que está apontando para o Zap certo), quando entregou pela última vez e um contador de falhas. Após 10 falhas consecutivas, desativamos automaticamente a assinatura — o próprio Zapier faz o mesmo do lado dele, então isso te protege de um Zap descontrolado disparando milhares de vezes contra um endpoint deletado.

Uma assinatura desativada recebe um badge vermelho. Desligue e religue o Zap no Zapier para recriá-la.

Entregas recentes

A aba Recent deliveries mostra os últimos 50 eventos que o GCM enviou.

Cada linha tem:

• Um check verde (HTTP 2xx) ou exclamação vermelha (4xx / 5xx).
• O tipo de evento.
• O status de resposta HTTP que o Zapier retornou.
• Um trecho curto do corpo da resposta (geralmente o ID do Zapier e um hash).
• Um contador de tentativas — tentamos novamente entregas falhadas com backoff exponencial até 4 vezes antes de marcar a linha como falhada.

Este log é sua única fonte de verdade quando um Zap "parou de funcionar". Verifique aqui primeiro.

Revogar uma chave

Quando um funcionário sai ou você suspeita que uma chave vazou, clique no ícone de lixeira na aba API Keys.

WARNING

Revogar uma chave quebra instantaneamente todo Zap que a usa. O Zap mostra um banner vermelho no Zapier ("authentication failed") e você precisará reconectar com uma chave nova. Planeje uma janela de rotação.

O que o Zapier pode ler

Chaves de API criadas por esta interface têm escopo somente leitura por padrão (read:*). Isso significa que um Zap pode listar membros, doações, presenças — mas não pode criá-los ou modificá-los. Escopos de escrita estão disponíveis pelas chaves de API mas devem ser usados com parcimônia.

Limites

Limite	Padrão
Chaves de API por organização	20
Assinaturas ativas por organização	100
Taxa de entrega	60 eventos / minuto / assinatura
Tamanho do payload	256 KB
Tentativas de retentativa	4 (1 min, 5 min, 25 min, 2 h)

Se você bater no limite de assinaturas, quase certamente tem Zaps órfãos — apague os não usados no Zapier e eles vão sair do nosso lado em até uma hora.

Referências cruzadas

• Chaves de API — referência completa de escopo e política de rotação.
• Webhooks de saída — mesma infraestrutura de entrega, mas apontada ao seu próprio endpoint em vez do Zapier.
• Referência de webhooks — formatos exatos de payload para cada evento.