Zapier

Zapier es la forma más fácil de enviar eventos de GCM al resto de tu stack. ¿Nuevo miembro agregado? Envíalo a tu Google Sheet de visitas pastorales. ¿Donación registrada? Publica un agradecimiento en el canal de Slack de tu iglesia. ¿Miembro completó un flujo? Etiquétalo en tu CRM.

GCM viene con una app nativa de Zapier construida sobre REST Hooks — lo que significa que Zapier se suscribe a un webhook de nuestro lado, y enviamos eventos a medida que ocurren. Sin polling, sin retraso, sin tareas de Zap desperdiciadas.

Cómo funciona la integración

1. Creas una clave de API en GCM (Integraciones → Zapier → API Keys).
2. En Zapier, creas un nuevo Zap y eliges GCM como app disparadora.
3. Zapier pide tu clave de API y la valida contra nuestro endpoint /v1/me.
4. Eliges un evento disparador (p. ej. Member created).
5. Zapier registra una suscripción con nuestro endpoint /v1/subscriptions — este es el REST Hook.
6. A partir de ahí, cada vez que el evento se dispara, GCM hace POST de la carga útil a la target_url de la suscripción (una URL de webhook opaca alojada por Zapier).

Puedes tener tantas suscripciones como quieras, en tantos Zaps. Todas viven bajo una clave de API.

Paso 1 — Genera una clave de API

En GCM, ve a Integraciones → Zapier. En la pestaña API Keys, haz clic en Nueva clave.

Dale una etiqueta que reconocerás luego — Zapier — Producción es un buen predeterminado. Cuando hagas clic en crear, GCM te muestra la clave en bruto una sola vez. Cópiala de inmediato y pégala en algún lugar seguro (un gestor de contraseñas, tu pantalla de conexión de Zapier).

WARNING

No mostramos la clave en bruto otra vez — por seguridad, solo guardamos un hash. Si la pierdes, revoca la clave y crea una nueva.

La clave empieza con un prefijo reconocible (gcm_live_…) para que puedas decir a qué entorno pertenece de un vistazo. La porción visible en la lista de claves es el prefijo más una elipsis — útil para "qué clave está usando este Zap" sin filtrar el secreto.

Paso 2 — Conéctate en Zapier

En Zapier, busca la app Genius Church Manager, haz clic en + Create Zap y elige un disparador. Cuando Zapier pida autenticación:

• API Key: pega la clave gcm_live_… del Paso 1.
• Organization: detectada automáticamente desde la clave. No necesitas ingresar el slug de tu organización.

Zapier llama a nuestro endpoint /v1/me, confirma que la clave es válida y guarda la conexión.

Paso 3 — Elige un evento disparador

La app de Zapier expone estos disparadores:

Evento	Se dispara cuando
member.created	Se agrega un nuevo miembro (cualquier fuente — manual, formulario de visitante, importación)
member.updated	Cualquier campo rastreado de un miembro cambia
donation.created	Se registra una donación (en línea, manual o cobro recurrente)
attendance.recorded	Se guarda una fila de check-in o asistencia
workflow.completed	Un miembro termina la ejecución de un flujo
form.submitted	Se envía un formulario público
group.member_added	Alguien se agrega a un grupo pequeño o ministerio

Cada evento envía una carga útil JSON que refleja el recurso correspondiente de GCM. Consulta la referencia de webhooks de la API para las formas exactas de los campos.

Suscripciones activas

Una vez que tu Zap está encendido, aparece en la pestaña Suscripciones.

Cada fila muestra el tipo de evento, la URL del webhook de Zapier (para que confirmes que apunta al Zap correcto), cuándo entregó por última vez y un contador de fallos. Tras 10 fallos consecutivos desactivamos automáticamente la suscripción — Zapier hace lo mismo en su extremo, así que esto te protege de un Zap descontrolado que dispara miles de veces contra un endpoint eliminado.

Una suscripción desactivada obtiene una insignia roja. Apaga y enciende el Zap en Zapier para volver a crearla.

Entregas recientes

La pestaña Entregas recientes muestra los últimos 50 eventos que GCM ha enviado.

Cada fila tiene:

• Un check verde (HTTP 2xx) o exclamación roja (4xx / 5xx).
• El tipo de evento.
• El estado de respuesta HTTP que Zapier devolvió.
• Un extracto corto del cuerpo de la respuesta (generalmente el ID de Zapier y un hash).
• Un contador de reintentos — reintentamos las entregas fallidas con backoff exponencial hasta 4 veces antes de marcar la fila como fallida.

Este registro es tu única fuente de verdad cuando un Zap "dejó de funcionar". Revísalo primero.

Revocar una clave

Cuando un miembro del personal se va o sospechas que una clave se filtró, pulsa el icono de papelera en la pestaña API Keys.

WARNING

Revocar una clave rompe inmediatamente todos los Zaps que la usan. El Zap muestra un banner rojo en Zapier ("authentication failed") y tendrás que reconectar con una clave fresca. Planifica una ventana de rotación.

Qué puede leer Zapier

Las claves de API creadas a través de esta interfaz tienen por defecto alcance de solo lectura (read:*). Eso significa que un Zap puede listar miembros, donaciones, asistencia — pero no puede crearlos ni modificarlos. Los alcances de escritura están disponibles a través de claves de API pero deben usarse con moderación.

Límites

Límite	Predeterminado
Claves de API por organización	20
Suscripciones activas por organización	100
Tasa de entrega	60 eventos / minuto / suscripción
Tamaño de carga útil	256 KB
Intentos de reintento	4 (1m, 5m, 25m, 2h)

Si chocas con el límite de suscripciones casi seguro tienes Zaps huérfanos — elimina los no usados en Zapier y se caerán de nuestro lado en una hora.

Referencias cruzadas

• Claves de API — referencia completa de alcances y política de rotación.
• Webhooks salientes — misma infraestructura de entrega, pero apuntada a tu propio endpoint en lugar de Zapier.
• Referencia de webhooks — formas exactas de carga útil para cada evento.