Avec l’API REST de Papo, vous pouvez construire un endpoint sur votre site qui reçoit les données du formulaire d’inscription et appelle l’API de contacts pour créer automatiquement des enregistrements dans le CRM, y compris des attributs personnalisés — ce qui élimine la saisie manuelle et accélère l’intégration des leads.
Au lieu d’exporter des feuilles de calcul ou de copier des données entre systèmes, cette intégration fait que chaque nouvel inscrit sur votre site devient un contact dans le CRM de Papo en temps réel. Le flux est simple : le formulaire envoie les données à un backend que vous contrôlez, ce backend s’authentifie auprès de l’API de Papo et crée le contact avec le nom, l’e-mail, le téléphone et tous les champs personnalisés dont votre activité a besoin.
Résumé de l’intégration
| Composant | Ce qu’il fait | Exemple |
|---|---|---|
| Formulaire sur le site | Collecte le nom, l’e-mail, le téléphone et des champs supplémentaires du lead. | Page de capture, landing page, checkout. |
| Endpoint intermédiaire | Reçoit les données du formulaire et appelle l’API de Papo. | Script en Node.js, Python ou automatisation dans n8n/Zapier. |
| API de contacts de Papo | Crée le contact dans le CRM avec les données envoyées. | Requête POST authentifiée avec une clé secrète. |
| Attributs personnalisés | Ajoute des champs comme origine, intérêt ou score au contact. | custom_attributes avec "origem": "site", "plano_interesse": "gold". |
Comment ça marche : étape par étape
-
Générez les clés API dans le panneau Papo
Accédez à l’espace développeur de votre compte Papo et créez une clé secrète. La clé publique du compte est également visible sur cet écran. La clé secrète n’apparaît qu’une seule fois ; conservez-la dans un endroit sûr et ne l’exposez jamais dans le frontend. -
Créez le formulaire sur votre site
Composez le formulaire avec les champs que vous souhaitez envoyer au CRM : nom, e-mail, téléphone et toutes données supplémentaires (intérêt, origine, ville, etc.). Le formulaire doit effectuer une requête HTTP (POST) vers l’endpoint que vous construirez à l’étape suivante. -
Construisez l’endpoint intermédiaire
Sur votre serveur ou dans une fonction serverless (Node.js, Python, PHP, etc.), créez une route qui reçoit les données du formulaire. Ce code sera chargé de :- Valider les champs reçus.
- Construire le payload JSON pour l’API de Papo.
- S’authentifier avec la clé secrète (Bearer token) et, éventuellement, envoyer la clé publique dans l’en-tête
X-Papo-Public-Key. - Appeler l’endpoint de création de contacts de Papo.
-
Appelez l’API de contacts de Papo
Utilisez l’endpoint de création de contacts (consultez la documentation officielle surhttps://papo.global/pt/docspour le chemin exact et le format du payload). Envoyez, au minimum, le nom et l’e-mail ou le téléphone. La réponse de l’API confirmera la création avec les données du nouveau contact. -
Ajoutez des attributs personnalisés
Si votre compte dispose de définitions d’attributs personnalisés (comme « origine », « utm_source », « score »), vous pouvez les envoyer dans le même payload ou dans un appel complémentaire. L’API permet de définir/fusionnercustom_attributesdans le contact, ce qui élimine la nécessité de remplir ces champs manuellement par la suite. -
Traitez la réponse et renvoyez-la à l’utilisateur
Après la création réussie, votre endpoint peut rediriger le lead vers une page de remerciement ou afficher un message de succès. En cas d’erreur (clé invalide, données manquantes), enregistrez le log et renvoyez un message convivial.
Comme l’API de Papo est REST et utilise JSON, toute langue avec prise en charge de HTTP peut être utilisée. La documentation officielle fournit des exemples en JavaScript, Python et curl, ainsi que les détails d’authentification et les codes d’erreur.
À qui cette intégration s’adresse
- Sites et landing pages qui captent des leads et veulent éliminer le transfert manuel de données vers le CRM.
- E-commerces et SaaS qui souhaitent créer automatiquement un contact au moment de l’inscription ou de l’achat.
- Agences et cabinets de conseil qui mènent des campagnes de captation et ont besoin que les leads entrent dans le CRM en temps réel pour un suivi immédiat.
- Revendeurs white label et intégrateurs qui construisent des flux personnalisés pour leurs clients, en connectant les formulaires de sites à Papo sans intervention manuelle.
- Équipes marketing et ventes qui utilisent des attributs personnalisés pour la segmentation et souhaitent que ces champs soient remplis automatiquement à la source.
Questions fréquentes
Faut-il des connaissances avancées en programmation pour mettre en œuvre cette intégration ?
Oui. Il est nécessaire de développer un endpoint sur votre serveur ou d’utiliser des outils d’automatisation (n8n, Zapier) qui font le lien entre le formulaire et l’API de Papo. Le code en lui-même est simple, mais il exige des notions de base en HTTP et en manipulation de JSON.
Puis-je utiliser n’importe quel langage de programmation ?
Oui. L’API de Papo est REST et répond en JSON. Tout langage avec prise en charge des requêtes HTTP (Python, Node.js, PHP, Ruby, etc.) peut être utilisé. La documentation officielle fournit des exemples en JavaScript et Python.
Est-il possible de créer des attributs personnalisés directement lors de la création du contact ?
Oui. L’API de Papo permet de définir les custom_attributes du contact au moment de la création ou de les mettre à jour ultérieurement. Consultez la documentation pour le format exact du payload et pour vérifier si les définitions des attributs existent déjà dans le compte.
Comment garantir la sécurité de la clé secrète ?
La clé secrète ne doit jamais être exposée dans le frontend (HTML/JavaScript public). Elle doit rester uniquement sur le serveur, dans des variables d’environnement. Utilisez HTTPS pour toutes les communications et révoquez immédiatement la clé en cas de suspicion de fuite.
Que faire si l’API renvoie une erreur ?
L’API de Papo renvoie des réponses standardisées avec success: false et un objet error contenant le code et le message. Traitez ces erreurs dans votre code : validez que les champs obligatoires ont été envoyés, vérifiez que la clé est active et que le format du payload est correct. La documentation liste les principaux codes d’erreur.
Puis-je utiliser cette intégration avec des formulaires de plateformes comme WordPress, Typeform ou RD Station ?
Oui. Vous pouvez configurer des webhooks dans ces plateformes pour envoyer les données du formulaire vers votre endpoint intermédiaire, qui appellera ensuite l’API de Papo. Une autre alternative consiste à utiliser des intégrations prêtes via Zapier ou n8n, en créant un flux qui reçoit l’événement du formulaire et déclenche la création du contact dans Papo.
Lisez aussi
- Comment utiliser l’API de Papo pour gérer les Entreprises dans le CRM
- Comment intégrer Papo à Zapier avec l’API et les webhooks
Créez votre compte Papo gratuit et commencez à intégrer des formulaires d’inscription avec le CRM en quelques minutes, sans saisie manuelle.