Integrazione CRM con interfacce aperte: strumenti e agenti sulla stessa scheda cliente

Un’integrazione CRM sposta dati o attivazioni tra il tuo CRM e un altro sistema, così nessuno copia una trattativa da una schermata all’altra. Customermates lo fa con quattro interfacce aperte invece che con un marketplace di app: un’API REST, webhook in uscita, un endpoint MCP per i client IA e un nodo della community per n8n. L’API REST e MCP sono disponibili in ogni piano. I webhook, e i trigger n8n che ne dipendono, sono inclusi in ogni piano a pagamento. Le installazioni self-hosted hanno tutte e quattro le interfacce.

Questa scelta ha un costo che è giusto conoscere subito. Non esiste un catalogo di app a un clic. Se vuoi che Customermates dialoghi con Slack, con il tuo programma di contabilità o con un costruttore di moduli, puoi puntare un webhook su quello strumento, chiamare l’API dal tuo codice o costruire il flusso in uno strumento di automazione come n8n, Make o Zapier.

Cosa significa per il follow up. Il follow up di una conversazione con un cliente spesso finisce in un altro sistema: un messaggio nella chat del team quando arriva una risposta, un record nel tuo strumento di progetto. Un webhook sugli eventi di messaggistica, un flusso n8n o il tuo client IA tramite MCP possono raccoglierlo, così il prossimo passo non dipende dal fatto che qualcuno lo copi altrove.

I cinque tipi di collegamento in sintesi

Webhook, REST e MCP sono inclusi in Starter a 12 € per utente al mese. La posta in arrivo unificata parte da Pro a 29 € per utente al mese e include 1 account collegato per utente; Business ne include 3 per utente più gli account condivisi. Le installazioni self-hosted hanno REST, webhook e MCP ma non la posta in arrivo, quindi gli eventi di messaggistica lì non scattano mai.

Quale strada per quale compito

Webhook

Crea un webhook in Impostazioni → Webhook → Aggiungi, incolla l’URL ricevente, scegli gli eventi e seleziona la lista sotto Record da. Puoi scegliere tra 16 eventi: 5 eventi sui record (creato, aggiornato, spostato nel Cestino, ripristinato ed eliminato definitivamente, per qualsiasi lista tu scelga, comprese le tue) e 11 eventi di messaggistica, come un messaggio o un’e-mail ricevuti e un evento di calendario modificato.

I dettagli che contano quando ci costruisci sopra:

• Firme. Imposta un segreto e ogni consegna porta una firma HMAC-SHA256 sul corpo della richiesta, così il ricevente può rifiutare le chiamate contraffatte.
• Nuovi tentativi. Timeout, errori di rete, risposte 5xx e 408, 425 e 429 vengono ritentati automaticamente, fino a 10 tentativi in totale. Le altre risposte 4xx no.
• Log delle consegne. Impostazioni → Log dei webhook mostra ogni consegna con codice di stato e payload, e da lì puoi reinviarne una.
• Intestazioni personalizzate e modelli del corpo. Le intestazioni ti permettono di autenticarti presso il ricevente. Un modello del corpo sostituisce la busta JSON standard con la forma che il ricevente si aspetta, usando segnaposto come {{event}} e {{data.record.ref.recordId}}.
• Solo le modifiche. Un evento record.updated elenca ogni campo modificato con il suo valore before e after, e una scrittura che non cambia nulla non invia alcun evento.

Le consegne non sono rigorosamente ordinate, quindi trattale come messaggi idempotenti con chiave l’id dell’evento e ordinale per timestamp del payload e versione del record. Il catalogo completo e le forme dei payload sono nella documentazione sui webhook.

API REST: integrazione del CRM dal tuo codice

L’API ha versione sotto /api/v1, si autentica con un’intestazione x-api-key ed è descritta da un documento OpenAPI. Gli stessi endpoint di azione servono ogni lista creata nel tuo spazio di lavoro e indirizzano un record con typeId e recordId: POST /api/v1/records/query e /records/search leggono, POST /api/v1/records/mutate crea, aggiorna, elimina, collega e scollega, e le sue azioni updateMany e deleteMany modificano fino a 100 record per richiesta. POST /api/v1/model/read restituisce i tuoi campi e gli ID delle loro opzioni, che ti servono perché la Fase della trattativa è un campo a scelta singola configurabile, non un valore fisso.

