SocialHub.AI
Centre de développement · Extensibilité ouverte

Connecteurs Zapier et Make

Connectez Flash à des milliers d'applications sans écrire de code. Dans Zapier ou Make, un événement Flash peut déclencher un flux de travail n'importe où, et ces flux de travail peuvent renvoyer des données vers Flash. Aucune intégration supplémentaire à installer  : les connecteurs sont basés sur les mêmes webhooks et la version 2 REST API documentée ici.

Comment cela fonctionne

Trois parties, toutes déjà construites

Chaque automatisation sans code est composée d'un déclencheur, d'une ou plusieurs actions et d'une méthode d'authentification. Flash fournit ces trois éléments depuis sa plateforme existante.

Déclencheurs = événements webhook

La liste de déclencheurs d'un connecteur correspond exactement au catalogue d'événements en direct  : création d'un membre, passage à un niveau supérieur, commande passée, etc.

Actions = points de terminaison v2

Une action appelle un point de terminaison v2 REST — créer un membre, attribuer des points, émettre un coupon, ajouter un enregistrement personnalisé object.

Authentification : une clé API à portée limitée

Le connecteur s'authentifie avec une clé fl_live_ envoyée en tant que Authorization: Bearer, limitée aux seules actions et événements nécessaires.

Fonctionnement interne des déclencheurs

Le contrat Hook REST

Le modèle Hook REST de Zapier (et les déclencheurs instantanés de Make) s'intègre directement aux points de terminaison webhook Flash, sans backend supplémentaire. Un Hook REST s'abonne à un seul événement ; lorsqu'un utilisateur désactive un Zap, l'abonnement est annulé. Les trois étapes du cycle de vie utilisent une clé webhooks:manage.

REST Étape d'accrocheFlash appelRemarques
subscribePOST /api/v2/webhooks{ url, eventTypes: [event] } → la réponse data.id est l'identifiant de l'abonnement.
unsubscribeDELETE /api/v2/webhooks/{id}La id est stockée lors de l'abonnement.
perform(le corps POST livré)La charge utile mince Flash est exécutée lorsque l'événement se déclenche.
# 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_..."
Actions

Repousser les données dans Flash

Une action est simplement un appel à un point de terminaison v2 avec les étendues de la clé. Donnez à la clé du connecteur uniquement ce dont il a besoin — par exemple members:write pour créer des membres ou objects:write pour ajouter des enregistrements d'objet personnalisé — et chaque appel est authentifié et audité comme n'importe quelle autre requête 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" }'

Créez et définissez des clés dans Compte → API Clés. Parcourez toutes les actions disponibles dans la REST API référence.