01 Trigger e azioni
L’integrazione offre cinque operazioni.
- Nuovo contatto — contacts.created.
- Contatto aggiornato — contacts.updated.
- Contatto eliminato — contacts.deleted con snapshot precedente.
- Crea contatto — persona o azienda.
- Aggiorna contatto — menu o ID personalizzato.
ImportanteContatto eliminato è solo un trigger. Non esiste un’azione Elimina contatto.
02 Collega l’account
Scegli ConnectMachine in Zapier, accedi con Google o codice email e approva. Serve un account esistente con onboarding completato. Se l’autorizzazione viene revocata, riconnetti Zapier.
03 Campi di creazione
Mappa tipo, nome, cognome, azienda, ruolo, note, rete opzionale, email, telefono e sito.
- Una persona richiede il nome.
- Un’azienda richiede l’azienda.
- Email e URL vengono convalidati.
- Senza Rete viene usata quella predefinita.
04 Campi di aggiornamento
L’ID è obbligatorio. Seleziona un contatto recente o usa un valore personalizzato da un passaggio precedente.
- I valori vuoti non cancellano dati in v1.
- Email, telefono e sito aggiornano o creano il valore principale.
- Contatto e rete devono appartenere all’account.
05 Evita cicli
Le azioni generano i normali trigger con source=zapier e source_id.
ImportanteAggiungi un filtro “source non corrisponde esattamente a zapier” quando lo Zap riscrive su ConnectMachine.
06 Contatti eliminati
Eliminazioni singole, massive, totali e fusioni possono avviare il trigger. Zapier riceve un elemento per contatto con deleted_at e snapshot. I webhook manuali restano solo ID.
07 Privacy e permessi
Zapier conserva le credenziali OAuth. ConnectMachine conserva JTI e hash dei refresh token; il browser non conserva token.
- user:read identifica la connessione.
- contacts:read abilita trigger e menu.
- contacts:write consente crea e aggiorna.
- webhooks:write gestisce solo le sottoscrizioni Zapier.
08 Riferimento sviluppatori
OAuth usa authorization code e PKCE S256. Sottoscrizioni: /api/v1/zapier/subscriptions; esempi: /trigger-samples; azioni: POST e PATCH /api/v1/zapier/contacts.
09 Risoluzione problemi
Un errore Premium indica un piano non idoneo. Un errore permessi richiede la riconnessione. Dopo un 410, riattiva lo Zap per creare una nuova sottoscrizione.