01 Déclencheurs et actions
L’intégration propose cinq opérations.
- Nouveau contact — contacts.created.
- Contact mis à jour — contacts.updated.
- Contact supprimé — contacts.deleted avec instantané avant suppression.
- Créer un contact — personne ou entreprise.
- Mettre à jour un contact — liste ou ID personnalisé.
ImportantContact supprimé est uniquement un déclencheur. Il n’existe aucune action Supprimer un contact.
02 Connecter votre compte
Choisissez ConnectMachine dans Zapier, connectez-vous avec Google ou un code e-mail, puis approuvez. Un compte existant avec intégration terminée est requis. Reconnectez Zapier si l’autorisation est révoquée.
03 Champs de création
Mappez le type, prénom, nom, entreprise, poste, notes, réseau facultatif, e-mail, téléphone et site.
- Une personne exige un prénom.
- Une entreprise exige un nom d’entreprise.
- L’e-mail et l’URL sont validés.
- Sans Réseau, le réseau par défaut est utilisé.
04 Champs de mise à jour
L’ID est obligatoire. Choisissez un contact récent ou mappez un ID personnalisé d’une étape précédente.
- Les valeurs vides n’effacent rien dans v1.
- E-mail, téléphone et site mettent à jour ou créent la valeur principale.
- Le contact et le réseau doivent appartenir au compte.
05 Éviter les boucles
Les actions émettent les déclencheurs normaux avec source=zapier et source_id.
ImportantAjoutez un filtre « source ne correspond pas exactement à zapier » lorsque le Zap réécrit dans ConnectMachine.
06 Contacts supprimés
Suppression simple, groupée, totale et fusion peuvent lancer le déclencheur. Zapier reçoit un élément par contact avec deleted_at et l’instantané. Les webhooks manuels restent limités aux ID.
07 Confidentialité et autorisations
Zapier conserve les identifiants OAuth. ConnectMachine conserve les JTI et les hachages des refresh tokens ; le navigateur ne stocke aucun token.
- user:read nomme la connexion.
- contacts:read alimente déclencheurs et listes.
- contacts:write permet créer et mettre à jour.
- webhooks:write gère uniquement les abonnements Zapier.
08 Référence développeur
OAuth utilise authorization code et PKCE S256. Abonnements : /api/v1/zapier/subscriptions ; exemples : /trigger-samples ; actions : POST et PATCH /api/v1/zapier/contacts.
09 Dépannage
Une erreur Premium indique un forfait non admissible. Une erreur d’autorisation exige une reconnexion. Après un 410, réactivez le Zap pour créer un nouvel abonnement.