# Documentation
Explorez nos guides et découvrez comment utiliser toutes les fonctionnalités de open action.
open action est une plateforme de mobilisation constitué de trois parties principales :
### 1. Une base de contacts
Votre base de contacts est votre ressource la plus précieuse : le rôle de open action est de vous aider à faire grandir cette base de données (acquisition), à l'enrichir (qualification) et à la mobiliser le moment venu (mobilisation). La base de contacts open action est donc un outil clé dans l'usage de la plateforme :
{% content-ref url="/pages/-MirWdy8HMuSRdgReMIN" %}
[Base de contacts](/base-de-contacts/vue-densemble)
{% endcontent-ref %}
### 2. Un site internet
Les sites internet open action sont un moyen efficace de lancer un site internet militant sans connaissances techniques requises. Basés sur nos thèmes standard ou personnalisés, ils vous permettrons de présenter votre contenu de manière efficace et moderne.
Un site internet open action a pour objectif **d'acquérir de nouveaux contacts** grâce aux modules de Newsletter et d'Espace membre, de **qualifier ces contacts** grâce au module Questionnaire et de **les mobiliser** via les module Événements :
{% content-ref url="/pages/-MiqSJFB8BCrAyNdIb53" %}
[PLATEFORME D'ACTION](/creer-son-site-internet/creer-du-contenu)
{% endcontent-ref %}
### 3. Les campagnes de mobilisation
Dernier maillon de la gestion de communauté militante, open action vous offre trois manières de mobiliser vos contacts : les campagnes **emails**, les campagnes **SMS** et les campagnes **par téléphone**.
Le rôle de ces campagnes est de communiquer directement avec vos contacts, sans algorithme, pour collecter des données, les inviter à agir, à participer à vos actions ou encore leur demander leur avis :
{% content-ref url="/pages/-MiqUx\_pvcP0QYs0lxyA" %}
[Campagnes](/communaute/vue-densemble)
{% endcontent-ref %}
# Créer et sécuriser mon compte
**Pour renforcer la sécurité de votre compte, il est fortement recommandé d’activer l’authentification à deux facteurs (2FA).**
\
*Cette méthode ajoute une étape de vérification lors de la connexion, en complément de votre mot de passe, afin de protéger l’accès à votre compte même en cas de compromission de vos identifiants.*
1. Accéder aux paramètres de sécurité Rendez-vous dans les paramètres de votre compte, puis ouvrez la section Sécurité ou Connexion.
2\. Activer l’authentification à deux facteurs Dans la rubrique dédiée au 2FA, choisissez **Activer l’authentification à deux facteurs**. Le système vous propose alors d’utiliser une **application d’authentification** compatible, comme :
* [Google Authenticator](https://support.google.com/accounts/answer/1066447?hl=en)
* [Authy](https://www.authy.com/download/)
\
3\. Lier votre application d’authentification Scannez le **QR code** affiché à l’écran avec votre application d’authentification. À défaut, une **clé secrète** peut être saisie manuellement dans l’application.
\
4\. Confirmer l’activation
Une fois l’application configurée, saisissez le **code à usage unique** généré pour confirmer l’activation du 2FA. Cette étape permet de vérifier que l’application est correctement liée à votre compte.
5\. Sauvegarder les codes de récupération Après activation, des **codes de récupération** vous sont fournis.
👉 **Conservez-les précieusement** : ils vous permettront d’accéder à votre compte en cas de perte de votre téléphone ou d’impossibilité d’utiliser l’application d’authentification.
\
6\. Connexion avec le 2FA Lors des prochaines connexions :
1. Vous saisissez votre mot de passe
2. Un **code temporaire** vous est demandé
3. Ce code est généré par votre application d’authentification
# Créer son équipe
# Vue d'ensemble
# Gérer ma base de contact
# Gestion des doublons
# Créer une action
# Actualités
Création d’une nouvelle actualité dans OpenAction
## Création d’une nouvelle actualité dans OpenAction
> Ce document décrit les différentes étapes pour créer, configurer et publier une nouvelle actualité dans le module Actualité d'OpenAction, depuis la création initiale jusqu’aux paramètres de visibilité, de publication et de référencement.
#### Étape 1 : Accéder à la création d’une nouvelle actualité
Pour créer une nouvelle actualité dans le module OpenAction, cliquez en haut à droite sur le bouton « Nouvelle actualité ».
#### Étape 2: Renseigner les informations principales de l’actualité
Dans la première étape de création, plusieurs éléments sont proposés : ajouter une image de couverture, sélectionner une ou plusieurs catégories, saisir le titre et définir la vidéo principale.
Saisissez le **titre** de l’actualité dans le champ prévu à cet effet.
Si vous souhaitez que l’actualité renvoie directement vers une vidéo hébergée sur une plateforme (exemple : Youtube), il vous suffit d’indiquer l’URL de cette vidéo dans le champ prévu. Dans ce cas, l’actualité redirige directement vers la vidéo externe et utilise l'image de miniature de la vidéo comme image de l'actualité.
#### Étape 3: Rédiger le contenu de l’actualité
Vous accédez maintenant au **contenu de l’actualité** via l’éditeur de contenu. Utilisez l’éditeur pour rédiger le texte, insérer des médias, structurer les paragraphes et mettre en forme l’ensemble des informations que vous souhaitez publier.
#### Étape 4: Définir la visibilité et le mode de publication
Lors de l’étape suivante, plusieurs options sont disponibles concernant la **publication** et la **visibilité** de l’actualité.
Deux options sont disposnibles concernant la visibilité :
* **Public** : l'actualité est publiée sur votre site ou votre plateforme d'action de façon publique, visible par tous.
* **Membres uniquement** : l'actualité est publiée sur votre site ou votre plateforme d'action mais n'est pas visible immédiatement. Les membres de votre organisation doivent se connecter avec leur espace membre pour y avoir accès.
Choisissez ensuite le **mode de publication** :
* Publier **immédiatement**, pour rendre l’actualité visible dès l’enregistrement.
* **Programmer** la publication à la date et à l’heure de votre choix.
#### Step 5: Optimiser le référencement et finaliser l’actualité
En termes de **référencement**, vous pouvez optimiser la visibilité de l’actualité dans les résultats des moteurs de recherche en ajoutant une **description spécifique** dédiée au référencement.
Une fois tous les éléments renseignés (contenu, visibilité, publication, référencement), cliquez sur **« Enregistrer et Fermer »** pour finaliser la création.
Votre actualité est désormais prête et sera accessible selon les paramètres de visibilité et de publication définis.
# Pétition
Cet article décrit le processus complet pour créer, configurer, publier et suivre une pétition sur Open Action, ainsi que la gestion des versions multilingues et du questionnaire associé.
#### Étape 1 : Créer une nouvelle pétition
Rendez-vous sur l’onglet **Pétition** du **Menu Mes pages** dans l’interface d’Open Action afin d’accéder à l’outil de création de pétitions.
Cliquez sur le bouton **Nouvelle pétition**, situé en haut à droite de l’écran, pour démarrer la création d’une nouvelle pétition en ligne.
#### Étape 2 : Configurer les informations générales de la pétition
Renseignez les éléments de base de la pétition :
* Ajoutez une **image de couverture** qui servira d’identité visuelle à la pétition.
* Saisissez un **titre** clair et explicite.
* Ajoutez des **tags** qui seront automatiquement appliqués aux signataires de la pétition, par exemple le tag « National ».
* Indiquez un **objectif public de signatures** (nombre de signatures à atteindre). L'objectif apparaît sur la page public et peut être actualisé après le lancement.
* La période de collecte peut être personnalisée en indiquant une date de début et une date de fin de la pétition
* De la même façon, vous pouvez personnaliser l’URL de la pétition en fonction de vos besoins et de ceux de la campagne avec un nom personnalisé (lié au nom de domaine de votre organisation Open Action).
#### Étape 3 : Valider la première configuration
Une fois ce premier niveau de configuration complété (image, titre, tags, objectif, destinataire, période de collecte, URL), validez en cliquant sur **Poursuivre**.
#### Étape 4 : Rédiger le contenu de la pétition
Dans le module suivant, rédigez le **contenu de la pétition** :
* Le texte explicatif de votre action (contexte, enjeux, appel à soutien).
* Les différents éléments complémentaires nécessaires à la compréhension de la pétition (arguments, informations pratiques, etc.).
#### Étape 5 : Finaliser le contenu et poursuivre
Après avoir chargé et vérifié l’ensemble des éléments de contenu de la pétition, cliquez sur **Poursuivre** pour passer à l’étape de finalisation.
Consultez le récapitulatif de la pétition, qui présente l’ensemble des paramètres de configuration.
Choisissez ensuite les **options de publication** :
* Publication **instantanée**, pour mettre en ligne la pétition immédiatement.
* **Programmation** de la publication à une date ultérieure, si vous souhaitez planifier la mise en ligne.
#### Étape 6 : Publier la pétition
Une fois l’ensemble de ces éléments complétés et vérifiés (mode de publication, description SEO), validez pour **acter la publication** de la pétition.
# Gérer le questionnaire associé à la pétition
Lorsqu’une nouvelle pétition est créée, un questionnaire correspondant est automatiquement créé dans l’onglet Questionnaire. Accédez à cet onglet pour retrouver et éditer ce questionnaire.
#### 1. Accèder au questionnaire de la pétition
Pour chaque nouvelle pétition créée, un questionnaire est automatiquement créé dans l'onglet **Questionnaires** du menu **Mes Pages**. Ce questionnaire est complètement éditable, comme tous les questionnaires d'Open Action.
**Attention** : Un questionnaire lié à une pétition ne peut pas être supprimé si la pétition correspondante n'est pas supprimée.
***
#### 2. Enrichir et mettre à jour le questionnaire
Par défaut un questionnaire de pétition est généré avec des champs type (nom, prénom, optin email, etc).
Vous pouvez compléter et modifier le questionnaire à tout moment en :
* Ajoutant des tags de votre choix pour qualifier les répondant·es.
* Composant les **questions** et champs selon vos objectifs de collecte d’information.
Une fois les modifications effectuées, poursuivez et **mettez à jour** le questionnaire pour enregistrer vos ajustements.
***
#### 3. Consulter et exporter les réponses
Pour suivre les résultats de votre pétition, sélectionnez le questionnaire associé de votre choix et cliquez sur **Réponses** afin de consulter l’ensemble des réponses et informations collectées.
Vous pouvez également **exporter les réponses** pour une analyse ou un traitement ultérieur.
# Événements
> Cet article décrit la procédure complète pour créer un nouvel événement dans Open Action, depuis l’accès au formulaire de création jusqu’à la configuration des inscriptions, de la visibilité et de la publication.
#### Étape 1 : Accéder à la création d’un événement
Dans Open Action, ouvrez l’onglet **Événement** du menu **Mes pages**. Pour lancer la création, cliquez sur le bouton **Créer le premier événement** ou **Nouvel événement**.
#### Étape 2 : Renseigner les informations générales de l’événement
Dans la modale de création d’événement, ajoutez d’abord une **image de couverture**.
Saisissez ensuite le **titre** de l’événement ainsi qu’une **description** claire et complète.
Ajoutez, si nécessaire, des **tags** qui seront attribués automatiquement aux contacts participant à l’événement.
#### Étape 3 : Définir les détails pratiques de l’événement
Renseignez les **détails de l’événement** :
* la date et l’heure de début,
* le **fuseau horaire**,
* l’**adresse** du lieu (ou les informations nécessaires pour un événement en ligne).
#### Étape 4 : Configurer la gestion des inscriptions
Choisissez ensuite comment seront gérées les **inscriptions** à l’événement. Deux options sont possibles :
1. **Formulaire d’inscription intégré dans Open Action (option par défaut)** Sélectionnez l’option de création automatique d’un formulaire d’inscription intégré. Cette configuration permet de :
* collecter directement les contacts dans la **base de contacts** d’Open Action,
* faciliter le **suivi** de l’événement.
2. **Redirection vers un lien externe**
Choisissez cette option pour renvoyer vers un **formulaire d’un partenaire** ou vers toute autre page externe.
Dans ce cas, renseignez :
* le **texte du bouton** de renvoi
* l’**URL de redirection :** le lien de votre partenaire ou le lien externe d'inscription
#### Étape 5 : Choisir la visibilité et la date de publication
À l’étape suivante, définissez la **visibilité** de l’événement :
* visible pour le **grand public**, ou
* visible uniquement pour les **membres** disposant d’un espace membre actif.
Indiquez ensuite la **date de publication** :
* **Publication instantanée**, ou
* **Publication programmée** à une date et une heure ultérieures.
**Important** : Les évènements sont publiés sur votre site ou votre plateforme d'action à la date de publication souhaité, mais en affichant **la date de début** de l'évènement. Ils restent visibles en ligne jusqu'à la fin de l'évènement, avant d'être retirés automatiquement.
#### Étape 6 : Modifier le questionnaire d’inscription si nécessaire
Si vous avez choisi l’option **Création d’un questionnaire** pour collecter les inscriptions, un questionnaire est automatiquement créé dans l’onglet **Questionnaire**. Vous pouvez ensuite l’ouvrir, l’éditer et le faire évoluer selon vos besoins (questions, champs, mise en forme, etc.).
# Questionnaire
# Créer et publier un questionnaire
> Le questionnaire est un outil de **qualification** puissant dans Open Action : chaque réponse enrichit automatiquement votre base de contacts. Formulaire de contact, inscription à une action, consultation militante, recueil de témoignages... c'est le pont entre votre communauté et votre base de données.
### Étape 1 : Créer le questionnaire
Rendez-vous dans le menu **Mes pages**, puis ouvrez l'onglet **Questionnaires**. Cette page regroupe tous vos questionnaires, leur statut (En ligne / Brouillon), leur visibilité et leur nombre de vues. Cliquez sur **Nouveau questionnaire** pour démarrer.
{% hint style="info" %}
**Bonne pratique** : donnez à chaque questionnaire un titre orienté action, formulé du point de vue du répondant (« S'inscrire au Café débat », « Soutenir NoPlastics ») plutôt qu'un titre interne (« Formulaire v2 »). Ce titre est visible publiquement : c'est votre premier levier de conversion.
{% endhint %}
### Étape 2 : Définir les paramètres généraux
En tête de votre questionnaire, renseignez :
* **Le titre** : l'accroche visible par vos visiteurs ;
* **La description** : une phrase qui explique pourquoi répondre (« Faites-nous remonter vos questions et remarques ») ;
* **Les tags à attribuer** : les tags qui seront automatiquement ajoutés aux contacts qui répondent ;
* **La page de destination après validation** : l'URL vers laquelle rediriger le répondant. Laissez vide pour utiliser la page de remerciement standard.
{% hint style="success" %}
**Le réflexe qui change tout : les tags.** C'est ici que se joue la valeur de votre questionnaire pour la suite. Un contact tagué « ADHERENT » ou « CAFE-DEBAT-2026 » pourra être re-mobilisé précisément par une future campagne email ou SMS. Définissez une convention de nommage de tags dès maintenant (par exemple `ACTION-LIEU-ANNEE`) et tenez-vous-y : dans 6 mois, avec 40 tags, vous vous remercierez.
{% endhint %}
{% hint style="info" %}
**Page de destination personnalisée** : redirigez vers une page qui prolonge l'engagement — proposition de don, adhésion, partage sur les réseaux — plutôt qu'un simple « merci ». Un répondant vient de faire un premier pas : c'est le meilleur moment pour lui en proposer un deuxième
{% endhint %}
### Étape 3 : Construire le formulaire
Le formulaire se construit par **blocs** : des blocs de contenu (titres, paragraphes) pour structurer, et des champs pour collecter. Chaque bloc peut être réordonné (flèches ou glisser-déposer), dupliqué ou supprimé, et chaque champ peut être rendu **obligatoire** via l'interrupteur dédié.
{% hint style="warning" %}
**Chaque champ obligatoire coûte des réponses.**
La règle d'or issue du terrain : ne rendez obligatoire que ce dont vous avez besoin pour cette action précise. L'email est indispensable (c'est lui qui crée ou met à jour le contact), le prénom aide à personnaliser vos futurs emails... le reste se discute.
Un formulaire de 4 champs convertit presque toujours mieux qu'un formulaire de 10. Vous pourrez toujours re-qualifier vos contacts plus tard avec un second questionnaire.
{% endhint %}
{% hint style="info" %}
Pour le détail de tous les types de champs disponibles (contenu, collecte de données, champs automatiques, tags conditionnels), consultez l'article dédié.
{% endhint %}
{% content-ref url="/pages/msJpuM0Tw39lL1Eb8OCX" %}
[Maîtriser les champs du questionnaire](/creer-son-site-internet/creer-du-contenu/questionnaire/maitriser-les-champs-du-questionnaire)
{% endcontent-ref %}
### Étape 4 : Vérifier et publier
L'écran récapitulatif vous confirme que le questionnaire est prêt et résume ses éléments clés : titre, description, nombre de questions et page de destination. C'est aussi ici que vous définissez sa **visibilité** :
* **Public** : visible par tous, référencé par les moteurs de recherche ;
* **Membres uniquement** : accessible aux seuls membres connectés de votre espace membre.
{% hint style="warning" %}
**Avant de publier, testez comme un militant, pas comme un administrateur.**
Ouvrez le lien public sur votre téléphone, remplissez le formulaire vous-même, et vérifiez trois choses : la réponse apparaît bien dans les résultats, le contact créé porte les bons tags, et la page de destination s'affiche correctement.
Cinq minutes de test évitent une semaine de collecte de données inutilisables.
{% endhint %}
### Étape 5 : Diffuser auprès de votre communauté
Une fois le questionnaire publié ou mis à jour, l'écran de confirmation vous propose les outils de diffusion : **copier le lien** ou partager directement sur **Facebook, LinkedIn et WhatsApp**.
{% hint style="success" %}
**Stratégies de diffusion éprouvées** :
1. **Campagne email à votre base** : c'est votre canal le plus fiable, sans algorithme. Un email dédié avec le lien en bouton d'action convertit mieux qu'une mention en bas de newsletter.
2. **WhatsApp / boucles militantes** : le partage de pair à pair reste le plus puissant. Fournissez à vos relais un message court prêt à copier-coller avec le lien.
3. **Réseaux sociaux** : utile pour toucher au-delà de votre base, mais attendez-vous à des taux de réponse plus faibles. Publiez plusieurs fois : une seule publication ne touche qu'une fraction de votre audience.
Et surtout : fixez une **échéance explicite** (« Répondez avant le 15 mars ») et faites une **relance** à mi-parcours auprès des non-répondants. La relance génère typiquement 30 à 50 % des réponses totales.
{% endhint %}
### Gérer vos questionnaires au quotidien
Depuis la liste des questionnaires, chaque carte donne accès aux actions courantes : **Voir** la page publique, **Éditer** le formulaire, consulter les **réponses**, **Dupliquer**, **Déplacer** ou **Supprimer**.
{% hint style="info" %}
**Dupliquer plutôt que repartir de zéro** : si vous organisez des actions récurrentes (cafés débats mensuels, permanences...), créez un questionnaire modèle bien construit, puis dupliquez-le pour chaque édition en changeant simplement le titre et les tags. Vous gagnez du temps et vos données restent homogènes.
{% endhint %}
# Consulter et exploiter les réponses
Consultez, analysez et exploitez les réponses à vos questionnaires pour transformer la collecte en mobilisation.
Collecter des réponses n'est que la moitié du travail : leur exploitation est ce qui transforme un questionnaire en levier de mobilisation. Cette page vous guide dans la consultation des réponses, leur export et les bons réflexes d'analyse.
### Accéder aux réponses
Deux chemins mènent aux réponses d'un questionnaire :
* Depuis la liste des questionnaires (**Mes pages → Questionnaires**), via le menu **⋮** de la carte du questionnaire, entrée **réponse(s)** ;
* Depuis l'écran récapitulatif du questionnaire, bloc **Réponses reçues**, lien **Voir les réponses**.
Le compteur de réponses est également visible en permanence dans le bandeau de l'éditeur : vous suivez la collecte en temps réel, même en cours de modification.
{% columns %}
{% column %}
{% endcolumn %}
{% column %}
{% endcolumn %}
{% endcolumns %}
***
### La liste des réponses
La page de résultats affiche l'ensemble des réponses reçues, avec pour chacune :
* **Le contact** : l'adresse email du répondant, cliquable vers sa fiche ;
* **La date** de la réponse ;
* Les actions **Voir** (détail de la réponse) et **Supprimer**.
Le bouton **Exporter les réponses**, en haut de page, télécharge l'ensemble des données pour une analyse externe.
{% hint style="info" %}
**Le rythme de consultation du questionnaire compte autant que le contenu.** Pendant la phase de collecte, consultez les réponses dès les premières 24 heures — pas à la fin. Trois signaux à surveiller : le volume (la diffusion fonctionne-t-elle ?), les questions laissées vides (un champ mal compris ou trop intrusif ?) et la qualité des emails collectés. Détecter un problème au jour 1 vous permet de corriger le formulaire ou la diffusion pendant qu'il est encore temps.
{% endhint %}
{% hint style="warning" %}
La s**uppression d'une réponse est définitive.** Utilisez-la pour les doublons évidents et les réponses de test, mais dans le doute, conservez : une réponse partielle contient souvent au moins un email exploitable. Pensez aussi au fait que la suppression d'une réponse ne supprime pas le contact créé, et inversement.
{% endhint %}
### Le détail d'une réponse
Cliquez sur **Voir** pour ouvrir le détail complet d'une réponse : l'ensemble des champs remplis par le répondant (identité, coordonnées, réponses aux questions), avec un lien direct vers la fiche du contact émetteur.
{% hint style="info" %}
**Le réflexe militant :** traiter les réponses à forte valeur individuellement.
Certaines réponses appellent une action humaine rapide : un témoignage fort, une proposition de coup de main, une personne qui indique vouloir s'engager davantage.
Désignez un·e responsable qui parcourt les réponses détaillées chaque semaine et recontacte personnellement ces profils sous 48 h.
Un volontaire recontacté rapidement s'engage ; un volontaire recontacté trois semaines plus tard est déjà passé à autre chose.
{% endhint %}
***
### Exporter les réponses
Le bouton **Exporter les réponses** vous permet de récupérer l'ensemble des données pour :
* une **analyse quantitative** dans un tableur (tris croisés, statistiques de réponses) ;
* un **partage** avec votre équipe ou vos instances (bureau, conseil, AG) ;
* un **archivage** avant modification ou suppression du questionnaire.
{% hint style="info" %}
**Bonnes pratiques d'export** :
* Exportez **avant toute modification structurelle** du questionnaire (suppression de champ) : c'est votre photographie de référence.
* Pour une consultation militante, préparez une **synthèse courte** (5 chiffres clés + 3 verbatims) plutôt que de diffuser l'export brut : c'est elle qui circulera et sera lue.
* **Attention à la donnée personnelle** : un export contient des emails, téléphones et adresses. Limitez sa diffusion aux personnes qui en ont besoin, stockez-le dans un espace maîtrisé et supprimez les copies locales une fois l'analyse faite. Votre crédibilité auprès de vos contacts en dépend.
{% endhint %}
***
### De la réponse à la mobilisation : boucler la boucle
Les réponses ne sont pas une fin : elles alimentent le cycle **acquisition → qualification → mobilisation** d'Open Action.
1. **Les contacts créés** par le questionnaire rejoignent votre base, enrichis de leurs attributs (via les champs automatiques) ;
2. **Les tags attribués** (systématiques ou conditionnels) forment des segments prêts à l'emploi ;
3. **Votre prochaine campagne** email ou SMS cible précisément ces segments, par exemple tous les répondants tagués `BENEVOLE-LOGISTIQUE`.
{% hint style="success" %}
**Le geste qui fidélise : le retour aux répondants.** Dans les deux semaines qui suivent la clôture, envoyez une campagne email aux répondants avec les enseignements du questionnaire (« Vous avez été 214 à répondre, voici ce que vous nous avez dit, et ce que nous allons en faire »). C'est le geste le plus rentable de tout le parcours : il prouve que répondre sert à quelque chose, et il conditionne directement le taux de réponse de votre *prochain* questionnaire.
{% endhint %}
# Maîtriser les champs du questionnaire
Découvrez en détail tous les types de champs du questionnaire : contenu, collecte de données, champs automatiques et tags conditionnels.
## Maîtriser les champs du questionnaire
L'éditeur de questionnaire propose quatre familles de champs, chacune avec un rôle précis. Bien les combiner fait la différence entre un simple formulaire et un véritable **outil de qualification** de votre base de contacts.
Les quatre familles :
1. **Contenu personnalisé** — structurer et guider le répondant ;
2. **Récolte de données** — poser vos questions ;
3. **Champs automatiques** — mettre à jour la fiche contact ;
4. **Tags automatiques** — segmenter dès la réponse.
### 1. Le contenu personnalisé : structurer votre formulaire
Ces blocs n'attendent pas de réponse : ils servent à organiser et contextualiser votre formulaire.
* **Titre** : sépare les grandes sections du formulaire ;
* **Paragraphe** : texte d'explication ou de contexte ;
* **HTML personnalisé** : pour les besoins avancés (mise en forme spécifique, contenu embarqué).
{% hint style="info" %}
**Bonne pratique :** pour un questionnaire de plus de 5 questions, insérez des titres de section et un court paragraphe d'introduction qui annonce le temps de réponse (« 2 minutes suffisent »). Le répondant qui sait où il va va jusqu'au bout. Utilisez aussi un paragraphe pour expliquer pourquoi vous posez une question sensible (téléphone, adresse) : la transparence augmente nettement le taux de complétion de ces champs.
{% endhint %}
### 2. La récolte de données : poser vos questions
Ces champs collectent les réponses de vos visiteurs. Chacun peut être rendu **obligatoire** ou non :
#### Quelques usages habituels pour les organisations militantes
| Champ | Usage typique en mobilisation |
| --------------------- | ----------------------------------------------------------- |
| **Réponse courte** | Nom d'un collectif local, profession, ville de l'action |
| **Réponse longue** | Témoignage, motivation, remarques libres |
| **Choix** (unique) | Niveau d'engagement souhaité, créneau de disponibilité |
| **Cases à cocher** | Compétences à proposer (tractage, logistique, juridique...) |
| **Confirmation** | Acceptation d'une charte, engagement de présence |
| **Liste déroulante** | Département, fédération, section locale |
| **Évaluation** | Satisfaction après un événement |
| **Montant financier** | Promesse de don, cotisation libre |
| **Date / Heure** | Disponibilités pour une action |
| **Fichier** | Photo, document justificatif, visuel militant |
{% hint style="success" %}
**Choisir le bon type de champ, c'est préparer l'analyse.**
Tout ce qui peut être un **choix fermé** (Choix, Liste déroulante, Cases à cocher) doit l'être.
La réponse libre (Réponse longue) se réserve aux témoignages et verbatims, là où la richesse du texte est justement ce que vous cherchez.
{% endhint %}
### 3. Les champs automatiques : enrichir la fiche contact
C'est la fonctionnalité la plus puissante du module. Les champs automatiques ne se contentent pas de collecter une réponse : ils **créent ou mettent à jour directement la fiche du contact** dans votre base.
Plus de 25 champs sont disponibles : identité (civilité, prénom, nom, date de naissance...), coordonnées (email, téléphones, adresse postale complète), réseaux sociaux (Facebook, Twitter, LinkedIn, Telegram, WhatsApp), vie professionnelle (entreprise, métier) et **opt-ins** (email, SMS, appels).
{% hint style="warning" %}
**Le champ Email est la clé de voûte** : aucun contact n'est créé ou mis à jour si l'adresse email n'est pas demandée dans le formulaire. Si votre objectif est d'enrichir votre base, le champ automatique Email doit être présent et obligatoire — c'est non négociable.
{% endhint %}
{% hint style="success" %}
**Les opt-ins conditionnent vos futures campagnes.**
Ajoutez systématiquement les champs **Opt-in email** (et **Opt-in SMS** si vous faites des campagnes SMS) : c'est ce consentement, collecté proprement, qui vous permettra légalement (RGPD) et techniquement de recontacter ces personnes. Un contact sans opt-in est un contact que vous ne pourrez pas mobiliser. Formulez la demande de façon engageante : « Je souhaite être informé·e des prochaines actions » fonctionne mieux qu'un « J'accepte de recevoir des emails ».
{% endhint %}
{% hint style="info" %}
**Utilisez les champs automatiques plutôt que des réponses courtes** pour toute donnée de profil : demander le prénom via une « Réponse courte » stocke l'information dans les résultats du questionnaire uniquement, alors que le champ automatique **Prénom** l'inscrit sur la fiche contact — réutilisable ensuite pour personnaliser tous vos emails.
{% endhint %}
### 4. Les tags automatiques : segmenter dès la réponse
Trois mécanismes permettent d'associer des tags aux contacts au moment de l'envoi du formulaire :
* **Ajouter un tag selon la réponse à un choix unique** : le tag dépend de l'option choisie ;
* **Ajouter des tags selon la réponse à un choix multiple** : un tag par case cochée ;
* **Toujours ajouter un ou plusieurs tags lors de l'envoi** : tous les répondants reçoivent ces tags.
{% hint style="success" %}
**Un exemple de questionnaire de terrain réussi**
Posez la question « Comment souhaitez-vous vous engager ? » en **cases à cocher** (Tractage / Logistique / Communication / Dons), associée au champ « Ajouter des tags selon la réponse à un choix multiple ».
**Résultat :** dès la clôture de votre questionnaire, vous disposez de segments prêts à l'emploi. Vous pouvez envoyer la campagne « Tractage samedi » aux seuls contacts tagués `TRACTAGE`, sans aucun tri manuel.
Combinez avec un tag systématique (par exemple `QUESTIONNAIRE-RENTREE-2026`) pour garder la trace de l'origine de chaque contact.
{% endhint %}
***
### Construire un formulaire équilibré : la méthode
Un bon questionnaire militant combine les quatre familles dans cet ordre :
1. Un **Titre** + un **Paragraphe** d'introduction (le pourquoi, le temps de réponse) ;
2. Les **champs automatiques** d'identité : Email (obligatoire), Prénom, et les opt-ins ;
3. Vos **questions de qualification** en choix fermés, reliées à des **tags conditionnels** ;
4. Une **Réponse longue** facultative en fin de parcours (« Un mot à nous transmettre ? ») ;
5. Un **tag systématique** qui trace l'origine de la réponse.
{% hint style="info" %}
**Testez l'équilibre** :
Si votre formulaire dépasse 8 champs visibles, demandez-vous pour chacun « Vais-je réellement utiliser cette donnée dans les 3 prochains mois ? ».
Si la réponse est non, supprimez le champ. Vous pourrez toujours re-solliciter vos contacts plus tard ( c'est même une excellente occasion de recontact).
{% endhint %}
# Notifications emails automatiques
Configurer des emails automatique envoyés au moment de la validation du questionnaire.
{% hint style="info" %}
Cette page couvre uniquement le cas de la notification liée à un questionnaire. Pour découvrir toutes les possibilités du module (déclencheurs liés aux événements, aux adhésions, emails différés, contenu dynamique...), consultez la page dédiée aux automatisations.
{% endhint %}
### Prérequis
* Un **questionnaire publié** (voir Créer et publier un questionnaire) ;
* L'**adresse email** de la personne ou de l'équipe à notifier ;
* Un accès au module **Automatisations** de votre projet.
***
### 1. En tant que responsable, être notifié à chaque nouvelle réponse
Plutôt que de consulter la liste des réponses manuellement, vous pouvez déclencher une **notification automatique par email** vers la personne qui suit le questionnaire, à chaque fois qu'une réponse est envoyée.
Cette notification se configure dans le module **Automatisations** :
1. Créez une nouvelle automatisation et nommez-la explicitement (par exemple « Notification réponses — Opération Zéro Déchet ») ;
2. Choisissez le déclencheur **Lorsqu'une réponse à un questionnaire est envoyée** ;
3. Réglez le **délai** sur **Immédiatement** ;
4. Sélectionnez le **questionnaire** concerné ;
5. Renseignez le sujet et l'émetteur de l'email, puis dans la section **Destinataire**, choisissez **À une adresse email spécifique** et indiquez l'adresse du ou de la responsable du suivi.
{% hint style="success" %}
**Le duo gagnant : notification interne + confirmation au répondant.** La même mécanique d'automatisation permet aussi d'envoyer un email **aux contacts concernés par l'automatisation**, c'est-à-dire aux répondants eux-mêmes. Créez donc deux automatisations sur le même questionnaire : l'une notifie votre responsable en interne (adresse spécifique), l'autre confirme au répondant que sa réponse est bien prise en compte. C'est ce qui rend possible le recontact sous 48 h évoqué plus haut , sans que personne n'ait à rafraîchir la page des résultats.
{% endhint %}
### Étape 2 : Rédiger l'email de notification
Renseignez ensuite le **Sujet** de l'email que recevra le ou la responsable, puis composez le contenu du message dans l'éditeur par blocs (paragraphes, titres, boutons, colonnes, images...). Pour une notification interne, un ou deux blocs **Paragraphes** suffisent largement.
{% hint style="info" %}
**Pensez « boîte de réception du responsable », pas « communication militante ».** Cet email est un outil de travail interne : un sujet factuel et constant du type « Nouvelle réponse — Opération Littoral » est ici préférable à un sujet accrocheur. Il permet de repérer les notifications d'un coup d'œil et de créer une règle de filtrage automatique dans la messagerie (dossier dédié, libellé, transfert vers un canal d'équipe).
{% endhint %}
{% tabs %}
{% tab title="Notification simple" %}
Bonjour,
Vous avez reçu une nouvelle réponse au questionnaire \[Nom du questionnaire].
Consulter les réponses : \[URL de votre console Open Action]
— Notification automatique OpenAction
{% endtab %}
{% tab title="Avec consigne de traitement" %}
Bonjour,
Une nouvelle personne vient de s'inscrire via le questionnaire \[nom du questionnaire].
À faire :
1. Consulter sa réponse sur Open Action.
2. Vérifier sa fiche contact et ses tags
3. La recontacter sous 48 h si elle propose un coup de main
En cas d'absence, transférer à : \[adresse de l'équipe]
— Notification automatique OpenAction
{% endtab %}
{% endtabs %}
{% hint style="info" %}
**Bonnes pratiques :**
* Utilisez la notification immédiate pour les questionnaires à fort enjeu individuel (propositions de bénévolat, demandes de contact) où la réactivité compte. Pour un questionnaire à gros volume (consultation nationale), préférez un point quotidien sur la liste des réponses : une notification par réponse deviendrait du bruit.
* Dirigez la notification vers une adresse suivie collectivement (par exemple celle de l'équipe mobilisation) plutôt que vers la boîte personnelle d'un·e seul·e bénévole : le suivi survit ainsi aux absences et aux départs.
* Donnez un sujet explicite à l'email de notification pour permettre un filtrage automatique dans la boîte de réception.
{% endhint %}
# Gérer mon groupe
# Utiliser l'éditeur de contenu
L'éditeur de contenu de Citipo est l'outil que vous utilisez à chaque fois que vous souhaitez créer du contenu sur votre site internet ou créer des campagnes emails.
L'éditeur de contenu de Citipo est utilisé à de nombreux occasions dans la plateforme : pages, actualités, campagnes emails, trombinoscope, ... Son fonctionnement est cependant toujours sensiblement le même.
## Présentation générale
1. **Au centre de la page, la section "Pas de contenu" correspond à la zone éditable de votre contenu**. C'est dans cette zone que vous pourrez ajouter votre texte, vos images, vos post sociaux, vos cartes Google Maps, et bien d'autres choses, comme nous allons le voir.
2. **Au dessus de celle-ci,** **vous retrouvez le titre du contenu** (ici le titre de la page "Données personnelles"), que vous pouvez aussi modifier. Vous retrouverez au même emplacement le titre de votre actualité lors de l'édition d'une actualité, le titre de votre proposition de programme lors de son édition, ...
3. **Sur la droite de la page est présente une barre d'outils**. Cette barre d'outils vous permettra de modifier le contenu que vous êtes en train de réaliser, par exemple pour mettre du texte en gras, pour ajouter un lien, pour changer la couleur du texte, etc.
4. Enfin, **en haut de page vous retrouverez une barre d'état et d'actions** : cette barre correspond à l'état de votre contenu ("Sauvegardé" ou "Sauvegarde en cours ...") ainsi qu'à des actions que vous pouvez réaliser sur celui-ci : modifier les détails du contenu (image, description, ...), publier ce contenu dans le cas où le contenu est en brouillon, partager le contenu sur les réseaux sociaux, le voir sur le site, etc.
{% hint style="info" %}
Tous les contenus de Citipo n'ont pas les mêmes possibilités : il est par exemple possible de faire beaucoup plus de choses sur un site internet que dans un email. L'éditeur de contenu sera donc légèrement différent selon le contenu que vous éditez.
{% endhint %}
## Les blocs de contenu
La zone la plus importante de l'éditeur est donc bien sûr la zone (1), la zone dans laquelle vous allez insérer votre texte, vos images et tous les autres éléments que vous souhaitez faire apparaitre sur votre site ou votre email.
Cette zone s'organise grâce à un système appelé **les blocs de contenus**. Ces blocs correspondent à des petites parties de votre contenu : en les enchainant, vous pourrez créer des contenus complets.
{% hint style="info" %}
Le concept de blocs est très pratique car il permet à Citipo d'adapter l'affichage de ces blocs selon l'appareil utilisé : grâce aux blocs, **votre contenu sera donc naturellement adapté aussi bien aux ordinateurs qu'aux téléphones**.
{% endhint %}
Pour insérer un premier bloc, cliquez sur la zone "Pas de contenu". Un menu apparait alors :
**Vous pouvez ainsi choisir différents blocs à ajouter à votre contenu** : un paragraphe pour du texte classique, un titre, une image, différents niveaux de titres, une liste, une citation, du code, un tableau, un espace ou un bouton.
Il existe aussi un bouton "Plus ..." qui vous donne accès à encore plus de blocs :
Quelque soit le bloc que vous choisissez, vous pouvez l'insérer puis éditer son contenu :
Enfin, l'objectif de tout contenu est d'enchainer différents types de blocs pour réaliser des contenus engageants. Pour cela, vous pouvez cliquer sur le petit bouton **Plus** orange apparaissant lorsque vous avez cliqué sur le bloc :
De cette manière, vous pouvez réaliser des contenus complets et interactifs :
# Intégrer un post social
{% hint style="info" %}
Si vous découvrez l'éditeur de contenu, lisez d'abord le guide suivant :\
[Utiliser l'éditeur de contenu](https://docs.citipo.com/guides/utiliser-lediteur-de-contenu)
{% endhint %}
## Présentation générale
Pour intégrer un post social (Facebook, Twitter, ...) dans une page, une actualité ou tout autre contenu du site internet, il est possible d'utiliser le bloc "**HTML/CSS/JavaScript**".
Ce bloc "HTML/CSS/JavaScript" vous permet d'ajouter à vos contenus tout type de code fournit par des outils externes, notament Facebook, Twitter, LinkedIn, etc.
{% hint style="info" %}
**Il n'est pas possible d'intégrer un post social dans une campagne email**. Cela est du aux limitations techniques de ces vecteurs. Si vous souhaitez intégrer un contenu social, vous pouvez utiliser une capture d'écran de ce contenu (une image) ou ajouter un lien vers un article de votre site internet.
{% endhint %}
Pour ajouter un bloc de ce types, cliquez sur le **Plus** orange en dessous du bloc après lequel ajouter votre post social, puis cliquez sur le bouton "Plus ..." pour ouvrir les blocs additionels :
Cliquez sur le bloc appelé HTML/CSS/JavaScipt. Une fois ce bloc ajouté, une icône apparaîtra en haut à droite du bloc, en forme d'engrenage en gris foncé sur fond gris clair :
En cliquant sur cette icône, vous obtiendrez un éditeur de code HTML. Vous pouvez supprimer tout le code existant et le remplacer par le code HTML du post que vous souhaitez intégrer.
Ce code HTML peut être récupéré différemment selon le réseau social que vous souhaitez utiliser. Pour les plus classiques :
## Intégrer un tweet
Sur Twitter, vous trouverez ce code dans l'option "Intégrer le tweet" (ou "Embed the tweet" en anglais) :
## Intégrer un post Meta
Sur Facebook, vous trouverez ce code dans l'option "Intégrer" ou "Embed" en anglais :
# Vue d'ensemble
# Campagne E-mails
Créer et envoyer une campagne email
Les campagnes emails vous permettent de communiquer directement avec vos contacts, sans algorithme : pour les informer, les inviter à agir ou leur demander leur avis.
### Étape 1 : Choisir votre éditeur
Dans un projet,cliquez sur **E-mail**, puis sur **Créer une campagne**. Vous êtes alors invité·e à choisir le mode de création de votre campagne :
* **Éditeur simplifié** : une mise en page rapide avec un titre, une image, un texte et un bouton unique. Il reprend automatiquement les couleurs de votre projet et le rendu est optimisé pour mobile et bureau.
* **Éditeur avancé** : l'éditeur Unlayer complet, avec de blocs modulables , pour partir d'un modèle ou d'une page blanche et construire des mises en page riches avec des variables.
### Étape 2 : Rédiger le contenu
Renseignez ensuite les trois éléments principaux de votre email :
* **L'objet de votre campagne** : il sert aussi de titre à la campagne dans votre interface.
* **Le corps du message** : le texte principal de votre email.
* **Le bouton d'action** : le texte du bouton et le lien vers lequel il pointe.
* **L'objet** : visez 30 à 50 caractères, avec l'information clé au début. C'est lui qui détermine si votre email sera ouvert. Évitez les majuscules excessives et les points d'exclamation multiples, qui peuvent déclencher les filtres anti-spam.
* **Le corps** : un message court et direct fonctionne mieux. Une idée par email, et une question simple à laquelle le message répond : qui, quoi, quand, où, comment.
* **Le bouton d'action** : utilisez un verbe d'action explicite (« Je m'inscris », « Participer à la soirée ») plutôt qu'un générique « Cliquez ici ». Vérifiez systématiquement que le lien est correct et commence par `https://`.
Utilisez le lien **Prévisualiser mon email** dès cette étape pour vérifier le rendu de votre message au fur et à mesure de sa rédaction.
### Étape 3 : Configurer l'émetteur
Définissez ensuite l'identité d'envoi de votre campagne :
* **Adresse email** : la partie locale de l'adresse d'envoi (par exemple `no-reply`), associée au domaine de votre projet.
* **Nom émetteur** : le nom affiché dans la boîte de réception de vos destinataires.
* **Adresse de réponse** *(facultatif)* : l'adresse qui recevra les réponses à cet email, avec le nom associé.
**Bonnes pratiques** :
* Préférez un **nom émetteur incarné** (« Adrien de NoPlastics ») plutôt qu'un nom d'organisation seul : les emails signés par une personne sont davantage ouverts.
* Même si vous envoyez depuis une adresse `no-reply`, **définissez toujours une adresse de réponse** réelle et consultée. Cela permet à vos contacts de vous joindre facilement et améliore votre réputation d'envoi.
* Gardez le même émetteur d'une campagne à l'autre : la régularité crée la confiance et la reconnaissance.
### Étape 4 : Sélectionner les destinataires
Choisissez à qui la campagne doit être envoyée, selon trois modes :
* **Envoyer à un filtre enregistré** : envoi aux contacts correspondant aux critères d'un filtre que vous avez sauvegardé.
* **Envoyer à des tags** : envoi aux contacts ayant les tags sélectionnés.
* **Envoyer à une liste** : envoi à une liste spécifique d'adresses email.
Le nombre de destinataires correspondant à votre sélection s'affiche en bas de l'écran.
**Bonnes pratiques de ciblage** :
* **Segmentez vos envois** : un message pertinent pour un sous-groupe précis (participants d'un événement, contacts d'une ville, nouveaux inscrits) obtient de meilleurs résultats qu'un envoi massif à toute la base.
* **Vérifiez le compteur de destinataires** avant de poursuivre : un chiffre anormalement haut ou bas révèle souvent une erreur de filtre ou de tag.
* N'envoyez qu'aux contacts ayant **consenti à recevoir vos emails** : c'est à la fois une obligation légale (RGPD) et la garantie d'une bonne délivrabilité.
### Étape 5 : Tester votre campagne
Avant tout envoi réel, envoyez-vous un email de test pour vérifier le rendu, via le bouton **Envoyer un e-mail test**.
Vous pouvez également prévisualiser le contenu complet de la campagne : émetteur, objet et corps du message, tels qu'ils apparaîtront chez vos destinataires.
**Ne sautez jamais cette étape.** Lors de la lecture de votre email test, vérifiez systématiquement :
* l'objet et le nom d'émetteur affichés dans la boîte de réception ;
* l'orthographe et la mise en forme du message ;
* le fonctionnement de **tous les liens**, en particulier celui du bouton d'action ;
* le rendu sur **mobile**, où la majorité des emails sont désormais lus ;
* que l'email n'arrive pas dans le dossier spam.
Idéalement, faites relire l'email test par une seconde personne : un regard neuf repère les coquilles que vous ne voyez plus.
### Étape 6 : Programmer ou envoyer
Une fois votre campagne prête, elle apparaît dans l'onglet **Brouillons** de la page Campagne e-mail. Vous pouvez encore la modifier via **Modifier la campagne**, ou lancer l'envoi avec le bouton **Programmer**.
Une fenêtre de confirmation récapitule alors l'objet, l'émetteur et le nombre de destinataires. Deux options s'offrent à vous :
* **Envoyer maintenant** : la campagne part immédiatement.
* **Programmer plus tard** : choisissez une date et une heure futures d'envoi.
Cliquez sur **Confirmer l'envoi** pour valider.
**L'envoi d'une campagne est irréversible.** Prenez le temps de relire le récapitulatif : objet, émetteur et nombre de destinataires. En cas de doute, cliquez sur **Annuler** et refaites un email test.
**Bonne pratique** : programmez vos envois aux moments où vos contacts consultent leurs emails, généralement en début de matinée ou en début de soirée en semaine. Testez différents créneaux sur plusieurs campagnes et comparez les taux d'ouverture pour identifier ce qui fonctionne le mieux avec **votre** communauté.
### Étape 7 : Analyser le rapport
Après l'envoi, un rapport détaillé est disponible pour chaque campagne, depuis l'onglet **Envoyés**. Il présente les indicateurs clés :
* **Délivrés** : emails arrivés avec succès chez vos destinataires ;
* **Ouvertures** : destinataires ayant ouvert votre email ;
* **Clics** : destinataires ayant cliqué sur un lien ;
* **Soft bounces** : rebonds temporaires (boîte pleine, serveur hors-ligne...) ;
* **Hard bounces** : adresses invalides ou bloquées définitivement ;
* **Désinscriptions** : personnes ne souhaitant plus recevoir vos emails.
Vous pouvez **exporter** ces données ou **dupliquer la campagne** pour la réutiliser comme base d'un prochain envoi.
**Bonnes pratiques d'analyse** :
* Le **taux d'ouverture** reflète surtout la qualité de votre objet et de votre nom d'émetteur ; le **taux de clic**, celle de votre contenu et de votre bouton d'action.
* Surveillez les **hard bounces** : des adresses invalides récurrentes dégradent votre réputation d'envoi. Nettoyez régulièrement votre base de contacts.
* Un pic de **désinscriptions** signale souvent un envoi trop fréquent ou un ciblage trop large : ajustez votre segmentation.
* Comparez vos campagnes entre elles dans la durée : c'est l'évolution de vos propres indicateurs, plus que des moyennes du secteur, qui vous guidera.
# Campagnes SMS
# Campagne d'Appels
# Vue d'ensemble
# Rapport de trafic
# Rapport de communauté
# Afficher un bouton Citipo sur votre profil Twitter
Grâce à un outil appelé Twitter Revue, il est possible d'afficher un lien sur votre profil Twitter permettant à quiconque de rejoindre votre communauté en un clic avec leur compte Twitter.
[Twitter Revue](https://www.getrevue.co) est une entreprise acquise par Twitter en Janvier 2021. Elle vous permet de vous constituer une base de contacts emails directement depuis votre profil Twitter, en rendant l'inscription très facile et rapide grâce à un bouton unique.
%20Twitter.png?alt=media\&token=8fec92d0-7368-4387-9bf5-89ed5441f055)
Citipo vous propose une intégration avec Twitter Revue pour ajouter les contacts récupérés par cet intermédiaire directement à votre base de contacts Citipo.
Mettre en place cette fonctionnalité requiert plusieurs étapes :
## 1. Créer un compte Twitter Revue
Rendez-vous sur [https://www.getrevue.co](https://www.getrevue.co/) et cliquez sur "Start a newsletter for free". Vous pourrez alors vous inscrire à Twitter Revue grâce à votre compte Twitter.
{% hint style="info" %}
Soyez vigilant à bien vous inscrire à Twitter Revue avec le compte Twitter sur lequel vous souhaitez afficher le bloc Newsletter.
Vous pourrez créer plusieurs comptes Revue et tous les intégrer à Citipo si vous souhaitez afficher des blocs Newsletter sur plusieurs comptes Twitter en répétant le même processus.
{% endhint %}
## 2. Configurer le bloc Newsletter sur votre profil Twitter
Une fois inscrit(e) et connecté(e), cliquez en haut à droit sur l'image de votre profil puis sur **Account Settings** :
Ces paramètres de compte vous permettent de modifier la façon dont sera affiché le bloc Newsletter sur votre profil Twitter : son titre, sa description, si vous souhaitez afficher le nombre d'abonnés à votre newsletter, etc. Vous pouvez ainsi préparer l'affichage du bloc sur votre profil.
Une fois que vous avez indiqué les paramètres que vous souhaitez (vous pourrez les modifier à nouveau dans le futur bien sûr), vous pouvez activer le bloc Newsletter sur votre profil Twitter. Pour cela, rendez-vous sur la page **Intégrations** puis cliquez sur le bouton **Settings** dans le bloc Twitter :
Activez l'option **Show newsletter on Twitter profile** :
Une fois cela effectué, **vous devriez voir le bloc Newsletter apparaitre sur votre profil Twitter** !
## 3. Ajouter automatiquement les inscrits Twitter Revue à votre base de contacts Citipo
La dernière étape est de configurer Citipo pour que vos inscrits Twitter Revue soient automatiquement ajoutés à votre base de contacts.
Pour cela, rendez-vous à nouveau sur la page Intégrations dans votre compte Twitter Revue et descendez tout en bas de cette page. Vous y trouverez une **API key**, une clé qui permettra à Citipo d'accéder à votre compte :
Copiez la clé et gardez la à disposition.
Allez ensuite sur Citipo, dans la section Intégrations de votre organisation :
Cliquez sur le bouton **Configurer** dans le bloc **Twitter Revue**. Vous obtiendrez alors une liste pour le moment vide de tous les comptes Twitter Revue connectés à Citipo :
Cliquez sur Connecter un compte : il vous sera alors demandé l'identifiant de votre compte Twitter (celui sur lequel le bloc Newsletter est affiché) ainsi que la clé API récupéré à l'étape précédente.
Envoyez le formulaire : **ca y est, vos contacts sont désormais automatiquement synchronisés** !
{% hint style="info" %}
La synchronisation de vos inscrits Twitter Revue avec Citipo s'effectuera toutes les 15 minutes.
{% endhint %}
{% hint style="info" %}
Si vous le souhaitez, vous pouvez connecter plusieurs comptes Twitter sur la même organisation, en effectuant le processus décrit dans ce document à nouveau avec un compte Twitter Revue différent.
{% endhint %}
# Synchroniser la base de contacts avec Qomon
Qomon (anciennement appelé Quorum) est un logiciel en ligne permettant de mobiliser une communauté, d'organiser des actions de terrain et d'analyser et cartographier son impact.
Vous pouvez en découvrir plus sur .
Il est possible d'intégrer Citipo et Qomon afin que les contacts récupérés du coté de Citipo soient intégrés à votre base de contacts Qomon et vice-versa.
Pour cela, contactez-nous à , nous travaillerons avec les équipes de Qomon pour mettre en place l'intégration.
# Connecter Citipo à 250+ services avec Integromat
[Integromat](https://www.integromat.com/en) est un logiciel en ligne spécialisé dans la connexion entre services pour mettre en place des processus automatisés entre ceux-ci. C'est un concurrent d'outils comme Zapier, Integromat ayant l'intérêt d'être concçu et hébergé en Europe par des Européens, ce qui assure une bien meilleure confidentialité des données.
Citipo dispose d'une application Integromat vous permettant de l'intégrer dans vos workflows pour mettre en place des processus avancés.
{% hint style="info" %}
Pour le moment, l'application Citipo sur Integromat n'est pas publique : contactez-nous sur pour que nous activions votre accès à l'application.
{% endhint %}
## Obtenir le token Integromat dans Citipo
La première étape pour utiliser l'intégration Integromat dans Citipo est d'obtenir le token qui sera utilisé par Integromat pour accéder à votre organisation.
Pour cela, rendez-vous sur [Citipo](https://console.citipo.com) et cliquez sur le lien *"Intégrations"* dans le menu présent en haut de votre page :
Cliquez sur *"Configurer"* dans le bloc **Integromat**. Vous obtiendrez alors un token utilisable sur Integromat pour le connecter avec Citipo. Gardez cette page ouverte.
## Utiliser l'application Citipo pour Integromat
Au sein d'Integromat, lorsque vous être en train de réaliser un scénario, vous pouvez choisir l'**application Citipo** :
Lorsque vous cliquez sur cette application, vous pourrez alors choisir un trigger. Pour le moment, nous supportons uniquement un seul trigger :
Une fois le trigger choisi, il vous sera demandé de choisir ou créer un Webhook :
Si c'est la première fois que vous utilisez l'application Citipo, cliquez sur *"Add"* pour créer un nouveau Webhook (sinon, vous pouvez choisir un webhook créé précédement).
Vous pourrez alors indiquer un nom pour le webhook (vous pouvez indiquer le nom de votre organisation) et choisir ou créer une connexion :
De la même manière, si c'est la première fois que vous utilisez l'application Citipo, cliquez sur *"Add"* pour créer une nouvelle connexion :
Vous pourrez indiquer un nom pour la connexion (nous vous recommandons d'indiquer le nom de votre organisation). Indiquez aussi le token API obtenu dans la première étape.
Sauvegardez la connexion, puis sauvegardez le webhook : **ca y est, vous avez configuré Citipo pour fonctionner avec Integromat !**
Désormais, à chaque fois qu'un contact rejoindra votre communauté, votre scénario sera lancé par Citipo. Libre à vous de réaliser le scénario que vous souhaitez ensuite.
# Créer des bots Telegram basés sur Citipo
# À destination de votre communauté ou du grand public
Créez des bots Telegram pour votre communauté pour augmenter votre engagement et simplifier l'intégration des nouveaux venus.
Les bots Telegram sont un moyen efficace de simplifier l'usage de votre infrastructure numérique en permettant à votre communauté d'utiliser les outils qu'elle connait déjà.
## 1. Créer un bot Telegram
De manière très schématique, un bot Telegram est une application Web réagissant aux appels des serveurs de Telegram avec votre propre logique et vos propres processus.
Pour créer un bot Telegram, vous pouvez suivre la [documentation officielle](https://core.telegram.org/bots).
## 2. Utiliser les API publiques de Citipo
Une fois créé, vous pouvez utiliser les API publiques de Citipo depuis votre bot Telegram :
1. [L'API Site internet](https://docs.citipo.com/developpeurs/api/api-site-internet) vous permettra d'afficher le contenu du site internet sous forme de messages Telegram, ou de répondre à des questionnaires directement depuis Telegram ;
2. [L'API Communauté](https://docs.citipo.com/developpeurs/api/api-communaute) vous permettra de manipuler vos contacts depuis votre bot, par exemple pour permettre à vos utilisateurs de s'inscrire à la newsletter ou devenir membre depuis le bot ;
3. [L'API Espace membre](https://docs.citipo.com/developpeurs/api/api-membres) vous permettra d'authentifier vos utilisateurs avec leur espace membre Citipo, afin par exemple de limiter leurs accès à certaines fonctionnalités de votre bot.
# À destination de vos collaborateurs
Créez des bots Telegram pour vos collaborateurs et simplifez leur usage de la plateforme.
En complément de l'engagement de votre communauté, les bots Telegram peuvent jouer un rôle important dans la simplification de l'usage de Citipo auprès de vos collaborateurs.
Ils vous permettront de développer des outils plus simples d'utilisation au sein d'une plateforme que vos collaborateurs utilisent déjà.
## 1. Créer un bot Telegram
De manière très schématique, un bot Telegram est une application Web réagissant aux appels des serveurs de Telegram avec votre propre logique et vos propres processus.
Développer un bot Telegram à destination de vos collaborateurs revient à créer une application Web qui agira à leur place sur la console Citipo.
{% hint style="info" %}
Étant donné les forts enjeux de sécurité associés à un tel usage, **il est essentiel que vous soyez très vigilants à la sécurité de votre bot**.
{% endhint %}
Pour créer un bot Telegram, vous pouvez suivre la [documentation officielle](https://core.telegram.org/bots).
## 2. Enregistrer le bot sur Citipo
Au sein de votre organisation, dans la section **Intégrations** en haut de page, vous retrouverez l'intégration Telegram :
Cliquez sur **Configurer** pour obtenir la liste des bots Telegram actuellement configurés sur votre Organisation :
Enregistrez votre bot en cliquant sur le bouton "**Enregistrer un bot**". Vous obtiendrez alors une URL de partage :
Cette URL de partage est une URL que vous pouvez transmettre à vos collaborateurs.
## 3. Partager l'intégration avec vos collaborateurs
Lorsque vos collaborateurs ouvriront l'URL de partage, Citipo leur demandera si ils sont d'accord pour partager leur accès à la console avec votre bot :
Si ils cliquent sur "Oui, autoriser", vos collaborateurs seront redirigés vers votre bot dans Telegram.
Un premier message sera alors envoyé à votre bot, contenant le token de consentement :
```
/start telegram_6cbecdad1a33ea8afa60def486578b9e99b238ec0c330d9c521e86308e092f57
```
Vous pouvez ainsi récupérer ce token depuis votre bot et le stocker dans une base de donnée, associée à l'utilisateur Telegram actuel.
## 4. Utiliser l'API Intégrations
Une fois que vous avez obtenu ce token de consentement, vous pouvez l'utiliser pour effectuer des requêtes sur l'API Intégrations :
{% content-ref url="/pages/-MiqUl1mjSGY0wbJi7VR" %}
[API Intégrations](/developpeurs/api/api-integrations)
{% endcontent-ref %}
# Vue d'ensemble
# Créer des redirections
# Personnaliser le thème
# Utiliser les API Citipo
Citipo dispose de plusieurs API permettant d'accéder et de modifier les différentes sections de votre organisation de manière programmatique.
{% hint style="info" %}
Vous pouvez retrouver la totalité de la référence des requêtes API sur la [documentation OpenAPI de Citipo](https://console.citipo.com/openapi). Cette référence est moins explicative que la présente documentation mais elle présente l'intérêt d'être toujours à jour car elle est synchronisée avec le code de Citipo.
{% endhint %}
Il existe 4 API Citipo différentes, permettant de travailler sur différentes sections de la plateforme.
## 1. API Site internet
L'API Site internet permet de récupérer le contenu affiché sur le site internet Citpo d'un projet.
Chaque projet dispose d'un accès dédié à cette API et seuls les contenus de ce projet sont accessibles via celle-ci.
{% content-ref url="/pages/-MiqUVnhSCjYwh1QIqh4" %}
[API Site internet](/developpeurs/api/api-site-internet)
{% endcontent-ref %}
## 2. API Communauté
L'API Communauté permet de manipuler les contacts d'une organisation Citipo.
Chaque projet dispose d'un accès à cette API : le projet utilisé pour effectuer les manipulations est alors considéré comme la source des modifications.
{% content-ref url="/pages/-MiqUimW61hae8aWu7mv" %}
[API Communauté](/developpeurs/api/api-communaute)
{% endcontent-ref %}
## 3. API Espace membre
L'API Espace membre permet de travailler sur les membres de votre communauté : elle permet de créer des comptes membres, de demander des réinitialisations de mot de passe, de connecter et authentifier des membres et d'accéder aux contenus restreints aux membres.
Chaque projet ayant un espace membre actif dispose d'un accès dédié à cette API et seuls les contenus de ce projet et restreints aux membres sont accessibles via celle-ci.
{% content-ref url="/pages/-MiqUow2rHzLU\_5h-ce6" %}
[API Espace membre](/developpeurs/api/api-membres)
{% endcontent-ref %}
## 4. API Intégrations
L'API Intégrations permet de développer des outils pour vos collaborateurs ayant accès à Citipo.
{% content-ref url="/pages/-MiqUl1mjSGY0wbJi7VR" %}
[API Intégrations](/developpeurs/api/api-integrations)
{% endcontent-ref %}
# API Site internet
L'API Site internet permet de récupérer le contenu affiché sur le site internet Citpo d'un projet.
Chaque projet dispose d'un accès dédié à cette API et seuls les contenus de ce projet sont accessibles via celle-ci.
{% hint style="info" %}
[Lire la référence OpenAPI de l'API Site internet](https://console.citipo.com/openapi#operations-tag-Website)
{% endhint %}
## Authentification
L'authentification de l'API Site internet passe par l'utilisation du token API associé au projet.
Pour obtenir ce token, allez dans un projet Citipo puis dans la section **Développeurs > Accès API**. Une fois le token obtenu, utilisez-le en Bearer token HTTP :
```
curl --request GET \
--url 'https://console.citipo.com/api' \
--header 'Authorization: Bearer '
```
# API Communauté
L'API Communauté permet de manipuler les contacts d'une organisation Citipo.
Chaque projet dispose d'un accès à cette API : le projet utilisé pour effectuer les manipulations est alors considéré comme la source des modifications.
{% hint style="info" %}
[Lire la référence OpenAPI de l'API Communauté](https://console.citipo.com/openapi#operations-tag-Community)
{% endhint %}
## Authentification
L'authentification de l'API Communauté passe par l'utilisation du token API associé à un projet. Le projet choisi déterminera la source des contacts manipulés.
Pour obtenir ce token, allez dans un projet Citipo puis dans la section **Développeurs > Accès API.** Une fois le token obtenu, utilisez-le en Bearer token HTTP :
```
curl --request GET \
--url 'https://console.citipo.com/api' \
--header 'Authorization: Bearer '
```
# API Espace membre
L'API Espace membre permet de travailler sur les membres de votre communauté : elle permet de créer des comptes membres, de demander des réinitialisations de mot de passe, de connecter et authentifier des membres et d'accéder aux contenus restreints aux membres.
Chaque projet ayant un espace membre actif dispose d'un accès dédié à cette API et seuls les contenus de ce projet et restreints aux membres sont accessibles via celle-ci.
{% hint style="info" %}
[Lire la référence OpenAPI de l'API Espace membre](https://console.citipo.com/openapi#operations-tag-Membership)
{% endhint %}
## Authentification
L'authentification des espaces publics de l'API Espace membre passe par l'utilisation du token API associé à un projet. Une authentification par token membre (AuthorizationToken) est ensuite nécessaire pour accéder aux contenus restreints aux membres.
Pour obtenir le token de projet, allez dans un projet Citipo puis dans la section **Développeurs > Accès API.** Une fois le token obtenu, utilisez-le en Bearer token HTTP :
```
curl --request GET \
--url 'https://console.citipo.com/api' \
--header 'Authorization: Bearer '
```
Avec le token de projet, vous pouvez authentifier un utilisateur grâce à une requête de Login.
Vous obtiendrez ainsi un AuthorizationToken, que vous pourrez fournir dans le corps les requêtes d'accès au contenu restreint du projet, en complément du Bearer token:
```
curl --request POST \
--url https://console.citipo.com/api/community/members/authorize \
--header 'authorization: Bearer ' \
--header 'content-type: application/json' \
--data '{
"_resource": "AuthorizationToken",
"firstName": "Titouan",
"lastName": "Galopin",
"nonce": "xxx",
"encrypted": "xxx"
}'
```
# API Intégrations
L'API Intégrations permet de développer des outils pour vos collaborateurs ayant accès à Citipo.
{% hint style="info" %}
[Lire la référence OpenAPI de l'API Intégrations](https://console.citipo.com/openapi#operations-tag-Integrations)
{% endhint %}
## Authentification
L'authentification sur l'API Intégrations implique de récupérer le consentement d'un collaborateur à accéder à son compte Citipo. Pour cela, vous pouvez passer par les Intégrations Citipo comme par exemple [un bot Telegram](https://docs.citipo.com/integrations/creer-des-bots-telegram-bases-sur-citipo).
Une fois que vous avez récupéré le token de consentement du collaborateur, vous pouvez l'utiliser en Bearer token HTTP :
```
curl --request GET \
--url 'https://console.citipo.com/api/integrations/projects' \
--header 'Authorization: Bearer telegram_6cbecdad1a33ea8afa60def486578b9e99b238ec0c330d9c521e86308e092f57'
```