Una chiave API eredita i permessi dell’utente che l’ha creata. Non c’è un ambito per chiave, quindi crea le chiavi da un utente il cui ruolo sia adatto all’integrazione. Maggiori dettagli nella pagina della funzione API.

MCP per i client IA

MCP (Model Context Protocol) è uno standard aperto per collegare applicazioni di IA a sistemi esterni. Customermates gestisce un endpoint MCP in /api/v1/mcp con 59 strumenti. Claude e ChatGPT si collegano come connettore personalizzato con accesso OAuth, come descritto in collegare Claude e ChatGPT. Claude Code, Codex, Cursor e Gemini CLI si collegano con una chiave API.

Il client e il suo modello sono tuoi. Il tuo fornitore di IA fattura l’uso del proprio modello. Le ricerche semantiche cloud tramite MCP possono comunque contare nell’uso di Mate; le normali chiamate sui record del CRM non usano il modello del tuo client sul server di Customermates. Gli strumenti di messaggistica, calendario e social richiedono un piano Cloud con la posta in arrivo. Il riferimento MCP elenca ogni strumento.

Dentro Customermates Cloud c’è anche Mate, l’assistente ospitato, che usa crediti IA ospitati. Mate può creare e modificare webhook per te, e le sue routine possono eseguire un’istruzione salvata quando un record cambia. Questo copre il lavoro che richiede lettura e giudizio; le regole fisse vanno nei webhook e in n8n.

CRM con n8n, Make o Zapier

Nessuno di questi è incluso in Customermates. Li gestisci o li sottoscrivi a parte, e portano i grandi cataloghi di connettori. Customermates documenta gli schemi per n8n e pubblica un nodo della community; Make e Zapier funzionano tramite i loro passaggi generici di webhook e HTTP. Questa pagina la pubblica Customermates; la tabella qui sotto descrive il modello di fatturazione di ciascuno strumento dalla sua pagina dei prezzi, verificata l’8 ottobre 2026.

n8n è fair-code con la Sustainable Use License: n8n descrive il proprio codice come disponibile e installabile sul proprio server. È una licenza diversa dalla AGPL che copre il nucleo di Customermates.

Se ne paghi già uno, usalo. Se parti da zero e hai qualcuno in grado di gestire un container, n8n in self-hosting tiene sui tuoi server sia il CRM sia l’automazione. La guida alla configurazione di n8n mostra il trigger webhook, le chiamate HTTP Request e la credenziale x-api-key.

Slack: due strade, nessuna app nativa

Customermates non ha un’app Slack, né un canale Slack nella posta in arrivo, né una schermata di impostazioni di Slack. Slack si raggiunge con i webhook o con n8n.

Strada 1, solo webhook. I webhook in entrata di Slack accettano un POST JSON come {"text": "Hello"} e lo pubblicano in un canale. Un modello del corpo di Customermates produce esattamente questo.

Strada 2, n8n. Usa n8n quando il messaggio richiede della logica: avvisare solo quando la Fase della trattativa raggiunge un certo valore, pubblicare un riepilogo settimanale della pipeline da un POST /api/v1/records/query pianificato, o trasformare un collegamento rapido di Slack in un nuovo contatto tramite l’API. In entrambi i casi le conversazioni di Slack non compaiono mai nella posta in arrivo di Customermates.

Cosa non è incluso

Se il tuo team ha bisogno di centinaia di connettori già pronti e mantenuti dal fornitore, che una persona non tecnica attiva da una schermata di impostazioni, un CRM con un proprio marketplace di app fa meglio al caso tuo. Customermates si adatta ai team che collegano volentieri un webhook o lasciano che un client IA faccia le chiamate, e che vogliono le stesse interfacce sia che usino il cloud sia che installino sul proprio server. I collegamenti con un ERP seguono lo stesso schema; la guida all’integrazione tra CRM e ERP li illustra passo per passo.

Domande frequenti

Tieni la guida operativa e i fatti di origine accanto alla scheda cliente nella base di conoscenza IA.

Dati di terze parti verificati l’8 ottobre 2026 su prezzi di n8n, repository di n8n, prezzi di Make, prezzi di Zapier, webhook in entrata di Slack e introduzione a MCP.