← Documentazione ConnectMachine

Integrazione nativa Zapier

Integrazione nativa ConnectMachine per Zapier

Crea flussi istantanei e bidirezionali senza copiare URL webhook. Collega l’account, scegli un trigger o un’azione e pubblica lo Zap.

Disponibile per abbonati paganti, membri con licenza organizzativa e prove Premium attive.

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.
Importante

Contatto 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.

Importante

Aggiungi 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.