Tilly
Connexion
Menu
TutorielsConnecter HelloAsso

Intégration

Connecter HelloAsso

Connectez votre association à HelloAsso pour retrouver vos événements et importer les participants directement dans Tilly.

Durée5 à 10 minNiveauDébutantFormatGuide écrit

Avant de commencer

Quelques motsavant de commencer.

HelloAsso permet à Tilly de récupérer les événements et les participants payants de votre association.

La connexion nécessite quatre informations : l'Organization slug, le Client ID, le Client secret et l'environnement HelloAsso utilisé.

Pour une association en utilisation réelle, utilisez toujours l'environnement Production. Le mode Sandbox est réservé aux tests.

Guide écrit

Configurationétape par étape.

Suivez les étapes dans l'ordre. Vous pouvez revenir sur cette page à tout moment pendant votre configuration.

Étape 01

Trouver l'Organization slug

L'Organization slug est l'identifiant public de votre association utilisé dans les URL HelloAsso.

  1. Ouvrez la page publique HelloAsso de votre association.
  2. Regardez l'adresse affichée dans votre navigateur.
  3. Repérez la partie située juste après « /associations/ ».
  4. Copiez cette valeur : il s'agit de votre Organization slug.
https://www.helloasso.com/associations/mon-association

Organization slug :
mon-association
À savoir

Vous pouvez également retrouver ce slug dans les URL publiques de vos formulaires et événements HelloAsso.

Étape 02

Récupérer le Client ID et le Client secret

Ces deux identifiants permettent à Tilly de communiquer avec l'API HelloAsso au nom de votre association.

  1. Connectez-vous au compte HelloAsso de votre association.
  2. Dans le menu de gauche, ouvrez « Mon compte ».
  3. Ouvrez ensuite « Intégrations et API ».
  4. Créez une clé API si aucune clé n'existe encore.
  5. Copiez le Client ID.
  6. Copiez le Client secret.
  7. Conservez le Client secret dans un endroit sécurisé.
À savoir

Si la rubrique « Intégrations et API » n'apparaît pas, vérifiez que le compte connecté dispose bien des droits d'administration sur l'association.

Attention

Le Client secret est une donnée confidentielle. Ne le publiez jamais dans un dépôt GitHub, une capture d'écran ou une documentation publique.

DocumentationDocumentation officielle HelloAsso
Étape 03

Configurer HelloAsso dans Tilly

Une fois vos trois identifiants récupérés, vous pouvez les renseigner directement dans Tilly.

  1. Ouvrez « Config » dans Tilly.
  2. Allez dans la section « HelloAsso ».
  3. Ouvrez « Configuration HelloAsso ».
  4. Renseignez votre Organization slug.
  5. Renseignez votre Client ID.
  6. Renseignez votre Client secret.
  7. Choisissez l'environnement « Production ».
  8. Enregistrez la configuration.
  9. Utilisez le bouton de test de connexion HelloAsso s'il est disponible.
  • Production : à utiliser pour votre véritable association.
  • Sandbox : uniquement destiné aux tests et au développement.
À savoir

Si la connexion fonctionne, Tilly pourra ensuite récupérer vos événements HelloAsso lors de la création d'une session.

Étape 04

Importer un événement dans une session

Une fois HelloAsso configuré, vous pouvez associer une session Tilly à un événement HelloAsso existant.

  1. Créez une nouvelle session dans Tilly.
  2. Choisissez l'événement HelloAsso à associer.
  3. Lancez l'import des participants.
  4. Vérifiez que les participants ou inscrits apparaissent correctement dans la session.
À savoir

L'événement doit appartenir à l'association correspondant à l'Organization slug et aux identifiants API configurés.

Étape 05

Protéger le Client secret

Le Client secret donne accès à l'API HelloAsso de votre association et doit donc rester strictement confidentiel.

  • Ne publiez jamais le Client secret sur GitHub.
  • Ne l'incluez pas dans une capture d'écran publique.
  • Ne le copiez pas dans une documentation accessible publiquement.
  • Ne l'envoyez pas à une personne qui n'administre pas l'association.
  • Stockez-le si nécessaire dans un gestionnaire de mots de passe.
À savoir

Les identifiants HelloAsso restent propres à l'installation de l'association. Si vous changez de clé API, pensez à mettre à jour la configuration dans Tilly.

Attention

Le Client secret ne doit jamais être synchronisé dans Firebase et ne doit pas apparaître dans les exports JSON de Tilly.

Configuration terminée

Tout estprêt.

Votre configuration est maintenant terminée. En cas de problème, vous pouvez consulter les étapes précédentes ou nous poser une question.

Autres tutorielsPoser une question