**Pour gérer les séquences de suivi via l'API de [Papo](https://papo.global/), vous pouvez lister les cadences disponibles, inscrire des contacts et mettre en pause la participation d'un lead grâce à la mise à jour d'attributs personnalisés — le tout par des requêtes authentifiées, sans ouvrir le tableau de bord. C'est la façon d'intégrer la nurturing des leads à des CRM, ERP et flux d'automatisation externes.**

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

| Opération | Description | Comment l'API la réalise |
| :--- | :--- | :--- |
| **Lister les séquences** | Obtenir toutes les cadences de suivi du compte, avec leur nom, leur identifiant et leur statut (actif/inactif). | Requête GET authentifiée sur l'endpoint des flows, filtrée par le type « sequence ». |
| **Inscrire un contact** | Insérer un contact existant dans une séquence active, en démarrant le parcours de messages. | POST avec l'ID du contact et l'ID de la séquence sur l'endpoint d'inscription. |
| **Mettre en pause la cadence pour un contact** | Interrompre temporairement les envois vers un lead sans le retirer de la séquence. | Mise à jour de l'attribut personnalisé du contact (ex. : `status_pausa`) via l'API de contacts, combinée à une condition dans le Flow. |

## Comment fonctionnent l'authentification et les endpoints

Toutes les opérations utilisent l'API REST de Papo, authentifiée avec la **clé secrète** du compte (token Bearer). L'URL de base est `https://app.papo.global/api/v1`. Les clés sont générées dans le tableau de bord, dans l'espace développeur.

Les ressources liées aux séquences sont regroupées dans les endpoints de **flows**. L'API permet de lister tous les flows, y compris ceux de type « sequence », et aussi d'activer/désactiver un flow entier. Pour inscrire un contact, il existe un endpoint spécifique qui reçoit l'identifiant du contact et celui du flow.

Les détails exacts de chaque endpoint (paramètres, payloads et exemples) sont disponibles dans la documentation officielle de l'API de Papo. Ici, nous nous concentrons sur le flux de travail permettant de gérer les séquences de suivi.

## Étape par étape : lister, inscrire et mettre en pause

### 1. Lister les séquences disponibles

Avant d'inscrire des leads, vous devez savoir quelles séquences existent et quels sont leurs identifiants. L'appel de listage renvoie une liste avec le nom, l'ID et le statut (actif/inactif). Seules les séquences actives acceptent de nouvelles inscriptions.

Avec la liste en main, votre système externe peut déterminer quelle séquence utiliser pour chaque lead.

### 2. Inscrire un contact dans une séquence

Avec l'ID du contact (obtenu via une recherche ou une création par l'API de contacts) et l'ID de la séquence active, vous envoyez une requête pour l'insérer au début du parcours. Le contact doit exister dans le CRM de Papo ; sinon, créez-le d'abord à l'aide de l'endpoint de contacts.

L'inscription démarre immédiatement l'envoi des messages programmés, dans le respect des intervalles configurés dans le Flow. L'historique du contact est préservé.

### 3. Mettre en pause la cadence pour un contact spécifique

L'API de Papo ne dispose pas d'une commande directe pour « mettre en pause » la participation d'un contact à une séquence. Vous pouvez toutefois obtenir le même effet en combinant l'API de contacts avec une condition dans le Flow.

