Zapier y Make Connectors
Conecta Flash a miles de aplicaciones sin escribir código. En Zapier o Make, un evento Flash puede iniciar un flujo de trabajo en cualquier lugar, y esos flujos de trabajo pueden enviar datos de vuelta a Flash. No es necesario instalar una integración adicional: los conectores se basan en los mismos webhooks y en la versión 2 REST API documentada aquí.
Tres partes, todas ya construidas.
Cada automatización sin código se compone de un activador, una o más acciones y un método de autenticación. Flash proporciona los tres elementos desde su plataforma existente.
Activadores = eventos de webhook
La lista de activadores de un conector es exactamente el catálogo de eventos en vivo : miembro creado, nivel mejorado, pedido realizado, etc.
Acciones = puntos finales v2
Una acción llama a un punto final v2 REST: crea un miembro, otorga puntos, emite un cupón, agrega un registro personalizado object.
Autenticación = una clave API con ámbito
El conector se autentica con una clave fl_live_ enviada como Authorization: Bearer, limitada únicamente a las acciones y eventos necesarios.
El contrato de enlace REST
El modelo de gancho REST de Zapier (y los activadores instantáneos de Make) se asigna directamente a los puntos finales del webhook Flash, sin backend adicional. Un gancho REST se suscribe a un único evento; cuando el usuario desactiva un Zap, se cancela la suscripción. Los tres pasos del ciclo de vida utilizan una clave webhooks:manage.
| REST Paso de conexión | Flash llamada | Notas |
|---|---|---|
subscribe | POST /api/v2/webhooks | { url, eventTypes: [event] } → la respuesta data.id es la identificación de la suscripción. |
unsubscribe | DELETE /api/v2/webhooks/{id} | El id se almacena al momento de la suscripción. |
perform | (el cuerpo POST entregado) | La carga útil ligera Flash se entrega cuando se activa el evento. |
# subscribe (what the connector does when a Zap turns on)
curl -X POST https://flash.socialhub.ai/api/v2/webhooks \
-H "Authorization: Bearer fl_live_..." \
-H "Content-Type: application/json" \
-d '{ "url": "https://hooks.zapier.com/...", "eventTypes": ["member.created"] }'
# 201 { "data": { "id": "whe_..." } } <-- stored as the subscription id
# unsubscribe (Zap turned off)
curl -X DELETE https://flash.socialhub.ai/api/v2/webhooks/whe_... \
-H "Authorization: Bearer fl_live_..."Enviar datos nuevamente a Flash
Una acción es solo una llamada a un punto final v2 con los alcances de la clave. Proporcione a la clave del conector solo lo que necesita (por ejemplo, members:write para crear miembros o objects:write para agregar registros de objetos personalizados) y cada llamada se autentica y audita como cualquier otra solicitud API.
# example action: upsert a member when something happens in another app
curl -X POST https://flash.socialhub.ai/api/v2/members \
-H "Authorization: Bearer fl_live_..." \
-H "Content-Type: application/json" \
-d '{ "email": "ada@example.com", "fullName": "Ada Lovelace" }'Cree y alcance las claves en Cuenta → API Claves. Explore todas las acciones disponibles en la REST API referencia.