Collega ConnectMachine a Zapier

L’app ConnectMachine su Zapier ti dà tre trigger e due azioni per i tuoi contatti. I trigger sono istantanei: uno Zap parte pochi secondi dopo la modifica di un contatto, senza aspettare un intervallo di polling.

Ti serve

• Un account ConnectMachine con l’onboarding completato.
• L’accesso a Zapier sul tuo piano ConnectMachine: un abbonamento a pagamento, un posto su una licenza aziendale o una prova Premium attiva.
• Un account Zapier. Il piano gratuito di Zapier include 100 task al mese, abbastanza per la maggior parte degli Zap a uno step.

ConnectMachine si collega a Zapier una volta sola. Da lì in poi, ogni Zap che crei riusa la stessa connessione.

1. 1In Zapier, crea uno Zap e cerca ConnectMachine.
2. 2Scegli un trigger o un’azione ConnectMachine, poi clicca Sign in.
3. 3ConnectMachine apre una pagina di consenso. Accedi con Google o con un codice inviato via email. Non ti viene mai chiesta una password.
4. 4Controlla i permessi che stai concedendo, poi clicca Approve and continue.
5. 5Zapier torna all’editor dello Zap con il tuo account ConnectMachine collegato e pronto all’uso.

Che cosa stai approvando

I trigger avviano uno Zap quando succede qualcosa in ConnectMachine. Le azioni permettono a un’altra app di scrivere dentro ConnectMachine.

Trigger

Azioni

Questa procedura tiene allineati un Google Sheet e ConnectMachine. Lo stesso schema funziona con qualsiasi app collegata a Zapier.

Cerchi idee? La pagina ConnectMachine su Zapier elenca gli Zap più usati per Salesforce, HubSpot, Slack, Gmail e Airtable. Per i due percorsi CRM dall’inizio alla fine, con la mappatura dei campi e le regole sui duplicati che servono a ciascuno, vedi scansioni di biglietti da visita in HubSpot e scansioni di biglietti da visita in Salesforce.

Cosa ti dà un trigger

Ogni trigger passa a Zapier il record completo del contatto, quindi puoi mappare uno qualsiasi di questi campi in uno step successivo.

Cosa accettano le azioni

Create Contact e Update Contact prendono lo stesso insieme di campi. Compila solo quelli che vuoi impostare.

Regole di validazione

• I valori email devono essere indirizzi email validi.
• I link a siti, social e mappe devono iniziare con http:// o https://.
• La latitudine deve essere compresa tra -90 e 90. La longitudine tra -180 e 180.
• I campi vuoti vengono ignorati. Update Contact non cancella mai un valore lasciando il campo vuoto.
• Il contatto e il network che scegli devono appartenere all’account ConnectMachine collegato.

Quando uno Zap crea o aggiorna un contatto ConnectMachine, quella modifica attiva il trigger New Contact o Updated Contact come qualsiasi altra modifica. Se lo stesso Zap ascolta quei trigger, può richiamarsi da solo in un ciclo infinito.

Ogni record di trigger porta con sé un campo Source. Le modifiche fatte dai tuoi Zap arrivano con source zapier, così puoi filtrarle.

Ti serve solo sugli Zap che scrivono dentro ConnectMachine. Uno Zap che si limita a mandare i contatti verso un’altra app non può entrare in ciclo.

Quasi tutti i problemi dipendono dalla connessione, dal tuo piano o da un valore che non ha superato la validazione. Trova il sintomo qui sotto.

Questo riferimento documenta ogni endpoint dell’API ConnectMachine chiamato dall’integrazione nativa. Sono endpoint HTTPS di produzione: l’integrazione non chiama API di sandbox, test, stage o sviluppo.

https://api.connectmachine.ai

Autenticazione e scope

L’integrazione usa il flusso OAuth 2.0 authorization code con PKCE. Gli endpoint protetti richiedono Authorization: Bearer <access_token>. Zapier richiede gli scope user:read, contacts:read, contacts:write e webhooks:write.

{
  "access_token": "<access-token>",
  "refresh_token": "<refresh-token>",
  "token_type": "Bearer",
  "expires_in": 3600,
  "scope": "user:read contacts:read contacts:write webhooks:write"
}

Endpoint

JSON di mutazione contatto

Create Contact e Update Contact accettano JSON con i campi seguenti. I campi sconosciuti vengono ignorati. I valori vuoti non cancellano i dati esistenti.

Consegna dei trigger istantanei

ConnectMachine invia una POST HTTPS all’URL di destinazione della sottoscrizione. Gli eventi created e updated includono uno snapshot attuale del contatto. Gli eventi deleted includono contact_ids e, quando disponibili, gli snapshot precedenti all’eliminazione in contacts. Zapier trasforma ogni contatto in un elemento di trigger il cui Item ID combina gli ID dell’evento e del contatto.

{
  "event_id": "event_01",
  "occurred_at": "2026-08-04T12:00:00Z",
  "source": "app",
  "source_id": "contact_01",
  "data": {
    "event_type": "contacts.updated",
    "contacts": [{
      "id": "contact_01",
      "type": "person",
      "first_name": "John",
      "last_name": "Doe",
      "primary_email": "john.doe@example.com",
      "updated_at": "2026-08-04T12:00:00Z"
    }]
  }
}

Errori

Gli errori usano un body JSON coerente. Una risposta 429 include anche un header Retry-After.

{
  "error": "invalid_request",
  "error_description": "Invalid contact payload"
}