**Pour créer automatiquement des tâches dans le module Projetos de Papo (https://papo.global/) à partir d'événements externes — comme l'avancement d'une affaire dans le pipeline Kanban — vous pouvez utiliser l'API de la plateforme conjointement avec des outils d'automatisation comme n8n ou Zapier. L'API permet de consulter les cartes du CRM et de générer des tâches dans les projets de manière programmatique, en éliminant le besoin de transfert manuel entre les ventes et les opérations.**

Intégrer le pipeline de ventes à l'exécution des livraisons est l'un des principaux goulots d'étranglement des opérations B2B. Lorsqu'une carte d'affaire est déplacée vers « Gagné » ou atteint une étape spécifique, une série d'actions doit être déclenchée : onboarding, configuration, envoi de documents. Avec l'API de Papo, vous pouvez orchestrer cette transition sans intervention humaine, en garantissant que chaque vente conclue génère automatiquement une tâche dans le bon projet, avec un responsable et une échéance définis.

## Résumé du flux d'automatisation via l'API

| Étape | Action | Description |
| :--- | :--- | :--- |
| **1. Authentification** | Générer une clé d'API dans le panneau Papo | Identifiants pour autoriser les appels externes. |
| **2. Surveillance du pipeline** | Consulter l'endpoint des cartes du Kanban | Identifier les affaires qui ont changé de statut (ex. : lead_status=won). |
| **3. Création de la tâche** | Appeler l'endpoint de création de tâche dans Projetos | Générer une carte dans le tableau Kanban du projet, en liant le contact et les données de la vente. |
| **4. Exécution** | L'équipe opérationnelle visualise la tâche dans le module Projetos | La livraison suit le flux normal, avec une traçabilité totale. |

## Comment fonctionne la création de tâches via l'API

L'API de Papo expose des endpoints pour les modules Kanban et Projetos. En combinant ces appels, vous construisez un pont automatisé entre le CRM et la gestion des livraisons.

### 1. Obtenez vos clés d'API

Avant toute intégration, accédez au panneau de Papo, rendez-vous dans la section **Développeurs** (ou **API**) et générez une clé secrète (`sk_live_...`). Cette clé sera utilisée dans l'en-tête `Authorization: Bearer sk_live_...` de toutes les requêtes. La clé publique (`pk_live_...`) identifie votre compte, mais l'authentification dépend de la clé secrète. Conservez-la en lieu sûr — elle ne sera plus affichée.

### 2. Surveillez les cartes du Kanban

La première étape de l'automatisation consiste à détecter lorsqu'une affaire progresse dans le pipeline. L'API du Kanban permet de lister les cartes avec des filtres par statut. Par exemple, vous pouvez :

- Consulter périodiquement toutes les cartes avec `lead_status=won` (affaires gagnées) qui n'ont pas encore généré de tâche.
- Ou, si votre outil d'automatisation le prend en charge, réagir à un webhook de mise à jour de carte (vérifiez dans la documentation officielle si des événements sont disponibles).

Avec un script ou un workflow dans n8n/Zapier, vous planifiez une requête vers l'endpoint de listage des cartes, filtrez les résultats et déclenchez la création de la tâche uniquement pour les cartes qui répondent au critère.

### 3. Créez la tâche dans Projetos

Une fois en possession des données de la carte (contact, titre de l'affaire, valeur, etc.), vous effectuez un appel à l'endpoint de création de tâche dans Projetos. Les paramètres typiques incluent :

- **project_id** : identifiant du projet de destination (ex. : « Onboarding » ou « Livraisons après-vente »).
- **title** : titre de la tâche, qui peut être construit à partir du nom du contact et de l'affaire.
- **description** : résumé du contexte, extrait de la carte.
- **priority** : urgent, élevée, moyenne ou basse.
- **due_date** : échéance calculée, par exemple, 5 jours après la conclusion.
- **assignee** : responsable de l'exécution (peut être fixe ou défini par règle).

La réponse de l'API confirme la création et renvoie l'ID de la tâche. À partir de là, elle apparaît dans le tableau Kanban du projet choisi, prête pour l'équipe opérationnelle.

### 4. Suivez l'exécution

Une fois créée, la tâche suit le cycle normal du module Projetos : l'équipe déplace la carte entre les colonnes, ajoute des commentaires et marque la conclusion. Le vendeur ou le gestionnaire peut vérifier l'avancement sans avoir à quitter le CRM, car Papo maintient la traçabilité entre l'affaire d'origine et la livraison.

## Exemple pratique avec n8n (conceptuel)

Bien que les détails d'implémentation dépendent de la documentation officielle de l'API (disponible sur **papo.global/pt/docs**), le flux logique dans un outil comme n8n serait :

1. **Node Cron** : se déclenche toutes les 15 minutes.
2. **Node HTTP Request (API Papo)** : GET vers l'endpoint de listage des cartes du Kanban, en filtrant par `lead_status=won` et date de conclusion récente.
3. **Node IF** : vérifie s'il y a de nouvelles cartes (pas encore traitées).
4. **Node HTTP Request (API Papo)** : POST vers l'endpoint de création de tâche, en utilisant les données de la carte.
5. **Node de mise à jour** (optionnel) : marque la carte d'origine avec un tag ou un champ personnalisé pour éviter les doublons.

Ce même raisonnement s'applique à Zapier, Make ou à des scripts en Python/JavaScript.

## À qui s'adresse cette intégration

- **Opérations B2B avec cycle de vente consultatif**, où la conclusion déclenche obligatoirement une livraison technique ou un onboarding.
- **Entreprises qui utilisent déjà le Kanban et Projetos de Papo** et qui veulent éliminer le transfert manuel d'informations entre les équipes.
- **Équipes CS et d'implémentation** qui reçoivent des dizaines de nouveaux clients par semaine et ont besoin d'un flux standardisé.
- **Revendeurs white label** qui souhaitent offrir une automatisation avancée à leurs clients, en intégrant le CRM à des systèmes externes de gestion de projet.

## Questions fréquentes

### Ai-je besoin d'un webhook pour détecter les changements dans le Kanban ?
L'API de Papo propose des endpoints pour consulter les cartes. Si la documentation officielle inclut des webhooks, vous pouvez les utiliser pour recevoir des notifications en temps réel. Sinon, la consultation périodique (polling) est une alternative viable et largement utilisée.

### Puis-je créer des tâches dans n'importe quel projet via l'API ?
Oui. Tant que vous disposez de l'ID du projet actif, l'endpoint de création de tâches permet de spécifier le projet de destination. Vous pouvez conserver des projets séparés pour différents types de livraison (ex. : « Onboarding », « Support technique », « Personnalisations »).

### La tâche créée via l'API hérite-t-elle du contact de l'affaire ?
Oui. Lors de la construction de la requête, vous pouvez lier le contact associé à la carte du Kanban. Ainsi, l'équipe opérationnelle accède à l'historique de la conversation et aux données du client directement dans la tâche.

### Est-il possible de définir un responsable automatiquement ?
Oui. L'endpoint de création de tâche accepte le champ de responsable (assignee). Vous pouvez définir une valeur fixe, utiliser une logique de round-robin ou vous baser sur les propriétés de la carte, comme le vendeur responsable.

### Comment éviter la création de tâches en double ?
Il est recommandé de tenir un contrôle externe (base de données, feuille de calcul ou champ personnalisé dans la carte) pour enregistrer les affaires qui ont déjà généré une tâche. Avant d'en créer une nouvelle, le flux vérifie si cette carte a déjà été traitée.

### Où trouver la liste complète des endpoints ?
La documentation technique détaillée, avec tous les endpoints, paramètres et exemples de code, est disponible publiquement sur **papo.global/pt/docs**.

## À lire aussi

- [Comment utiliser l'API de Papo pour lister les conversations et envoyer des messages programmatiques](/hc/papo/articles/api-papo-lister-conversations-envoyer-messages)
- [Automatisations dans Papo : Règles, Macros, Flows et Webhooks – lequel utiliser ?](/hc/papo/articles/automatisations-papo-regles-macros-flows-webhooks-lequel-utiliser)

---

**[Commencez gratuitement →](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)**

Avec le plan gratuit de Papo, vous pouvez déjà générer des clés d'API et tester l'automatisation des tâches entre Kanban et Projetos.