API Audience et clés API
L’API Audience permet aux organisateurs et promoteurs de brancher d’autres outils sur Communauté : créez une clé API à permissions limitées, puis poussez, cherchez et mettez à jour contacts et membres de liste.
Ce que vous obtenez
Permissions contacts:read, contacts:write et lists:write, avec préréglages
Ajout en lot de contacts, avec liste facultative et identifiants externes
Recherche et mise à jour des contacts, ajout ou retrait de membres
300 lectures et 60 écritures par minute par clé, écritures journalisées
Clé affichée une fois, expiration facultative, renouvelable et révocable
API Audience et clés API en détail
L’API Audience laisse un autre outil ajouter des gens à votre audience Trybe automatiquement : un formulaire sur votre site, le système d’un partenaire ou un outil de prospection. Dans Paramètres → Clés API, vous créez une clé par outil avec les permissions qu’il lui faut (contacts:read, contacts:write, lists:write, ou un préréglage), une expiration facultative, et vous la copiez une seule fois. Les appels vont à https://api.trybe.fm/public/v1/audience/ avec Authorization : Bearer trybe_sk_… et couvrent POST /contacts (ajout ou mise à jour en lot, avec liste facultative et identifiants externes pour reconnaître la même personne), GET /contacts/search, GET et PATCH /contacts/{id}, ainsi que POST ou DELETE /lists/{slug}/members.
Les limites sont de 300 lectures et 60 écritures par minute par clé ; chaque écriture est journalisée dans le fil d’activité de la clé. Les contacts créés ainsi affichent API comme source. Le consentement reste votre responsabilité : ne poussez que des gens qui ont accepté d’être contactés. Aujourd’hui, l’API couvre votre audience : les contacts et les listes auxquelles ils appartiennent.
Comment ça marche
Créez une clé
Dans Paramètres → Clés API, choisissez les permissions ou un préréglage et copiez la clé une fois.
Poussez des contacts
Appelez POST /contacts avec un e-mail ou un téléphone, des propriétés facultatives, un identifiant externe et une liste.
Gardez tout synchronisé
Cherchez, lisez et mettez à jour des contacts, ou gérez les membres de liste, dans les limites de débit.
Surveillez l’activité
Le fil d’activité et le journal de la clé montrent chaque écriture ; renouvelez ou révoquez au besoin.
Les questions des organisateurs
Trybe a-t-il une API publique ?
Oui, une API Audience pour les contacts et les listes. Avec une clé API, vous pouvez ajouter ou mettre à jour des contacts en lot, les chercher et les modifier, et ajouter ou retirer des membres de liste. Les événements, les billets et les commandes n’en font pas partie pour l’instant.
Comment obtenir une clé API ?
Allez dans Paramètres → Clés API, nommez la clé d’après l’outil qui l’utilisera, choisissez les permissions ou un préréglage, fixez une expiration si vous voulez, et copiez la clé : elle n’est affichée qu’une fois. Vous pouvez la renouveler ou la révoquer à tout moment.
Quelles sont les limites de débit ?
300 lectures et 60 écritures par minute par clé. L’ajout en lot permet d’envoyer plusieurs contacts en une seule écriture.
Puis-je garder un autre outil synchronisé avec mon audience Trybe ?
Oui. Lisez les contacts et les listes avec une portée de lecture, poussez de nouvelles personnes et mettez à jour les existantes avec les portées d’écriture, et transmettez votre propre identifiant externe pour que la même personne reste reconnue d’un outil à l’autre. Chaque clé est limitée à 300 lectures et 60 écritures par minute.
Puis-je brancher le formulaire d’inscription de mon site ?
Oui. Faites appeler POST /contacts par votre formulaire avec contacts:write (et lists:write pour déposer les gens dans une liste). Les nouveaux contacts apparaissent dans Communauté avec API comme source et peuvent déclencher l’automatisation Ajouté à une liste.
Comment Trybe évite-t-il les doublons venus de l’API ?
Les contacts sont uniques par e-mail dans votre organisation, et vous pouvez envoyer votre propre identifiant externe avec le nom de l’outil pour que Trybe reconnaisse la même personne au prochain appel. Une mise à jour modifie le contact existant plutôt que d’en créer un nouveau.
Fonctionnalités liées
Communauté (CRM)
Acheteurs, abonnés et contacts importés dans une seule liste à vous, avec commandes et consentement
Listes et modèles d’audience
Listes que vous contrôlez, nourries par imports, préventes et automatisations, plus six modèles d’audience
Automatisations
Des flux qui s’exécutent seuls quand un fan s’abonne, achète, laisse un panier ou a un événement qui approche