API et webhooks

Pro ajoute deux façons de connecter PrimoCRM au reste de votre écosystème : les clés API pour un accès programmatique, et les webhooks sortants pour pousser des événements vers d’autres systèmes.

Clés API

Les clés API permettent à des applications et scripts externes de lire et d’écrire des données PrimoCRM par programmation.

Allez dans Réglages puis API et créez une clé.
Conservez la clé en lieu sûr. Traitez-la comme un mot de passe.
Utilisez-la pour authentifier les requêtes provenant de votre application.

Cas d’usage typiques :

Synchroniser des contacts depuis un système qui ne dispose pas d’intégration directe.
Ajouter ou mettre à jour des contacts depuis un tunnel d’inscription personnalisé.
Remonter des données dans un tableau de bord interne.

Webhooks sortants

L’action d’automatisation Webhook sortant envoie une requête HTTP POST vers l’URL de votre choix lorsque le flux atteint cette étape. Utilisez-la pour notifier d’autres services en temps réel.

Ajoutez une étape Webhook sortant à une automatisation.
Définissez l’URL cible.
Configurez la charge utile (payload). Vous pouvez inclure des données de contact via les codes intelligents.

Un exemple concret

Déclencheur : Commande WooCommerce créée.
Webhook sortant : POST vers votre service de traitement des commandes avec l’e-mail du contact et les détails de la commande.
Ajouter un tag : customer.

Dès qu’une commande est passée, votre système externe est notifié et le tag est appliqué au contact, sans aucune intervention manuelle.

Notes de sécurité

Ne pointez les webhooks que vers des points de terminaison que vous contrôlez ou en lesquels vous avez confiance. Un webhook peut acheminer des données de contact vers l’URL de destination.
Préférez des destinations HTTPS afin que la charge utile soit chiffrée en transit.
Validez les requêtes webhook entrantes du côté du récepteur.

L’emplacement de ces éléments dans le catalogue est répertorié sous Déclencheur et actions.