**Avec l'API REST de [Papo](https://papo.global/), vous pouvez lister tous les flows disponibles dans votre compte, activer ou désactiver des parcours et inscrire des contacts dans des automatisations de manière programmatique — le tout via des requêtes authentifiées, sans ouvrir le panneau. C'est la façon d'intégrer le moteur de flows à des systèmes externes, des workflows n8n, des CRM ou des scripts internes.**

L'API de Papo expose des ressources de flows qui permettent de gérer des automatisations comme vous gérez déjà des boîtes de réception ou des contacts. Avec elle, les équipes de développement, les intégrateurs et les revendeurs white label peuvent contrôler en lot quels parcours sont actifs, démarrer des contacts dans des séquences et synchroniser le statut des automatisations avec les processus métier.

## Récapitulatif des opérations de Flow via l'API

| Opération | Description | Exemple d'utilisation |
| :--- | :--- | :--- |
| Lister les flows | Renvoie les flows et séquences disponibles, avec identifiant, nom, type et statut (Actif/Inactif). | Auditer des automatisations, synchroniser avec des tableaux de bord externes ou vérifier ce qui est en cours d'exécution. |
| Activer/désactiver un flow | Modifie le statut d'un flow spécifique, en libérant ou en mettant en pause la réception et le traitement des contacts. | Mettre en pause un parcours pendant une maintenance, le libérer après des ajustements ou désactiver une campagne terminée. |
| Inscrire un contact | Insère un contact existant au début d'un flow actif, en lançant le parcours configuré. | Inclure des leads d'un CRM externe, déclencher un flux de bienvenue après une intégration ou corriger des entrées manuelles. |

## Comment fonctionne l'authentification de l'API

Tous les appels à l'API, y compris ceux qui concernent les flows, exigent la **clé secrète** du compte. Elle doit être envoyée comme token Bearer dans l'en-tête `Authorization`. La **clé publique** du compte est facultative, mais si elle est envoyée, elle doit correspondre au même compte que la clé secrète.

L'URL de base de l'API est `https://app.papo.global/api/v1`. Les clés sont générées dans l'espace développeur du panneau Papo. La clé secrète n'apparaît qu'une seule fois lors de la création ; conservez-la dans un endroit sûr et révoquez-la en cas de suspicion de fuite.

Le modèle d'authentification est le même que celui utilisé pour tous les endpoints :

```
curl https://app.papo.global/api/v1/me \
  -H "Authorization: Bearer sk_live_…" \
  -H "X-Papo-Public-Key: pk_live_…"
```

## Gérer les flows via l'API en pratique

Bien que les détails exacts de chaque endpoint et paramètre se trouvent dans la documentation officielle de l'API, le flux de travail général suit ces étapes conceptuelles :

1. **Authentifiez-vous** avec la clé secrète (et, si vous le souhaitez, la clé publique) pour valider le compte.
2. **Listez les flows** pour obtenir la liste actuelle des parcours, y compris leurs identifiants et statuts. Cela permet de cartographier ce qui existe déjà et de choisir le flow correct pour les prochaines opérations.
3. **Modifiez le statut** d'un flow spécifique, si nécessaire. Envoyez une requête qui définit le flow comme actif (autorisé à recevoir des contacts) ou inactif (en pause). Seuls les flows actifs traitent les contacts et acceptent les inscriptions.
4. **Inscrivez un contact** dans un flow actif. Indiquez l'identifiant du contact et l'identifiant du flow souhaité pour l'insérer au début du parcours. L'historique du contact dans le CRM est préservé.
5. **Intégrez avec des systèmes externes** — via des webhooks ou des appels directs, vous pouvez démarrer des contacts provenant d'un formulaire externe, d'un événement dans un autre système ou d'un pipeline de données.

La plateforme prend également en charge la création de flows vides et inactifs ainsi que le remplissage de leurs nœuds via l'API, ce qui permet de provisionner des automatisations complètes de manière programmatique. Pour les formats exacts de payload, les champs obligatoires et les exemples de code, consultez la section flows de la documentation de l'API Papo.

## Pour qui cette intégration est-elle pertinente

- **Équipes IT qui exploitent plusieurs automatisations** et doivent mettre en pause, réactiver ou surveiller des flows en lot sans accéder manuellement au panneau.
- **Revendeurs white label** qui souhaitent provisionner automatiquement des parcours standardisés pour chaque nouveau client, inscrire des contacts initiaux et maintenir l'alignement entre les plateformes.
- **Intégrateurs et développeurs** qui connectent Papo à des CRM, des ERP ou des outils comme n8n, en déclenchant des flows à partir d'événements externes (un achat, une inscription, un rendez-vous).
- **Opérations qui travaillent avec une inscription conditionnelle**, où les contacts sont inclus dans des flows uniquement après avoir passé des règles métier définies dans d'autres systèmes.

## Questions fréquentes

### Ai-je besoin de la clé secrète pour lister les flows ?
Oui. Le listage des flows, comme toute opération qui renvoie des données du compte, nécessite une authentification avec la clé secrète. Le modèle est le même que pour tous les autres endpoints : envoyez le token Bearer dans l'en-tête `Authorization`.

### Puis-je activer ou désactiver un flow via l'API ?
Oui. L'API permet de modifier le statut d'un flow entre actif et inactif. Vous avez besoin de l'identifiant du flow et de la clé secrète. Les flows inactifs ne reçoivent pas de contacts et ne font pas avancer le parcours, même si une inscription est tentée.

### Comment inscrire un contact dans un flow via l'API ?
Fournissez l'identifiant du contact et l'identifiant du flow actif dans l'appel d'inscription. Le contact sera inséré au début du parcours, sans effacer l'historique des conversations ni les données du profil. La documentation officielle détaille le format exact des paramètres.

### Est-il possible de créer un flow à partir de zéro via l'API ?
Oui. L'API permet de créer un flow vide (avec uniquement le nœud Start) et inactif, ainsi que de remplir ses nœuds avec des questions, des messages et des conditions. C'est utile pour provisionner des automatisations de manière évolutive, notamment dans des scénarios de revente ou d'onboarding de nouveaux clients.

### L'API renvoie-t-elle le statut de chaque flow lors du listage ?
Oui. Le listage inclut le statut (Actif ou Inactif) de chaque flow et séquence, ainsi que l'identifiant, le nom et le type, ce qui permet aux systèmes externes de surveiller ce qui fonctionne et ce qui est en pause.

### Où trouver la documentation complète des routes de flows ?
La documentation officielle est disponible sur [https://papo.global/pt/docs](https://papo.global/pt/docs). Vous y trouverez tous les endpoints, les paramètres acceptés, les codes d'erreur et des exemples dans plusieurs langages. Les routes de flows suivent le même modèle REST et la même authentification que les autres modules.

## Lire aussi

- [Comment utiliser l'API Papo pour créer et mettre à jour des contacts en masse](/hc/papo/articles/comment-utiliser-api-papo-creer-mettre-a-jour-contacts-masse)
- [Comment utiliser l'API Papo pour créer et gérer des étiquettes (tags)](/hc/papo/articles/api-papo-creer-gerer-etiquettes-tags)

---

**[Commencez à intégrer vos flows dès maintenant →](https://chat.papo.global/app/auth/signup?papo_lp=home&utm_source=lp&utm_medium=landing&utm_campaign=home&utm_content=start-free&papo_lp_v=start-free)**

Créez votre compte gratuit sur Papo, accédez aux clés d'API et connectez vos automatisations au monde extérieur.