**Prérequis :** la séquence doit avoir été construite avec un nœud de condition qui vérifie un attribut personnalisé (ex. : `status_pausa`). Si l'attribut est égal à « pausado », la condition bloque l'envoi des messages suivants ; sinon, elle le libère. (Voir l'article sur la pause temporaire pour les détails de construction du Flow.)

Avec cette structure dans le Flow, la mise en pause se fait en deux étapes via l'API :

1. **Identifiez le contact** par son ID ou recherchez-le par téléphone/e-mail à l'aide de l'endpoint de listage des contacts.
2. **Mettez à jour l'attribut personnalisé** du contact sur « pausado » (ou la valeur attendue par votre condition). Utilisez l'endpoint de mise à jour de contact, en envoyant le champ personnalisé.

À partir de ce moment, lorsque le flux atteindra la condition, il identifiera la valeur « pausado » et n'enverra pas le message. Pour reprendre, il suffit de mettre à jour l'attribut avec n'importe quelle autre valeur (ex. : « ativo ») ou de le vider, et le contact continuera là où il s'était arrêté.

Cette méthode maintient le contact inscrit et la progression dans la cadence, sans perdre l'historique.

## À qui cette intégration est utile

- **Les opérations SDR et ventes B2B** qui déclenchent des séquences à partir d'événements externes (ex. : un lead a téléchargé un contenu, une opportunité a été créée dans le CRM).
- **Les revendeurs white label** qui provisionnent automatiquement des parcours de suivi pour de nouveaux clients, en inscrivant les contacts initiaux sans action manuelle.
- **Les équipes marketing et automatisation** qui utilisent des outils comme n8n ou Zapier pour connecter Papo à des dizaines de systèmes et ont besoin d'un contrôle granulaire sur les cadences.
- **Les entreprises ayant des processus de pause conditionnelle**, où un lead demande un délai et le commercial souhaite interrompre la séquence sans perdre le point de la cadence — le tout déclenché par un bouton dans le CRM externe.

## Questions fréquentes

### Ai-je besoin de la clé secrète pour lister les séquences ?

Oui. Toute opération qui renvoie des données du compte nécessite une authentification avec la clé secrète, envoyée comme token Bearer dans l'en-tête `Authorization`.

### Puis-je inscrire un contact qui n'existe pas encore dans Papo ?

Non. Le contact doit exister dans le CRM de Papo. Vous pouvez d'abord le créer via l'API de contacts (avec son nom, son téléphone ou son e-mail), puis l'inscrire dans la séquence.

### L'API permet-elle de retirer un contact de la séquence ?

Le retrait (annulation de l'inscription) n'est pas disponible sous forme d'endpoint spécifique dans la version actuelle. L'alternative pour interrompre les envois consiste à mettre en pause via un attribut personnalisé, comme décrit, ou à désactiver le flow entier, ce qui affecte tous les contacts.

### Comment savoir si la mise en pause par attribut a fonctionné ?

Après la mise à jour de l'attribut, la séquence continue de traiter les nœuds d'attente. Lorsqu'elle atteindra la condition, elle vérifiera la valeur. Si elle est « pausado », le message ne sera pas envoyé. Vous pouvez confirmer dans le profil du contact, dans le module Contacts, qu'il reste inscrit, mais que les messages suivants ne sont pas déclenchés.

### Puis-je mettre en pause la séquence entière via l'API ?

Oui. L'API permet de changer le statut d'un flow en inactif, ce qui met la séquence en pause pour tous les contacts. Utilisez l'endpoint d'activation/désactivation de flow. Pour reprendre, il suffit de le réactiver.

### Où trouver les endpoints exacts et des exemples de code ?

La documentation complète de l'API est disponible sur [https://papo.global/pt/docs](https://papo.global/pt/docs). Vous y trouverez les endpoints de flows, de contacts et les formats de requête.

## À lire aussi

- [Comment utiliser l'API de Papo pour gérer les Flows d'automatisation](/hc/papo/articles/comment-utiliser-api-papo-gerer-flows-automatisation)
- [Comment utiliser l'API de Papo pour créer et mettre à jour des contacts en masse](/hc/papo/articles/comment-utiliser-api-papo-creer-mettre-a-jour-contacts-masse)

---

**[Commencez gratuitement et automatisez vos séquences →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=comment-utiliser-api-papo-gerer-sequences-suivi&utm_content=fr)**

Avec l'API de Papo, vous intégrez la nurturing des leads directement à votre stack, sans ouvrir le tableau de bord — le premier utilisateur est gratuit pour vous permettre de tester.